Was ist neu in Microsoft Graph PowerShell v2?

Was waren die Nachteile von Microsoft Graph PowerShell SDK v1?

Microsoft Graph PowerShell SDK v1 verwendete einen V1.0-Endpunkt für die Produktion und einen Beta-Endpunkt zum Testen von Funktionen, die noch nicht allgemein verfügbar waren. Um einen der beiden Endpunkte zu verwenden, würden Sie den folgenden PowerShell-Befehlen:

Select-MgProfile -Name "V1.0"
Select-MgProfile -Name "Beta"

Bei diesem Ansatz kann es zu Problemen kommen, wenn Sie die falsche Endpunktversion verwenden und mit Ihrem PowerShell-Code nicht die erwarteten Ergebnisse erzielen. Außerdem kann es vorkommen, dass für ein und dasselbe Skript beide Endpunkte verwendet werden müssen, was für die Ausführung bestimmter Aufgaben oft erforderlich ist. Dazu müssen Sie die Profile häufig austauschen, was nicht der effizienteste Ansatz ist.

Select-MgProfile -Name "V1.0"
$users = Get-MgUser

Select-MgProfile -Name "Beta"
$alerts = Get-MgSecurityAlert

Im Beispielcode wird jeder Befehl, der nach dem Abrufen der Sicherheitswarnungen ausgeführt wird, mit dem Beta-Endpunkt ausgeführt, es sei denn, Sie setzen auf den v1-Endpunkt zurück.

Was sind die Vorteile von Microsoft Graph PowerShell SDK v2?

Nach einer kurzen öffentlichen Vorschauphase hat Microsoft das Microsoft Graph PowerShell SDK v2 im Juli 2023 zur allgemeinen Verfügbarkeit freigegeben, um einige Nachteile des SDK v1 zu beheben. Außerdem bietet Microsoft Graph PowerShell SDK v2 Versionierung und verschiedene andere Verbesserungen.

Aktualisieren Sie die PowerShell-Module Microsoft.Graph und Microsoft.Graph.Beta, um mit dieser neuen SDK-Version arbeiten zu können. Sie passen den Beispielcode an und verwenden Namensanpassungen für die cmdlets basierend auf dem benötigten Modul.

$users = Get-MgUser
$alerts = Get-MgBetaSecurityAlert

Solange beide Module installiert sind, können Sie neuere Funktionen nutzen, ohne zum Beta-Profil zu wechseln.

Install-Module Microsoft.Graph
Install-Module Microsoft.Graph.Beta
Import-Module Microsoft.Graph
Import-Module Microsoft.Graph.Beta

Die Installationsgröße des Microsoft Graph PowerShell SDK v2 beträgt circa 635 MByte im Vergleich zu den 969 MByte des Microsoft Graph PowerShell SDK v1. Dieser Größenunterschied trägt zur Beschleunigung des Modulimports in die Konsole bei und verbessert die Automatisierungsbemühungen, insbesondere innerhalb von Azure.

Microsoft Graph PowerShell SDK v2 bietet eine neue Authentifizierungsmethode, die die Sicherheit erhöht und gleichzeitig die Komplexität reduziert. Microsoft Graph PowerShell SDK v2 unterstützt verwaltete Identität für die Authentifizierung über den Befehl Connect-MgGrpah. Mit verwalteter Identität kann das v2-Modul auf Token für Azure-Ressourcen zugreifen, die von Microsoft Entra ID geschützt werden. Die Azure-Plattform verwaltet die Identität und erfordert keine Bereitstellung oder Rotation von Geheimnissen. Sie können vom System zugewiesene verwaltete Identitäten und vom Benutzer zugewiesene verwaltete Identitäten verwenden.

Connect-MgGraph -Identity
Connect-MgGraph -Identity -ClientId "c853667c-e346-4f40-b07b-49edbf8eb8d5."

Microsoft Graph PowerShell SDK v2 unterstützt auch Client Secrets durch Hinzufügen des Parameters -ClientSecretCredential zum Cmdlet Connect-MgGraph, um Arbeiten am Tenant ohne Anmeldung durchzuführen.

# Client Secret Connection
$secret = Get-Credential `
-Username "c853667c-e346-4f40-b07b-49edbf8eb8d5"
Connect-MgGraph `
     -TenantId "320a9610-d27d-4772-875c-03934f561c76" `
     -ClientSecretCredential $secret

Außerdem führt Microsoft Graph PowerShell SDK v2 eine weitere neue Authentifizierungsmethode mit Zertifikatsanmeldeinformationen sowohl für den aktuellen Benutzer als auch für den lokalen Computer ein.

# Certificate Connection
Connect-MgGraph `
     -ClientId "c853667c-e346-4f40-b07b-49edbf8eb8d5" `
     -Tenant "320a9610-d27d-4772-875c-03934f561c76" `
     -CertificateThumbprint "a909502dd82ae41433e6f83886b00d4288a32a7c"

