本文說明如何在 Managed Service for Microsoft Active Directory 執行個體中擴充結構定義。
事前準備
開始之前,請先執行下列操作:
- 建立代管的 Microsoft AD 網域。
- 建立 Windows VM 並加入網域。
- 請務必詳閱「關於結構定義擴充功能」一文,並瞭解下列注意事項。
- 準備含有結構定義變更的 LDIF 檔案。詳情請參閱「如何準備 LDIF 檔案」。
請確認您具備下列任一 Identity and Access Management (IAM) 使用者角色:
- Google Cloud Managed Identities 網域管理員 (
roles/managedidentities.domainAdmin
) - Google Cloud Managed Identities 管理員 (
roles/managedidentities.admin
)
詳情請參閱「Cloud 管理式身分識別資訊角色」。
- Google 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:受管理的 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 整合。您可以使用不同的工具和方法驗證結構定義變更。在以下各節中,我們會說明如何使用下列任一方法驗證結構定義變更:
- Active Directory 結構定義集合方塊
- Windows PowerShell
Active Directory 結構定義集節點
如要使用 Active Directory 結構定義專用附加元件驗證結構定義變更,請執行下列步驟:
- 以委派管理員身分登入已加入網域的 VM。
- 安裝 Active Directory 結構定義小工具。
- 開啟 Microsoft Management Console (MMC)。
- 展開目錄的 Active Directory 結構定義樹狀結構。
- 確認是否可以看到結構定義的類別和屬性有所變更。
Windows PowerShell
如要使用 Windows PowerShell 驗證結構定義變更,請使用 Get-ADObject
指令碼。在 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
。
在回應中,確認是否可以看到結構定義的類別和屬性有變更。