Doku: vollständige Graph-Berechtigungen für den vollen Funktionsumfang
README: Berechtigungstabelle nach Bereich gruppiert (Kern, Geräte-Tab, Offboarding, Read-Only) inkl. der neuen Abhängigkeiten DeviceManagementServiceConfig.* (Autopilot-Status im Geräte-Detail, Autopilot-Suche im Offboarding). App-Registration.md entsprechend ergänzt. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -105,24 +105,63 @@ Settings → Verbindung
|
||||
Scopes RO: DeviceManagementApps.Read.All ...
|
||||
```
|
||||
|
||||
### Benoetigt Graph-Berechtigungen
|
||||
### Benoetigte Graph-Berechtigungen (voller Funktionsumfang)
|
||||
|
||||
| Funktion | Benoetigt |
|
||||
|----------------------------------|----------------------------------------------|
|
||||
| Apps anzeigen | `DeviceManagementApps.Read.All` |
|
||||
| Gruppen anzeigen / Mitglieder | `GroupMember.Read.All` |
|
||||
| User suchen | `User.Read.All` |
|
||||
| Zuweisungen aendern | `DeviceManagementApps.ReadWrite.All` |
|
||||
| Gruppen-Mitglieder aendern | `GroupMember.ReadWrite.All` |
|
||||
| App-Installationszaehler (Report)| `DeviceManagementManagedDevices.Read.All` ⚠ |
|
||||
| Geraete-Exportliste pro App | `DeviceManagementManagedDevices.Read.All` ⚠ |
|
||||
Alle Berechtigungen sind **delegiert** (Microsoft Graph) — die App handelt im Namen
|
||||
des angemeldeten Admins. Der **Kern** deckt App-Management, Group-Management und
|
||||
Policies ab; die **Geräte-** und **Offboarding**-Scopes sind optional und nur für
|
||||
den jeweiligen Tab nötig. `offline_access` liefert das Refresh-Token (Device-Code-Flow).
|
||||
|
||||
**Kern — immer erforderlich (App Management, Group Management, App Report, Policies)**
|
||||
|
||||
| Berechtigung | Wofür |
|
||||
|---|---|
|
||||
| `Group.ReadWrite.All` | Gruppen anlegen, App-/Policy-Zuweisungen setzen |
|
||||
| `GroupMember.ReadWrite.All` | Gruppenmitglieder lesen/hinzufügen/entfernen, CSV-Import |
|
||||
| `User.Read.All` | Benutzersuche, UPN-Auflösung |
|
||||
| `DeviceManagementApps.ReadWrite.All` | Apps auflisten, zuweisen, umbenennen, löschen, Setup-Datei aktualisieren |
|
||||
| `DeviceManagementConfiguration.ReadWrite.All` | Policies (Settings Catalog, Compliance, Konfigurationsprofile, Administrative Vorlagen) lesen, exportieren, importieren, **zuweisen (Bulk)**, konsolidieren, Git-Snapshot |
|
||||
| `DeviceManagementManagedDevices.Read.All` | App-Report (Installationszähler) und Geräte-Export pro App ⚠ |
|
||||
| `offline_access` | Refresh-Token |
|
||||
|
||||
> ⚠ Ohne `DeviceManagementManagedDevices.Read.All` zeigt der App-Report nur
|
||||
> Zaehler = 0 und der Geraete-Export liefert keine Eintraege.
|
||||
> Zähler = 0 und der Geräte-Export liefert keine Einträge. Dieser Scope ist
|
||||
> zugleich die Basis für den gesamten Geräte-Tab (siehe unten).
|
||||
|
||||
**Vollstaendige Berechtigungsliste, Redirect-URIs und ein Skript, das die
|
||||
App-Registrierung automatisch anlegt/konfiguriert:**
|
||||
[docs/App-Registration.md](docs/App-Registration.md) — inkl.
|
||||
**Geräte-Tab (optional)** — Geräte suchen, Detail-Panel, Aktionen
|
||||
|
||||
| Berechtigung | Wofür |
|
||||
|---|---|
|
||||
| `DeviceManagementManagedDevices.Read.All` | Geräte auflisten, Detail-Panel, Spalte „Verwaltung" (Intune/Co-Managed) |
|
||||
| `DeviceManagementServiceConfig.Read.All` | Autopilot-Status im Detail-Panel (Profil-Zuweisung / letzter Kontakt) |
|
||||
| `DeviceManagementManagedDevices.ReadWrite.All` | Sync, Neustart, Remote-Lock, Diagnose, BitLocker-Key-Rotation |
|
||||
| `DeviceManagementManagedDevices.PrivilegedOperations.All` | Wipe, Retire, Autopilot-Reset |
|
||||
|
||||
**Geräte-Offboarding (optional)** — Geräte aus Intune + Autopilot + Entra entfernen, Recovery-Keys lesen
|
||||
|
||||
| Berechtigung | Wofür |
|
||||
|---|---|
|
||||
| `DeviceManagementManagedDevices.Read.All` | Geräte-Suche (Intune) |
|
||||
| `DeviceManagementServiceConfig.ReadWrite.All` | Autopilot-Suche **und** Löschen aus Autopilot |
|
||||
| `DeviceManagementManagedDevices.ReadWrite.All` | Gerät aus Intune löschen |
|
||||
| `Device.ReadWrite.All` | Gerät aus Entra ID löschen/deaktivieren |
|
||||
| `BitlockerKey.Read.All` | BitLocker-Recovery-Keys lesen |
|
||||
| `DeviceLocalCredential.Read.All` | LAPS-Passwörter lesen |
|
||||
|
||||
> **Rollen:** Das Löschen aus Entra/Intune/Autopilot benötigt bei delegierter
|
||||
> Anmeldung zusätzlich passende **Verzeichnis-/Intune-Rollen** (z. B. *Cloud Device
|
||||
> Administrator* bzw. *Intune Administrator*) — die Scopes allein reichen nicht
|
||||
> (sonst `403`). Alle optionalen Scopes müssen außerdem in den **Read/Write-Scopes**
|
||||
> des Tools stehen (Einstellungen → Verbindung), damit sie im Token landen.
|
||||
|
||||
**Read-Only-Variante** (reine Anzeige-App als `clientIdRo`): die `*.Read.All`-Pendants —
|
||||
`Group.Read.All`, `GroupMember.Read.All`, `User.Read.All`,
|
||||
`DeviceManagementApps.Read.All`, `DeviceManagementConfiguration.Read.All`,
|
||||
`offline_access` (+ optional `DeviceManagementManagedDevices.Read.All` und
|
||||
`DeviceManagementServiceConfig.Read.All` für den Geräte-Tab).
|
||||
|
||||
**Redirect-URIs und ein Skript, das die App-Registrierung automatisch
|
||||
anlegt/konfiguriert:** [docs/App-Registration.md](docs/App-Registration.md) — inkl.
|
||||
[`Setup-AppRegistration.ps1`](docs/Setup-AppRegistration.ps1).
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user