Sie können auch Umgebungsvariablen als Speicher für Authentifizierungseigenschaften verwenden. Das Speichern von Parameterschlüsseln und -werten in Umgebungsvariablen verhindert, dass sensible Informationen bei der gemeinsamen Nutzung von Skripten verloren gehen.

Der aktualisierte Befehl Connect-MgGraph unterstützt die auf Umgebungsvariablen basierenden Authentifizierung mit dem Flag EnvironmentVariable.

# Add environment variables
$Env:CLIENT_ID = "c853667c-e346-4f40-b07b-49edbf8eb8d5"
$Env:TENANT_ID = "320a9610-d27d-4772-875c-03934f561c76"
$Env:CLIENT_SECRET = "~w28Q~lkHcX9GyStTAZP-Ymaz95c7nOl1_-oUa4Z"

# Connect using environment variables
Connect-MgGraph –EnvironmentVariable

Zu beachtende Änderungen in Microsoft Graph PowerShell v2

Wenn Code geändert oder aktualisiert wird, funktionieren häufig Funktionen oder Komponenten nicht mehr oder werden an neue Stellen verschoben. Beim Microsoft PowerShell Graph SDK v2 ist das nicht anders.

Die Beta-Entitätstypen befinden sich jetzt im Namespace Microsoft.Graph.Beta.PowerShell.Modules. <Entity>, um sie von den Standardtypen zu unterscheiden.

Microsoft hat auch die Eigenschaft AccessToken geändert, die Sie mit dem Befehl Connect-MgGraph verwenden. Es handelt sich um einen SecureString- und nicht um einen String-Datentyp, als Teil der allgemeinen Arbeit zur Härtung der PowerShell-Module gegen Sicherheitsschwachstellen. Die Bibliothek unterstützt nicht mehr die Eigenschaft Force Refresh mit dem Connect-MgGraph-Befehl. Stattdessen müssen Sie sich mit dem Disconnect-MgGraph-Befehl abmelden und erneut verbinden.

So aktualisieren Sie auf Microsoft Graph PowerShell v2

Um mit Microsoft Graph PowerShell SDK v2 zu beginnen, müssen Sie die aktualisierten PowerShell-Module Microsoft.Graph und Microsoft.Graph.Beta installieren.

# Install Microsoft.Graph and allow the prerelease version to install
Install-Module Microsoft.Graph -AllowPrerelease -AllowClobber -Force

# Install Microsoft.Graph.Beta and allow the prerelease version to install
Install-Module Microsoft.Graph.Beta -AllowPrerelease -AllowClobber -Force

Um die aktuelle Version zu ersetzen, entfernen Sie die Eigenschaft AllowClobber. Um die beiden Versionen nebeneinander laufen zu lassen, behalten Sie die Eigenschaft AllowClobber bei.

Nach der Installation laden Sie das Modul, das Sie verwenden möchten, mit dem Befehl Import-Module.

Import-Module Microsoft.Graph
Import-Module Microsoft.Graph.Beta

Um die geladenen Module zu überprüfen, führen Sie Folgendes aus:

Get-Module -Name Microsoft.Graph*

Sobald sie geladen sind, können Sie die Module v1 und beta verwenden und die Befehle v1 und beta in einem Skript ausführen, ohne den Befehl Select-MgProfile verwenden zu müssen.

Get-MgUser
Get-MgBetaUser

Microsoft Graph PowerShell SDK v2-Änderungen erleichtern die Verwaltungsarbeit

Microsoft Graph PowerShell SDK vereinfacht die Verwaltung von Mandanten durch die Automatisierung täglicher Aufgaben. Das SDK verwaltet komplexe Funktionen wie Drosselung, Wiederholungen, Umleitungen und Authentifizierung.

Die Veröffentlichung von Microsoft Graph PowerShell SDK v2 bringt eine verbesserte Erfahrung. Die Module v1 und beta verwenden unterschiedliche Präfixe in ihren Cmdlets. Das hilft Ihnen, robustere und weniger fehleranfällige Skripte zu schreiben. Die Präfixe in den Cmdlets helfen bei der Identifizierung, wo sich die Vorschaufunktionalität befindet, und machen es weniger zweideutig, die Verwendung von Produktions- und Vorschauendpunkten in einem Skript zu kombinieren.