扩展架构

本文档介绍了如何在 Managed Service for Microsoft Active Directory 实例中扩展架构。

准备工作

在开始之前，请执行以下操作：

  1. 创建托管式 Microsoft AD 网域。
  2. 创建 Windows 虚拟机并将其加入网域。
  3. 请务必阅读架构扩展简介，并了解这些注意事项。
  4. 准备包含架构更改的 LDIF 文件。如需了解详情，请参阅如何准备 LDIF 文件。

  5. 确保您拥有以下任一 Identity and Access Management (IAM) 用户角色：

    • Google Cloud Managed Identities 网域管理员 (roles/managedidentities.domainAdmin)
    • Google Cloud Managed Identities Admin (roles/managedidentities.admin)

    如需了解详情，请参阅 Cloud Managed Identities 角色。

扩展架构

当您启动架构扩展时，Managed Microsoft AD 会自动创建架构扩展备份，然后再应用架构更改。如果您在架构扩展后遇到任何问题，可以使用此备份恢复域名。如需识别架构扩展程序备份，您可以列出为您的网域创建的备份。

如需扩展架构，请运行以下 gcloud CLI 命令：

gcloud active-directory domains extend-schema DOMAIN_NAME  --ldif-file=LDIF_FILE_PATH \
    --description=SCHEMA_EXTENSION_DESCRIPTION --project=DOMAIN_RESOURCE_PROJECT_ID --async

替换以下内容：

  • DOMAIN_NAME：您的 Managed Microsoft AD 网域的名称。例如 my-domain.example.com。
  • LDIF_FILE_PATH：架构发生更改的 LDIF 文件的路径。文件大小上限为 1 MB。
  • SCHEMA_EXTENSION_DESCRIPTION：架构更改的说明。
  • DOMAIN_RESOURCE_PROJECT_ID：网域资源项目的项目 ID。例如 my-project。

托管的 Microsoft AD 会发起架构扩展，并响应一个操作 ID，您可以使用该 ID 来跟踪架构扩展的完成情况。

如需检查架构扩展程序的状态，请运行以下 gcloud CLI 命令：

gcloud active-directory operations describe OPERATION_ID

将 OPERATION_ID 替换为架构扩展的操作 ID。例如 operation-1234567890-98765a1b2c3d4e5-e6f7g8-9h0i1j2。

验证架构扩展

扩展托管式 Microsoft AD 实例的架构后，请务必先验证架构更改，然后再将应用与 Active Directory 集成。您可以使用不同的工具和方法验证架构更改。在以下部分中，我们将介绍如何使用以下任一方法验证架构更改：

  1. Active Directory 架构单元
  2. Windows PowerShell

Active Directory 架构单元

如需使用 Active Directory 架构快捷方式验证架构更改，请执行以下操作：

  1. 以委派管理员的身份登录已加入网域的虚拟机。
  2. 安装 Active Directory 架构管理单元。
  3. 打开 Microsoft 管理控制台 (MMC)。
  4. 展开目录的 Active Directory 架构树。
  5. 验证您能否看到架构的类和属性的变化。

Windows PowerShell

要使用 Windows PowerShell 验证架构更改，请使用 Get-ADObject cmdlet。在 Windows PowerShell 中运行以下命令：

get-adobject -Identity 'cn=ATTRIBUTE,cn=Schema,cn=Configuration,dc=ROOT_DOMAIN,dc=TOP_LEVEL_DOMAIN' -Properties *

替换以下内容：

  • ATTRIBUTE：架构中属性的名称。例如 example-attribute。
  • ROOT_DOMAIN：您的域名的根域名。例如，如果您的域名是 example.com，请输入 example。
  • TOP_LEVEL_DOMAIN：域名的顶级域名。例如，如果您的域名是 example.com，请输入 com。

在响应中，验证您是否可以看到架构的类和属性的变化。

后续步骤