AADCloudSyncTools PowerShell-modul för Azure AD Anslut molnsynkronisering

Modulen AADCloudSyncTools innehåller en uppsättning användbara verktyg som du kan använda för att hantera dina Azure AD Anslut Cloud Sync-distributioner.

Förutsättningar

Följande krav är uppfyllda:

  • Alla krav för den här modulen kan installeras automatiskt med hjälp av Install-AADCloudSyncToolsPrerequisites
  • Den här modulen använder MSAL-autentisering, så det krävs MSAL.PS modul installerad. Verifiera genom att köra i ett PowerShell-fönster. Get-module MSAL.PS -ListAvailable Om modulen är korrekt installerad får du ett svar. Du kan använda Install-AADCloudSyncToolsPrerequisites för att installera den senaste versionen av MSAL.PS
  • Även om AzureAD PowerShell-modulen inte är en förutsättning för någon funktion i den här modulen är det användbart att vara närvarande, så den installeras också automatiskt när du använder Install-AADCloudSyncToolsPrerequisites .
  • Installation av moduler från PowerShell-galleriet kräver TLS 1.2-tvingande. Cmdleten Install-AADCloudSyncToolsPrerequisites anger TLS 1.2-tvingande innan alla krav installeras. För att säkerställa att du kan installera moduler manuellt anger du följande i PowerShell-sessionen innan du använder Install-Module :
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 
    

Installera PowerShell-modulen AADCloudSyncTools

Använd följande steg för att installera och använda modulen AADCloudSyncTools:

  1. Öppna Windows PowerShell med administratörsbehörighet
  2. Skriv eller kopiera och klistra in följande: Import-module -Name "C:\Program Files\Microsoft Azure AD Connect Provisioning Agent\Utility\AADCloudSyncTools"
  3. Tryck på Retur.
  4. Kontrollera att modulen har importerats genom att ange eller kopiera och klistra in följande: Get-module AADCloudSyncTools
  5. Nu bör du se information om modulen.
  6. Därefter installerar du förutsättningarna för modulen AADCloudSyncTools genom att köra: Install-AADCloudSyncToolsPrerequisites
  7. Vid den första körningen installeras PoweShellGet-modulen om den inte finns. Om du vill läsa in den nya PowershellGet-modulen stänger du PowerShell-fönstret och öppnar en ny PowerShell-session med administratörsbehörighet.
  8. Importera modulen igen med steg 2.
  9. Kör Install-AADCloudSyncToolsPrerequisites för att installera MSAL- och AzureAD-modulerna
  10. Alla krav ska vara installerade Installera  modul
  11. Varje gång du vill använda modulen AADCloudSyncTools i den nya PowerShell-sessionen anger eller kopierar du och klistrar in följande:
Import-module "C:\Program Files\Microsoft Azure AD Connect Provisioning Agent\Utility\AADCloudSyncTools"

AADCloudSyncTools-cmdlets

Connect-AADCloudSyncTools

Använder modulen MSAL.PS för att begära en token för Azure AD-administratören för att få åtkomst till Microsoft Graph

Export-AADCloudSyncToolsLogs

Exporterar och paketerar alla felsökningsdata i en komprimerad fil enligt följande:

  1. Anger utförlig spårning och börjar samla in data från etableringsagenten (samma som Start-AADCloudSyncToolsVerboseLogs )
    Du hittar dessa spårningsloggar i mappen C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace
  2. Stoppar datainsamling efter 3 minuter och inaktiverar utförlig spårning (samma som Stop-AADCloudSyncToolsVerboseLogs )
    Du kan ange en annan varaktighet med -TracingDurationMins eller helt hoppa över utförlig spårning med -SkipVerboseTrace
  3. Samlar in Loggboken loggar för de senaste 24 timmarna
  4. Komprimerar alla agentloggar, utförliga loggar och loggbokens loggar till en komprimerad zip-fil under mappen Användardokument
    Du kan ange en annan utdatamapp med -OutputPath <folder path>

Get-AADCloudSyncToolsInfo

Visar information om Azure AD-klientorganisation och tillstånd för interna variabler

Get-AADCloudSyncToolsJob

Använder Graph för att hämta AD2AAD-tjänstens huvudnamn och returnerar information om synkroniseringsjobbet. Kan också anropas med hjälp av det specifika synkroniseringsjobbs-ID:t som en parameter.

Get-AADCloudSyncToolsJobSchedule

Använder Graph för att hämta AD2AAD-tjänstens huvudnamn och returnerar synkroniseringsjobbet schema. Kan också anropas med hjälp av det specifika synkroniseringsjobbs-ID:t som en parameter.

Get-AADCloudSyncToolsJobSchema

Använder Graph för att hämta AD2AAD-tjänstens huvudnamn och returnerar synkroniseringsjobbens schema.

Get-AADCloudSyncToolsJobScope

Använder Graph för att hämta synkroniseringsjobbens schema för det angivna synkroniseringsjobbs-ID:t och matar ut alla filtergruppens omfång.

Get-AADCloudSyncToolsJobSettings

Använder Graph för att hämta AD2AAD-tjänstens huvudnamn och returnerar synkroniseringsjobbens Inställningar. Kan också anropas med hjälp av det specifika synkroniseringsjobbs-ID:t som en parameter.

Get-AADCloudSyncToolsJobStatus

Använder Graph för att hämta AD2AAD-tjänstens huvudnamn och returnerar synkroniseringsjobbet status. Kan också anropas med hjälp av det specifika synkroniseringsjobbs-ID:t som en parameter.

Get-AADCloudSyncToolsServicePrincipal

Använder Graph för att hämta tjänstens huvudnamn för AD2AAD och/eller SyncFabric. Utan parametrar returnerar endast AD2AAD-tjänstens huvudnamn.

Install-AADCloudSyncToolsPrerequisites

Söker efter förekomsten av PowerShellGet v2.2.4.1 eller senare och Azure AD och MSAL.PS moduler och installerar dessa om de saknas.

Invoke-AADCloudSyncToolsGraphQuery

Anropar en webbbegäran för den URI, metod och brödtext som angetts som parametrar

Repair-AADCloudSyncToolsAccount

Använder Azure AD PowerShell för att ta bort det aktuella kontot (om det finns) och återställer autentiseringen för synkroniseringskontot med ett nytt synkroniseringskonto i Azure AD.

Restart-AADCloudSyncToolsJob

Startar om en fullständig synkronisering.

Resume-AADCloudSyncToolsJob

Fortsätter synkroniseringen från den tidigare vattenstämpeln.

Start-AADCloudSyncToolsVerboseLogs

Ändrar "AADConnectProvisioningAgent.exe.config" för att aktivera utförlig spårning och startar om tjänsten AADConnectProvisioningAgent Du kan använda -SkipServiceRestart för att förhindra omstart av tjänsten, men eventuella konfigurationsändringar börjar inte gälla. Spårningsloggarna finns i mappen C:\ProgramData\Microsoft\Azure AD Connect Agent\Trace.

Stop-AADCloudSyncToolsVerboseLogs

Ändrar "AADConnectProvisioningAgent.exe.config" för att inaktivera utförlig spårning och startar om tjänsten AADConnectProvisioningAgent. Du kan använda -SkipServiceRestart för att förhindra omstart av tjänsten, men eventuella konfigurationsändringar börjar inte gälla.

Suspend-AADCloudSyncToolsJob

Pausar synkroniseringen.

Nästa steg