Sdílet prostřednictvím

Instalace agenta zřizování Microsoft Entra pomocí rozhraní příkazového řádku a PowerShellu

  • Článek

Tento článek vám ukáže, jak nainstalovat agenta pro zřizování Microsoft Entra pomocí cmdletů PowerShell.

Poznámka

Tento článek se zabývá instalací zřizovacího agenta pomocí rozhraní příkazového řádku (CLI). Informace o instalaci agenta zřizování Microsoft Entra pomocí průvodce naleznete v tématu Instalace agenta zřizování Microsoft Entra.

Předpoklad

Než nainstalujete agenta zřizování Microsoft Entra pomocí rutin PowerShellu, musí mít Server Windows povolený protokol TLS 1.2. Pokud chcete povolit protokol TLS 1.2, postupujte podle kroků v části Požadavky na Microsoft Entra Cloud Sync.

Důležitý

Následující pokyny k instalaci předpokládají, že byly splněny všechny požadavky .

Nainstalujte agenta zřizování Microsoft Entra pomocí PowerShell cmdletů

  1. Přihlaste se do centra pro správu Microsoft Entra alespoň jako hybridní správce.
  2. Přejděte na Identity>Hybridní správa>Microsoft Entra Connect>Cloud sync. Snímek obrazovky domovské stránky synchronizace cloudu.
  1. Vyberte Spravovat.
  2. Vyberte stáhněte si agenta pro zřizování
  3. Vpravo vyberte Přijmout podmínky a stáhněte.
  4. Pro účely těchto pokynů byl agent stažen do složky C:\temp.
  5. Nainstalujte ProvisioningAgent v tichém režimu. 
    $installerProcess = Start-Process 'c:\temp\AADConnectProvisioningAgentSetup.exe' /quiet -NoNewWindow -PassThru 
$installerProcess.WaitForExit()
  6. Importujte modul PS Provisioning Agenta. 
    Import-Module "C:\Program Files\Microsoft Azure AD Connect Provisioning Agent\Microsoft.CloudSync.PowerShell.dll"
  7. Připojte se k ID Microsoft Entra pomocí účtu s rolí hybridní identity. Tuto sekci můžete přizpůsobit pro načítání hesla ze zabezpečeného úložiště. 
    $hybridAdminPassword = ConvertTo-SecureString -String "Hybrid Identity Administrator password" -AsPlainText -Force 

$hybridAdminCreds = New-Object System.Management.Automation.PSCredential -ArgumentList ("HybridIDAdmin@contoso.onmicrosoft.com", $hybridAdminPassword) 

Connect-AADCloudSyncAzureAD -Credential $hybridAdminCreds
  8. Přidejte účet gMSA a zadejte přihlašovací údaje správce domény k vytvoření výchozího účtu 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
  9. Nebo použijte předchozí rutinu cmdlet k poskytnutí již vytvořeného účtu gMSA. 
    Add-AADCloudSyncGMSA -CustomGMSAName preCreatedGMSAName$
  10. Přidejte doménu. 
    $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
  11. Nebo pomocí předchozí rutiny nakonfigurujte upřednostňované řadiče domény. 
    $preferredDCs = @("PreferredDC1", "PreferredDC2", "PreferredDC3") 

Add-AADCloudSyncADDomain -DomainName contoso.com -Credential $contosoDomainAdminCreds -PreferredDomainControllers $preferredDCs
  12. Pokud chcete přidat další domény, opakujte předchozí krok. Zadejte názvy účtů a příslušné domény.
  13. Restartujte službu. 
    Restart-Service -Name AADConnectProvisioningAgent
  14. Pokud chcete vytvořit konfiguraci synchronizace cloudu, přejděte do Centra pro správu Microsoft Entra.

Rutiny PowerShellu pro zřizování agenta gMSA

Po instalaci agenta můžete pro gMSA použít podrobnější oprávnění. Informace a podrobné pokyny ke konfiguraci oprávnění najdete v tématu rutiny gMSA PowerShellu pro agenta zřizování cloudu Microsoft Entra Connect.

Instalace do vládního cloudu USA

Ve výchozím nastavení se agent zřizování Microsoft Entra nainstaluje do výchozího cloudového prostředí Azure. Pokud instalujete agenta pro použití v cloudu státní správy USA, postupujte takto:

  • V kroku 8 přidejte ENVIRONMENTNAME=AzureUSGovernment do příkazového řádku, jako je příklad. 
    $installerProcess = Start-Process -FilePath "c:\temp\AADConnectProvisioningAgent.Installer.exe" -ArgumentList "/quiet ENVIRONMENTNAME=AzureUSGovernment" -NoNewWindow -PassThru 
$installerProcess.WaitForExit()

Další kroky