使用 CLI 和 PowerShell 安裝 Azure AD Connect 佈建代理程式

本文說明如何使用 PowerShell Cmdlet 來安裝 Azure Active Directory (Azure AD) 連線佈建代理程式。

注意

本文說明如何使用命令列介面 (CLI) 來安裝佈建代理程式。 如需如何使用精靈安裝 Azure AD Connect 佈建代理程式的詳細資訊,請參閱安裝 Azure AD Connect 佈建代理程式

必要條件

在您使用 PowerShell Cmdlet 安裝 Azure AD Connect 佈建代理程式之前,Windows 伺服器必須先啟用 TLS 1.2。 若要啟用 TLS 1.2,請遵循 Azure AD Connect 雲端同步的必要條件中的步驟。

重要

下列安裝指示假設您已符合所有必要條件

使用 PowerShell cmdlets 安裝 Azure AD Connect 佈建代理程式

  1. 以企業系統管理員權限登入您將使用的伺服器。
  2. 登入 Azure 入口網站,然後移至 [Azure Active Directory]。
  3. 在左側功能表上,選取 [Azure AD Connect]。
  4. 選取 [管理雲端同步]。此螢幕擷取畫面顯示 [管理雲端同步]
  5. 按一下頂端的 [下載代理程式]。 此螢幕擷取畫面顯示下載代理程式
  6. 按一下右側的 [接受條款並下載]。
  7. 基於本指示的目的,將代理程式下載至 C:\temp 資料夾。
  8. 以無訊息模式安裝 ProvisioningAgent。
    $installerProcess = Start-Process 'c:\temp\AADConnectProvisioningAgentSetup.exe' /quiet -NoNewWindow -PassThru 
    $installerProcess.WaitForExit()
    
    
  9. 匯入佈建代理程式 PS 模組。
    Import-Module "C:\Program Files\Microsoft Azure AD Connect Provisioning Agent\Microsoft.CloudSync.PowerShell.dll" 
    
  10. 透過具有混合式身分識別角色的帳戶連線至 Azure AD。 您可以自訂此區段,從安全存放區擷取密碼。
    $hybridAdminPassword = ConvertTo-SecureString -String "Hybrid identity admin password" -AsPlainText -Force 
    
    $hybridAdminCreds = New-Object System.Management.Automation.PSCredential -ArgumentList ("HybridIDAdmin@contoso.onmicrosoft.com", $hybridAdminPassword) 
    
    Connect-AADCloudSyncAzureAD -Credential $hybridAdminCreds 
    
  11. 新增 gMSA 帳戶,並提供網域管理員的認證,以建立預設 gMSA 帳戶。
    $domainAdminPassword = ConvertTo-SecureString -String "Domain admin password" -AsPlainText -Force 
    
    $domainAdminCreds = New-Object System.Management.Automation.PSCredential -ArgumentList ("DomainName\DomainAdminAccountName", $domainAdminPassword) 
    
    Add-AADCloudSyncGMSA -Credential $domainAdminCreds 
    
  12. 或使用上述 Cmdlet 提供預先建立的 gMSA 帳戶。
    Add-AADCloudSyncGMSA -CustomGMSAName preCreatedGMSAName$ 
    
  13. 新增網域。
    $contosoDomainAdminPassword = ConvertTo-SecureString -String "Domain admin password" -AsPlainText -Force 
    
    $contosoDomainAdminCreds = New-Object System.Management.Automation.PSCredential -ArgumentList ("DomainName\DomainAdminAccountName", $contosoDomainAdminPassword) 
    
    Add-AADCloudSyncADDomain -DomainName contoso.com -Credential $contosoDomainAdminCreds 
    
  14. 或使用上述 Cmdlet 來設定慣用的網域控制站。
    $preferredDCs = @("PreferredDC1", "PreferredDC2", "PreferredDC3") 
    
    Add-AADCloudSyncADDomain -DomainName contoso.com -Credential $contosoDomainAdminCreds -PreferredDomainControllers $preferredDCs 
    
  15. 重複上一個步驟以加入更多網域。 提供個別網域的帳戶名稱和網域名稱。
  16. 重新啟動服務。
    Restart-Service -Name AADConnectProvisioningAgent  
    
  17. 前往 Azure 入口網站以建立雲端同步設定。

佈建代理程式 gMSA PowerShell Cmdlet

現在您已安裝代理程式,您可以對 gMSA 套用更細微的權限。 如需如何設定權限的詳細資訊和逐步指示,請參閱 Azure AD Connect 雲端佈建代理程式 gMSA PowerShell Cmdlet

安裝 US govt 雲端

根據預設,Azure Active Directory (Azure AD) Connect 佈建代理程式會針對預設的 Azure 雲端環境進行安裝。 如果您要安裝代理程式以在美國政府雲端中使用,請執行下列動作:

  • 在上述步驟 #8 中,將 ENVIRONMENTNAME=AzureUSGovernment 新增至命令列,如下列範例所示。
    $installerProcess = Start-Process -FilePath "c:\temp\AADConnectProvisioningAgent.Installer.exe" -ArgumentList "/quiet ENVIRONMENTNAME=AzureUSGovernment" -NoNewWindow -PassThru 
    $installerProcess.WaitForExit()
    

後續步驟