PowerShell-Modul „AADCloudSyncTools“ für die Azure AD Connect-Cloudsynchronisierung

Artikel
05/05/2023

Das Modul „AADCloudSyncTools“ bietet nützliche Tools, mit denen Sie Ihre Bereitstellungen der Azure AD Connect-Cloudsynchronisierung (Azure Active Directory Connect) verwalten können.

Voraussetzungen

Mithilfe von Install-AADCloudSyncToolsPrerequisites können Sie automatisch alle erforderlichen Komponenten für das AADCloudSyncTools-Modul installieren. Sie führen diesen Schritt im nächsten Abschnitt dieses Artikels aus.

Im Anschluss finden Sie einige Details zu den erforderlichen Komponenten:

Das AADCloudSyncTools-Modul verwendet die MSAL-Authentifizierung (Microsoft Authentication Library, Microsoft-Authentifizierungsbibliothek), daher ist die Installation des Moduls „MSAL.PS“ erforderlich. Führen Sie zum Überprüfen der Installation in einem PowerShell-Fenster den Befehl Get-module MSAL.PS -ListAvailable aus. Ist das Modul ordnungsgemäß installiert, erhalten Sie eine Antwort. Sie können für die Installation der aktuellen Version von MSAL.PS bei Bedarf Install-AADCloudSyncToolsPrerequisites verwenden.
Das Azure AD PowerShell-Modul ist zwar für keine Funktionen des AADCloudSyncTools-Moduls erforderlich, ist aber dennoch nützlich. Daher wird es bei Verwendung von Install-AADCloudSyncToolsPrerequisites automatisch installiert.
Zum Installieren von Modulen aus dem PowerShell-Katalog muss Transport Layer Security (TLS) 1.2 erzwungen werden. Das Cmdlet Install-AADCloudSyncToolsPrerequisites legt die Erzwingung von TLS 1.2 fest, bevor alle erforderlichen Komponenten installiert werden. Um sicherzustellen, dass Sie Module manuell installieren können, legen Sie vor der Verwendung des Cmdlets Folgendes in der PowerShell-Sitzung fest:
```
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 
```
Das AADCloudSyncTools-Modul funktioniert unter Umständen nicht ordnungsgemäß, wenn der Agent für die Azure AD Connect-Cloudbereitstellung nicht ausgeführt wird oder der Konfigurations-Assistent nicht erfolgreich abgeschlossen wurde.

Installieren des PowerShell-Moduls AADCloudSyncTools

Öffnen Sie Windows PowerShell mit Administratorrechten.
Führen Sie Import-module -Name "C:\Program Files\Microsoft Azure AD Connect Provisioning Agent\Utility\AADCloudSyncTools" aus.
Führen Sie Get-module AADCloudSyncTools aus, um zu überprüfen, ob das Modul importiert wurde.

Jetzt sollten Informationen zum Modul angezeigt werden.
Führen Sie Install-AADCloudSyncToolsPrerequisites aus, um die erforderlichen Komponenten für das Modul „AADCloudSyncTools“ zu installieren.
Beim ersten Ausführen wird das PowerShellGet-Modul installiert, wenn es noch nicht vorhanden ist. Schließen Sie zum Laden des neuen PowerShellGet-Moduls das PowerShell-Fenster, und öffnen Sie eine neue PowerShell-Sitzung mit Administratorrechten.
Importieren Sie das Modul durch Ausführung von Import-module -Name "C:\Program Files\Microsoft Azure AD Connect Provisioning Agent\Utility\AADCloudSyncTools" erneut.
Führen Sie Install-AADCloudSyncToolsPrerequisites zum Installieren der MSAL- und Azure AD-Module erneut aus.

Alle erforderlichen Komponenten sollten jetzt installiert sein.
Führen Sie jedes Mal, wenn Sie das AADCloudSyncTools-Modul in einer neuen PowerShell-Sitzung verwenden möchten, den folgenden Befehl aus:
```
Import-module "C:\Program Files\Microsoft Azure AD Connect Provisioning Agent\Utility\AADCloudSyncTools"
```

AADCloudSyncTools-Cmdlets

Hinweis

Stellen Sie vor der Verwendung des AADCloudSyncTools-Moduls sicher, dass der Agent für die Azure AD Connect-Cloudbereitstellung ausgeführt wird und der Konfigurations-Assistent erfolgreich abgeschlossen wurde. Um Probleme mit dem Assistenten zu beheben, sehen Sie sich die Ablaufverfolgungsprotokolle im Ordner C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace an. Weitere Informationen finden Sie unter Problembehandlung bei der Cloudsynchronisierung.

Connect-AADCloudSyncTools

Dieses Cmdlet fordert mithilfe des MSAL.PS-Moduls ein Token für den Azure AD-Administrator für den Zugriff auf Microsoft Graph an.

Export-AADCloudSyncToolsLogs

Dieses Cmdlet exportiert alle Problembehandlungsdaten und packt sie in eine komprimierte Datei. Dies geschieht folgendermaßen:

