Intune-Kurs · Teil 53 von 90 · Block G: Scripting & Automatisierung
Was du in dieser Sektion lernst
- Den Unterschied zwischen altem Intune PowerShell SDK und Microsoft Graph PowerShell kennen
- Nur die nötigen Module installieren und passende Cmdlets mit Find-MgGraphCommand finden
- Geräte abfragen, Sync anstoßen und Richtlinien per Cmdlet anlegen
- Entscheiden, wann ein Cmdlet und wann der direkte API-Aufruf besser passt
ca. 10 Min. Lesezeit · Alle Sektionen im Überblick
In den Sektionen 50, 51 und 52 hast du Graph fast immer direkt angesprochen: URL zusammenbauen, Invoke-MgGraphRequest aufrufen, Seiten selbst nachladen. Das funktioniert immer, ist aber nicht der einzige Weg. Das SDK bringt für fast jeden Endpunkt ein fertiges Cmdlet mit.
In dieser Sektion schaust du dir an, was diese Cmdlets dir abnehmen, wo sie dich ausbremsen und wie du beide Wege im selben Skript kombinierst.
Erst klären: Welches „Intune PowerShell SDK“?
Wenn du nach „Intune PowerShell SDK“ suchst, landest du schnell bei zwei verschiedenen Dingen:
- Das alte Modul Microsoft.Graph.Intune mit
Connect-MSGraph. Es stammt aus dem Projekt Intune-PowerShell-SDK auf GitHub. Das letzte Release in der PowerShell Gallery ist Version 6.1907.1.0 vom Juli 2019. Viele ältere Blogartikel und Skripte nutzen es noch. - Microsoft Graph PowerShell mit
Connect-MgGraph. Laut Microsoft Learn werden die Cmdlets automatisch aus dem Graph-Schema erzeugt und regelmäßig aktualisiert. Das SDK ersetzt auch die Module AzureAD und MSOnline.
Für neue Skripte nimmst du Microsoft Graph PowerShell. Die Anmeldung mit Connect-MgGraph kennst du schon aus Sektion 50, sie gehört zum selben SDK. Triffst du in einem alten Skript auf Connect-MSGraph oder Cmdlets wie Get-IntuneManagedDevice, ist das ein Kandidat zum Umschreiben.
Installation: Nur das, was du brauchst
Laut Installationsanleitung gibt es zwei Hauptmodule: Microsoft.Graph für v1.0 und Microsoft.Graph.Beta für beta. Jedes zieht über 47 Untermodule nach. Für Intune brauchst du davon nur wenige, und Cmdlets gibt es nur für die Module, die installiert sind.
- PowerShell 7 empfiehlt Microsoft für das SDK. Windows PowerShell 5.1 funktioniert auch, braucht aber .NET Framework 4.7.2 und eine aktuelle PowerShellGet-Version.
- v1.0 zuerst: Microsoft rät, Skripte auf v1.0 aufzubauen. Das beta-Modul nimmst du nur, wenn es den Endpunkt in v1.0 nicht gibt, etwa beim Settings Catalog.
- Gemeinsam aktualisieren: Halte alle Graph-Module auf derselben Version und aktualisiere sie zusammen mit
Update-Module.
Praxis 1: Das passende Cmdlet finden
Die Namen folgen dem Graph-Pfad. Aus GET /deviceManagement/managedDevices wird Get-MgDeviceManagementManagedDevice, beta-Cmdlets bekommen ein Beta dazu. Raten musst du trotzdem nicht: Find-MgGraphCommand übersetzt in beide Richtungen und zeigt dir die passenden Berechtigungen.
- Mit -Uri gibst du einen Endpunkt an, den du aus der API-Dokumentation kennst, und bekommst das Cmdlet dazu.
- Mit -Command siehst du, welchen Endpunkt ein Cmdlet aufruft. Für
Sync-MgDeviceManagementManagedDeviceist dasPOST …/syncDevice. - Find-MgGraphPermission durchsucht laut Microsoft Learn die Berechtigungen nach einem Stichwort. Die Spalte
Consentzeigt, ob ein Administrator zustimmen muss. - Achtung bei Aktionen: Hinter
Set-MgDeviceManagementDeviceCompliancePolicysteckt nicht PATCH, sondern dieassign-Aktion. Bei Aktionen lohnt sich der Blick mit-Commandimmer.
Praxis 2: Direkter Aufruf und Cmdlet im Vergleich
Die Abfrage nach nicht konformen Geräten aus Sektion 51 sieht mit dem SDK deutlich kürzer aus. Beide Varianten liefern dieselben Geräte.
- -All lädt laut Cmdlet-Referenz alle Seiten nach. Deine eigene Schleife über
@odata.nextLinkfällt weg. - -Property entspricht
$select, -Filter entspricht$filter. Das URL-Encoding übernimmt das Cmdlet. - Typisierte Objekte: Die Eigenschaften heißen jetzt
DeviceNamestattdeviceName. Da PowerShell bei Eigenschaftsnamen nicht auf Groß- und Kleinschreibung achtet, funktionieren deine bisherigenWhere-Object- undSort-Object-Aufrufe trotzdem. - Nur was du anforderst: Felder, die du nicht in
-Propertyangibst, bleiben leer. Das ist kein Fehler, sondern dein$select.
Praxis 3: Geräteaktionen per Cmdlet
Aktionen wie Synchronisieren, Neustart oder Löschen laufen über eigene Endpunkte. Für syncDevice brauchst du laut Microsoft Learn die Berechtigung DeviceManagementManagedDevices.PrivilegedOperations.All. Das Lesen läuft weiter über Read.All.
- -WhatIf bringt Sync-MgDeviceManagementManagedDevice schon mit. Du musst also kein eigenes
SupportsShouldProcessbauen wie in Sektion 52. - Filter einfach halten: Das Skript filtert serverseitig nur nach
lastSyncDateTimeund sortiert das Betriebssystem lokal mitWhere-Objectaus. So vermeidest du Fehler durch Filterkombinationen, die der Endpunkt nicht unterstützt. - Ein Sync stößt nur den Check-in an. Ist das Gerät aus oder offline, passiert erst etwas, wenn es wieder online ist.
Praxis 4: Richtlinien mit dem SDK anlegen
Beim Anlegen merkst du, dass das SDK am Ende dieselben Daten schickt wie in Sektion 52. Der Unterschied: Du übergibst die Hashtable direkt an -BodyParameter, so wie im Beispiel von Microsoft Learn. ConvertTo-Json brauchst du nicht mehr.
- @odata.type und scheduledActionsForRule bleiben Pflicht. Das SDK prüft dafür nichts zusätzlich, Graph lehnt fehlerhafte Anfragen genauso ab.
- Set-MgDeviceManagementDeviceCompliancePolicy ruft laut Cmdlet-Referenz die assign-Aktion auf. Sie setzt die komplette Liste. Deshalb nutzt das Skript sie nur für eine frisch angelegte Richtlinie.
- Bestehende Zuweisungen ergänzt du mit
Add-RichtlinienZuweisungaus Sektion 52. Gemischte Skripte sind völlig normal, beide Wege nutzen dieselbe Anmeldung.
beta-Cmdlets für den Settings Catalog
Settings-Catalog-Richtlinien gibt es nur in beta, also brauchst du dafür das Modul Microsoft.Graph.Beta.DeviceManagement. Mit Get-MgBetaDeviceManagementConfigurationPolicy und Get-MgBetaDeviceManagementConfigurationPolicySetting bekommst du einen schnellen Überblick.
Wann Cmdlet, wann direkter Aufruf?
- Cmdlet: Für Abfragen mit Paging, für Aktionen mit
-WhatIfund überall, wo dir Tab-Vervollständigung und typisierte Objekte helfen. - Direkter Aufruf: Wenn du JSON aus einem Export 1:1 zurückschreibst, etwa Settings-Catalog-Vorlagen wie in Sektion 52, oder wenn ein Feld frisch in der API steht und das Cmdlet es noch nicht kennt.
- Fehlersuche: Wenn ein Cmdlet sich anders verhält als erwartet, vergleichst du mit dem direkten Aufruf. Invoke-MgGraphRequest gehört zum Authentifizierungsmodul und ist immer da.
Mit -Debug siehst du, welche HTTP-Anfrage ein Cmdlet tatsächlich schickt. Das ist der schnellste Weg, um Cmdlet und API-Dokumentation zusammenzubringen.
Troubleshooting: Typische Fehler
Cmdlet wird nicht erkannt
- Das passende Modul fehlt. Mit
Find-MgGraphCommand -Command <Name>siehst du in der SpalteModule, welches du installieren musst. - Bei
Get-MgBeta…-Cmdlets fehlt das beta-Modul. Das installierst du separat.
403 Forbidden oder Zugriff verweigert
- Prüfe mit
(Get-MgContext).Scopes, ob die Berechtigung ausFind-MgGraphCommandin deiner Sitzung steckt. - Für Geräteaktionen reicht
ReadWrite.Allnicht, dafür brauchst duPrivilegedOperations.All.
Eigenschaften sind leer
- Du hast sie nicht in
-Propertyangefordert. Ergänze sie oder lass den Parameter zum Testen weg.
Skript aus dem Internet nutzt Connect-MSGraph
- Das ist das alte Modul Microsoft.Graph.Intune. Übernimm die Logik, aber ersetze Anmeldung und Cmdlets durch Microsoft Graph PowerShell.
Find-MgGraphCommand -Urihilft dir, für jeden Endpunkt das neue Cmdlet zu finden.
Best Practices
- Nur die Graph-Module installieren, die du brauchst, und alle gemeinsam aktualisieren.
- Für Skripte zuerst v1.0-Cmdlets nehmen, beta nur dort, wo es keinen v1.0-Endpunkt gibt.
- Berechtigungen mit
Find-MgGraphCommandnachschlagen, statt pauschal breite Rechte zu vergeben. - Bei Abfragen immer
-Propertysetzen. Das macht Skripte schneller und Ausgaben übersichtlicher. - Aktionen zuerst mit
-WhatIflaufen lassen. - Wiederkehrende Teile in eigene Funktionen packen, wie im Artikel PowerShell Best Practices für Intune beschrieben.
Fazit
Das Graph PowerShell SDK ist keine Alternative zur API, sondern eine bequemere Schicht darüber. Für Abfragen und Aktionen sparst du dir Paging, URL-Encoding und eigene -WhatIf-Logik. Sobald du rohes JSON 1:1 schicken willst, ist der direkte Aufruf oft einfacher.
Zusammenfassend für deinen Workflow:
- Microsoft Graph PowerShell statt des alten Moduls Microsoft.Graph.Intune nutzen.
- Nur Microsoft.Graph.Authentication, Microsoft.Graph.DeviceManagement und bei Bedarf das beta-Modul installieren.
- Cmdlets und Berechtigungen mit Find-MgGraphCommand finden.
- Cmdlets und Invoke-MgGraphRequest im selben Skript kombinieren, je nachdem, was einfacher ist.
In der nächsten Sektion automatisierst du App-Zuweisungen per Graph API: Du weist Apps per Skript Gruppen zu, ohne bestehende Zuweisungen zu verlieren. Einen Überblick über alle Sektionen findest du auf der Seite Intune-Kurs.
Quellen
- Microsoft Learn: Übersicht über das Microsoft Graph PowerShell SDK
- Microsoft Learn: Microsoft Graph PowerShell SDK installieren
- Microsoft Learn: Find-MgGraphCommand verwenden
- Microsoft Learn: Find-MgGraphPermission verwenden
- Microsoft Learn: Get-MgDeviceManagementManagedDevice
- Microsoft Learn: Sync-MgDeviceManagementManagedDevice
- Microsoft Learn: syncDevice-Aktion (Graph API)
- Microsoft Learn: New-MgDeviceManagementDeviceCompliancePolicy
- Microsoft Learn: Set-MgDeviceManagementDeviceCompliancePolicy
- Microsoft Learn: Get-MgBetaDeviceManagementConfigurationPolicy
- Microsoft Learn: Get-MgBetaDeviceManagementConfigurationPolicySetting
- Microsoft Learn: Invoke-MgGraphRequest
- PowerShell Gallery: Microsoft.Graph.Intune 6.1907.1.0
- GitHub: microsoft/Intune-PowerShell-SDK