PowerShell For School Data Sync

  • Artikel

Wenn Sie mit School Data Sync (SDS) und Microsoft Entra ID arbeiten, ist das Ausführen von Aufgaben und Aktionen in PowerShell hilfreich. PowerShell ermöglicht die einfache Durchführung von Massen- und Skriptvorgängen. In diesem Artikel werden das Setup und die Voraussetzungen für die Verwendung von PowerShell mit Microsoft Entra ID und School Data Sync erläutert, sodass Administratoren PowerShell als Tool verwenden können, um ihre synchronisierten SDS-Daten besser zu verwalten.

Als Referenz finden Sie hier SDS PowerShell-Skripts.

Installieren des Microsoft Graph PowerShell SDK

Für die SDS-Objektverwaltung in PowerShell empfehlen wir die Installation von Microsoft Graph PowerShell. Befolgen Sie die folgenden Anweisungen, um die Voraussetzungen zu überprüfen und beide Module zu installieren:

Installieren Sie Microsoft Graph PowerShell.

Bestätigen der Installation und Importieren des Moduls

Vergewissern Sie sich nach der Installation, dass das Modul erfolgreich installiert wurde. Der Befehl dient auch zum Laden des Moduls in PowerShell. Wenn Sie das Modul in PowerShell laden, können Sie die Cmdlets ausführen, die dem Modul zugeordnet sind.

Führen Sie die folgenden Schritte aus, um zu bestätigen, dass das Modul installiert und in PowerShell importiert wurde:

  1. Starten Sie PowerShell.

  2. Führen Sie diesen Befehl aus, um sicherzustellen, dass das Modul erfolgreich geladen und installiert wurde.

    Get-InstalledModule Microsoft.Graph

    Hinweis

    Der Befehl gibt die installierte Version, den Namen und die Beschreibung des Microsoft Graph-Moduls zurück, sofern es auf Ihrem System installiert ist.

  3. Führen Sie den folgenden Befehl aus, um das Microsoft Graph-Modul zu importieren:

    Import-Module Microsoft.Graph

Herstellen einer Verbindung mit Microsoft Entra ID mithilfe von PowerShell

Nachdem die Module importiert wurden, müssen Sie PowerShell mit Microsoft Entra ID verbinden, um die befehle auszuführen, die den einzelnen Modulen für Ihr Microsoft Entra Verzeichnis zugeordnet sind.

Hinweis

Sie verwenden delegierten Zugriff, um sich als Benutzer anzumelden. Sie müssen sich nur einmal pro Sitzung anmelden.

  1. Verbinden Sie das Microsoft Graph-Modul mit Microsoft Entra ID.

    Connect-MgGraph -Scopes 
"User.Read.All","Group.ReadWrite.All"

  2. Der Befehl fordert Sie auf, zu einer Webseite für die Authentifizierung zu navigieren.

  3. Wählen Sie die Schaltfläche Weiter oder Anmelden aus, um fortzufahren. Sie werden im Namen Ihrer organization zum Herstellen einer Verbindung mit Microsoft Graph PowerShell um Berechtigungen und Zustimmung gebeten.

  4. Aktivieren Sie das Kontrollkästchen "Zustimmung im Namen Ihrer organization", und wählen Sie die Schaltfläche Akzeptieren aus.

  5. Wenn die Überprüfung erfolgreich war, zeigt das PowerShell-Terminal "Willkommen bei Microsoft Graph!" an.