Legt die ausführliche Ablaufverfolgung fest und startet die Erfassung von Daten aus dem Bereitstellungs-Agent (wie Start-AADCloudSyncToolsVerboseLogs).
Beendet die Datensammlung nach drei Minuten und deaktiviert die ausführliche Ablaufverfolgung (wie Stop-AADCloudSyncToolsVerboseLogs).
Sammelt Ereignisanzeigeprotokolle für die letzten 24 Stunden.
Komprimiert alle Agent-Protokolle, ausführlichen Protokolle und Ereignisanzeigeprotokolle in einer ZIP-Datei im Ordner Dokumente des Benutzers.

Mit den folgenden Optionen können Sie Ihre Datensammlung optimieren:

Verwenden Sie SkipVerboseTrace, um nur aktuelle Protokolle zu exportieren, ohne ausführliche Protokolle zu erfassen (Standard: false).
Verwenden Sie TracingDurationMins, um eine andere Erfassungsdauer anzugeben (Standard: 3 Minuten).
Verwenden Sie OutputPath, um einen anderen Ausgabepfad anzugeben (Standard: Ordner „Dokumente“ des Benutzers).

Get-AADCloudSyncToolsInfo

Dieses Cmdlet zeigt Details zum Azure AD-Mandanten und den Status interner Variablen an.

Get-AADCloudSyncToolsJob

Dieses Cmdlet verwendet Microsoft Graph zum Abrufen von Azure AD-Dienstprinzipalen und gibt die Informationen des Synchronisierungsauftrags zurück. Sie können es auch mit der jeweiligen Synchronisierungsauftrags-ID als Parameter aufrufen.

Get-AADCloudSyncToolsJobSchedule

Dieses Cmdlet verwendet Microsoft Graph zum Abrufen von Azure AD-Dienstprinzipalen und gibt den Zeitplan des Synchronisierungsauftrags zurück. Sie können es auch mit der jeweiligen Synchronisierungsauftrags-ID als Parameter aufrufen.

Get-AADCloudSyncToolsJobSchema

Dieses Cmdlet verwendet Microsoft Graph zum Abrufen von Azure AD-Dienstprinzipalen und gibt das Schema des Synchronisierungsauftrags zurück.

Get-AADCloudSyncToolsJobScope

Dieses Cmdlet verwendet Microsoft Graph, um das Schema des Synchronisierungsauftrags für die angegebene Synchronisierungsauftrags-ID abzurufen, und gibt alle Bereiche der Filtergruppen aus.

Get-AADCloudSyncToolsJobSettings

Dieses Cmdlet verwendet Microsoft Graph zum Abrufen von Azure AD-Dienstprinzipalen und gibt die Einstellungen des Synchronisierungsauftrags zurück. Sie können es auch mit der jeweiligen Synchronisierungsauftrags-ID als Parameter aufrufen.

Get-AADCloudSyncToolsJobStatus

Dieses Cmdlet verwendet Microsoft Graph zum Abrufen von Azure AD-Dienstprinzipalen und gibt den Status des Synchronisierungsauftrags zurück. Sie können es auch mit der jeweiligen Synchronisierungsauftrags-ID als Parameter aufrufen.

Get-AADCloudSyncToolsServicePrincipal

Dieses Cmdlet verwendet Microsoft Graph zum Abrufen der Dienstprinzipale für Azure AD und/oder Azure Service Fabric. Ohne Parameter werden nur Azure AD-Dienstprinzipale zurückgegeben.

Install-AADCloudSyncToolsPrerequisites

Dieses Cmdlet überprüft, ob PowerShellGet v2.2.4.1 oder höher, das Azure AD-Modul und das MSAL.PS-Modul vorhanden sind. Diese Elemente werden installiert, sollten sie fehlen.

Invoke-AADCloudSyncToolsGraphQuery

Dieses Cmdlet ruft eine Webanforderung für den URI, die Methode und den Text auf, die als Parameter angegeben sind.

Repair-AADCloudSyncToolsAccount

Dieses Cmdlet verwendet Azure AD PowerShell, um das aktuelle Konto (sofern vorhanden) zu löschen. Anschließend wird die Authentifizierung des Synchronisierungskontos mit einem neuen Synchronisierungskonto in Azure AD zurückgesetzt.

Restart-AADCloudSyncToolsJob

Diese Cmdlet startet eine vollständige Synchronisation.

Resume-AADCloudSyncToolsJob

Dieses Cmdlet setzt die Synchronisierung am letzten Wasserzeichen fort.

Start-AADCloudSyncToolsVerboseLogs

Dieses Cmdlet ändert AADConnectProvisioningAgent.exe.config, um die ausführliche Ablaufverfolgung zu aktivieren, und startet den Dienst „AADConnectProvisioningAgent“ neu. Sie können den Neustart des Diensts zwar mit -SkipServiceRestart verhindern, dann werden jedoch die Konfigurationsänderungen nicht übernommen. Diese Überwachungsprotokolle finden Sie im Ordner C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace.

Stop-AADCloudSyncToolsVerboseLogs

Dieses Cmdlet ändert AADConnectProvisioningAgent.exe.config, um die ausführliche Ablaufverfolgung zu deaktivieren, und startet den Dienst „AADConnectProvisioningAgent“ neu. Sie können den Neustart des Diensts zwar mit -SkipServiceRestart verhindern, dann werden jedoch die Konfigurationsänderungen nicht übernommen.

Suspend-AADCloudSyncToolsJob

Dieses Cmdlet hält die Synchronisierung an.