Microsoft365DSC sichert die Konfiguration eines Microsoft-365-Tenants, aber keine Inhalte. Der Artikel berichtet von einer echten Sicherung eines Demo-Tenants vor Ablauf der Testlizenz. Er zeigt, wie SharePoint- und OneDrive-Dateien samt Versionen, Postfächer, Teams, Conditional Access, Rollen, Intune, SharePoint-Tenant-Einstellungen und Exchange, Security & Compliance und Teams-Einstellungen per Microsoft Graph und Admin-Schnittstellen gelesen wurden, welche App-Rechte dafür nötig waren und was mit 403 oder 400 scheiterte. Dazu kommt ein Weg für Secrets: ein Inventar ohne Werte und ein Restore-Skript, das beim Einspielen neue Kennwörter, Secrets und Zertifikate erzeugt. Der Artikel nennt offen, was fehlt (etwa der Termspeicher und acht Exchange-Abfragen) und was noch ungetestet ist.
Inhalt 17 Abschnitte
- Auf einen Blick
- Ausgangslage: Konfiguration ist nicht Inhalt
- SharePoint und OneDrive: Dateien samt Versionen
- Postfächer: Mails, Anhänge, Termine, Kontakte
- Teams: Kanäle, Nachrichten, Chats
- Conditional Access, Rollen und Intune per Graph
- SharePoint-Tenant-Einstellungen: Admin-REST mit Zertifikat
- Exchange: Admin-REST mit Exchange.ManageAsApp
- Security & Compliance: derselbe Zugang, anderer Weg
- Welche App-Rechte nötig waren
- Secrets: Was kein Backup enthalten kann
- Übersicht: Was ist drin, womit geholt, was fehlt
- Grenzen, die du kennen solltest
- Einordnung: Was das für Admins und IT-Dienstleister heisst
- Fazit
- Die Skripte
- Änderungshistorie

Die Testlizenz läuft am 17. November ab, und im Tenant liegen Mails, Dateien und Teams-Chats. Microsoft365DSC rettet davon nichts. Dieser Bericht zeigt, wie eine echte Sicherung eines Demo-Tenants trotzdem gelang, und wo sie Lücken behielt.
Auf einen Blick
- Microsoft365DSC sichert Einstellungen, keine Inhalte. Im Test lieferten 46 Ressourcen für Entra ID, SharePoint, OneDrive, Power Platform und Planner Daten, 46 scheiterten an fehlenden Rechten.
- Dateien und Versionen holt Microsoft Graph. 53 Sites, 1994 Dateien mit 993 MB und 9919 ältere Dateiversionen (1,26 GB) sind gesichert, dazu 22'525 Versionen von Listeneinträgen. Vom Papierkorb gibt es nur die Metadaten.
- Postfächer, Teams und Chats lesen ebenfalls per Graph. 10 Postfächer mit 5692 Nachrichten, 13 Teams mit 200 Kanalnachrichten und 9 Chats gingen in die Sicherung.
- Exchange, Security & Compliance und Teams-Einstellungen lesen per PowerShell mit Zertifikat. Exchange lieferte 1169 Objekte, Security & Compliance 551, die Teams-Einstellungen 624. Der Termspeicher von SharePoint blieb mit 403 offen.
- Secrets kann kein Backup enthalten. Du sicherst ein Inventar ohne Werte und setzt Kennwörter, Secrets und Zertifikate beim Einspielen neu.
- Der Einspielmodus ist noch nicht gegen einen Ziel-Tenant getestet. Der Trockenlauf und der Selbsttest laufen, ein echter Restore steht aus.
Ausgangslage: Konfiguration ist nicht Inhalt
Teil 1 zeigt, wie du einen Tenant als Code exportierst und in einem Test-Tenant einspielst. Dort steht auch die Grenze: Das Modul beschreibt Einstellungen und Richtlinien. Postfächer, Dateien und Chats gehören nicht dazu.
Diese Grenze zeigte sich im Demo-Tenant Contoso sofort. Ein Export der Workloads Entra ID, SharePoint, OneDrive, Power Platform und Planner lief mit dem Standardmodus durch. 46 Ressourcen lieferten Daten, 46 schlugen fehl. Im Protokoll stehen vor allem Forbidden, Unauthorized und Access denied, dazu einige Lizenzmeldungen. Die App hatte schlicht zu wenig Rechte. Ein reiner Entra-Export mit App-Secret brachte immerhin 431 Instanzen von Benutzern, Gruppen, Apps, Rollen und Richtlinien.
Das Abo lief am 17. November 2026 aus. Zeit blieb also für einen Tag Arbeit, nicht für ein Projekt. Deshalb las ein Satz Skripte alles aus, was sich per Graph, SharePoint-REST und Exchange-Admin-REST lesen liess. Der Zugriff war überall nur lesend.
SharePoint und OneDrive: Dateien samt Versionen
SharePoint-Sites und OneDrive-Laufwerke sind für Microsoft Graph gleich aufgebaut: ein Laufwerk (Drive) mit Elementen. Die Sicherung ging in drei Schichten vor.
- Struktur: 53 Sites mit Listen, Spalten, Inhaltstypen, Seiten und Berechtigungen, als JSON.
- Dateien: 1994 Dateien mit 993 MB, geladen per Graph. Die Liste der Laufwerke kennt 2155 Einträge, die übrigen sind Ordner.
- Versionen: Zu jeder Datei liest die Versionsliste die älteren Stände. Das Skript lädt höchstens die zehn neuesten alten Versionen je Datei. Das Manifest zählt 9919 Zeilen, jede mit Grösse und SHA-256-Summe (1,26 GB). Insgesamt gibt es 23'705 Versionseinträge bei 1192 Dateien mit älteren Ständen. Die übrigen 11'792 älteren Versionen liegen nur als Metadaten vor, nicht als Inhalt.
- Listeneinträge und Seiten: Auch Listeneinträge haben Versionen. Gesichert sind 2232 Einträge mit 22'525 Versionen aus 168 Listen, höchstens 1000 Einträge je Liste. Vom Layout der Seiten (Web Parts) liegen 355 von 359 Seiten vor. Die vier übrigen sind keine modernen Seiten, Graph antwortete mit 400.
- Termspeicher: Die verwalteten Metadaten fehlen. Graph antwortete für alle 53 Sites mit 403, denn das Recht
TermStore.Read.Allwar nicht vergeben.
Der Papierkorb ist ein Sonderfall. Graph listet seine Einträge mit Name, Löschdatum und Grösse, den Inhalt liefert die Liste nicht. Gesichert sind deshalb 69 Metadaten-Einträge. Den Inhalt müsstest du erst wiederherstellen, und das wollte hier niemand.
Postfächer: Mails, Anhänge, Termine, Kontakte
Für Postfächer reicht ein App-Recht mit Leserechten. Die Nachrichtenliste kennt die Anwendungsberechtigung Mail.Read. Die Sicherung speichert jede Nachricht als JSON, Anhänge als Datei, dazu Termine und Kontakte.
| Inhalt | Anzahl | Bemerkung |
|---|---|---|
Postfächer |
10 |
Weitere Konten haben kein Postfach und antworteten mit 404 |
Nachrichten |
5692 |
Aus allen Ordnern, 51 MB mit Anhängen, Terminen und Kontakten |
Anhänge |
22 |
Als Datei neben der Nachricht |
Termine und Kontakte |
30 und 1 |
Mit Calendars.Read und Contacts.Read |
Eine Auffälligkeit blieb ungeklärt. Jeder Ordner meldet über totalItemCount, wie viele Elemente er enthält. Alle Ordner stimmen mit der Zahl der gelesenen Nachrichten überein, ausser «Gelöschte Elemente». Dort meldet das Feld insgesamt 145 Elemente mehr, als die Nachrichten-API liefert (5837 gemeldet, 5692 gelesen). Der Fehler zeigt sich in der Version 1.0 genauso wie in der Beta-Version und bleibt auch mit einem Filter auf den Ordner. Die Ursache ist nicht belegt. Denkbar sind Elemente, die keine Mails sind, oder eine Eigenheit von Graph. Prüfe deshalb bei einer eigenen Sicherung für jeden Ordner die Summe und vergleiche sie mit totalItemCount.
Teams: Kanäle, Nachrichten, Chats
Mit App-Rechten braucht das Lesen von Kanalnachrichten ChannelMessage.Read.All, von Chats Chat.Read.All. Teams und Kanäle selbst listet Team.ReadBasic.All.
| Inhalt | Anzahl | Bemerkung |
|---|---|---|
Teams |
13 |
Mit Team.ReadBasic.All aufgelistet |
Kanäle |
24 |
Je Team über die Kanalliste |
Kanalnachrichten |
200 |
Mit ChannelMessage.Read.All |
Antworten darauf |
95 |
Hängen an den Kanalnachrichten |
Chats |
9 mit 50 Nachrichten |
Mit Chat.Read.All |
Dateien aus Teams |
142 |
Liegen in SharePoint, siehe oben |
Nicht gelungen sind die 36 Mitgliederlisten von Teams und Kanälen. Sie antworteten mit 403. Die Mitgliederliste eines Teams verlangt TeamMember.Read.All, die Kanalmitglieder verlangen ChannelMember.Read.All. Beide Rechte hatte die App nicht. Wer Mitglieder braucht, trägt sie vorab ein oder liest sie aus den Gruppen.
Die Einstellungen von Teams (Richtlinien und Konfigurationen) kommen nicht aus Graph, sondern aus Teams PowerShell. Connect-MicrosoftTeams meldete sich ohne Benutzer, nur mit App und Zertifikat an. Das ergab 624 Objekte in 105 Dateien. 22 Cmdlets verlangen einen Pflichtparameter wie eine Identität oder eine Bestellnummer und wurden übersprungen. Weitere Abfragen scheiterten, weil Microsoft das Cmdlet abgekündigt hat oder der App die Berechtigung fehlt. Die Benutzerliste (Get-CsOnlineUser) fehlt bewusst, Graph deckt sie ab.
Conditional Access, Rollen und Intune per Graph
Konfiguration lässt sich auch ohne Microsoft365DSC lesen, mit nur lesenden Rechten. Der Lauf brachte:
- Conditional Access: 8 Richtlinien und 8 benannte Standorte, mit
Policy.Read.All. - Rollen und PIM: 148 Rollendefinitionen, 81 Rollenzuweisungen und 158 berechtigte Zuweisungen (Eligibility) aus dem Privileged Identity Management, mit
RoleManagement.Read.All. - Intune: 83 Datensätze mit 1717 Objekten, etwa Konfigurations- und Compliance-Profile, App-Schutzrichtlinien und Apps, mit
DeviceManagementConfiguration.Read.AllundDeviceManagementApps.Read.All.
Ehrlich gehört dazu, was nicht kam. 19 Abfragen blieben ohne Ergebnis:
| Antwort | Anzahl | Beispiele und Grund |
|---|---|---|
403, Recht fehlt |
9 |
Geräte ( managedDevices), Gerätekategorien, Bedingungen, Registrierungskonfigurationen, Skripte, Intune-Rollen, Registrierungsbericht (AuditLog.Read.All), Identitätsanbieter (IdentityProvider.Read.All) |
400, Pfad unbekannt |
8 |
Autopilot-Profile, Geräteskripte, Verzeichniseinstellungs-Vorlagen und einige Richtlinien, die es im Tenant oder in der Version 1.0 nicht gibt |
401 |
1 |
Eine Beta-Abfrage, die keine reinen App-Aufrufe unterstützt |
200, leer |
1 |
Eine Schutzrichtlinie ohne Inhalt |
Die 400er sagen nicht, dass Daten fehlen. Sie sagen, dass die Adresse im Tenant nicht existiert. Bei den 403ern hilft ein zusätzliches Recht. Teste jede Abfrage einmal mit der Probe der Schnittstelle, bevor du ihr traust.
SharePoint-Tenant-Einstellungen: Admin-REST mit Zertifikat
Einstellungen des SharePoint-Tenants liefert Graph nur zum Teil. Der Zugriff auf die REST-Schnittstelle der Verwaltung läuft mit einer Entra-App, und laut Microsoft braucht diese ein Zertifikat. Ein App-Secret genügt dort nicht. Das ist auch der Grund, warum der Export mit dem Secret in Microsoft365DSC an dieser Stelle scheiterte.
Mit Zertifikat und dem Recht Sites.FullControl.All lieferten 16 Abfragen Daten, etwa Tenant-Einstellungen, Hub-Sites, Websites und Berechtigungen. Fünf Abfragen blieben offen: die Liste aller Websites per GET (405), der App-Katalog, die Designs, die Speicherquote (je 404) und die Graph-Verwaltungseinstellungen (403). Nur lesende GET-Aufrufe waren erlaubt, eine Änderung wurde nie versucht.
Exchange: Admin-REST mit Exchange.ManageAsApp
Exchange-Einstellungen lassen sich ebenfalls nur über eine eigene Schnittstelle holen. Die App-only-Anmeldung verlangt zwei Dinge: das Anwendungsrecht Exchange.ManageAsApp und ein Zertifikat. Dazu bekommt die App eine Entra-Rolle, die bestimmt, welche Cmdlets sie ausführen darf. Für Security & Compliance PowerShell gilt dasselbe, mit einem eigenen Eintrag des Rechts.
Der Lauf fragte 101 Lese-Cmdlets (Get-*) ab. 93 lieferten Daten, zusammen 1169 Objekte: 11 Postfächer, 3 Transportregeln, Anti-Spam- und Malware-Richtlinien, Safe Links, Aufbewahrungsrichtlinien, Postfachberechtigungen, Gruppenmitglieder und vieles mehr. 8 Abfragen scheiterten, und der Grund liegt bei Microsoft, nicht im Skript:
- 403 (6):
GlobalQuarantinePolicy,AddressList,GlobalAddressList,OfflineAddressBook,HybridConfigurationundDeliveryAgentConnector. Die Antwort enthält keinen Text. Wahrscheinlich reicht die Entra-Rolle der App für diese Cmdlets nicht, belegt ist das nicht. - 404 (1):
ApplicationAccessPolicyist im Tenant nicht erreichbar. - 405 (1):
MalwareFilteringServermeldet, das Cmdlet sei nicht verfügbar, abgekündigt oder gesperrt.
Security & Compliance: derselbe Zugang, anderer Weg
Security & Compliance PowerShell gehört zum selben Recht Exchange.ManageAsApp. Der erste Versuch über die REST-Schnittstelle scheiterte. Es lief dann mit Connect-IPPSSession und Zertifikat in einem Container. Das Skript fragte 37 Cmdlets ab und sicherte 551 Objekte, darunter:
- 6 Aufbewahrungsrichtlinien,
- 5 DLP-Richtlinien mit 14 Regeln,
- 15 Vertraulichkeitsbezeichnungen und 2 Bezeichnungsrichtlinien.
4 Abfragen waren nicht möglich: IRMConfiguration und ManagementRoleAssignment kennt die Sitzung nicht, ComplianceSecurityFilter verlangt eine Sitzung im reinen Suchmodus, bei AuditConfig kam ein interner Fehler.
Welche App-Rechte nötig waren
Alle Rechte sind Anwendungsberechtigungen mit Admin-Zustimmung. Sie lesen nur. Die vollständige Liste und die kleinsten Rechte je Abfrage stehen in der Berechtigungsreferenz von Microsoft Graph.
| Recht | Wofür | Bemerkung |
|---|---|---|
Mail.Read |
Nachrichten und Anhänge aller Postfächer |
Lesen aller Postfächer, bei Bedarf per Richtlinie einschränken |
Calendars.Read |
Termine |
|
Contacts.Read |
Kontakte |
|
Chat.Read.All |
Chats und ihre Nachrichten |
Sehr persönliche Inhalte |
ChannelMessage.Read.All |
Kanalnachrichten und Antworten |
Sehr persönliche Inhalte |
Team.ReadBasic.All |
Teams und Kanäle auflisten |
Mitglieder brauchen zusätzlich TeamMember.Read.All |
Policy.Read.All |
Conditional Access, Richtlinien |
|
Directory.Read.All |
Benutzer, Gruppen, Apps, Geräte |
|
RoleManagement.Read.All |
Rollen, Zuweisungen, PIM |
|
DeviceManagementConfiguration.Read.All |
Intune-Konfiguration und Compliance |
|
DeviceManagementApps.Read.All |
Intune-Apps und Schutzrichtlinien |
|
Sites.FullControl.All |
SharePoint-Dateien, Versionen und Tenant-Einstellungen |
Mit Zertifikat; das Recht ist weit, das Lesen genügt nur dank der Auflage im Skript |
Exchange.ManageAsApp |
Exchange-Admin-Cmdlets ( Get-*), auch Security & Compliance |
Mit Zertifikat und Entra-Rolle |
Zwei Hinweise dazu. Alle Rechte sind nur lesend gedacht, Sites.FullControl.All und Exchange.ManageAsApp sind es technisch nicht. Dort schützt dich nur das Skript. Entziehe darum alle Rechte, sobald die Sicherung fertig ist, und lösche die App oder ihre Zertifikate, wenn du sie nicht mehr brauchst.
Secrets: Was kein Backup enthalten kann
Kennwörter und Secret-Werte gibt kein Dienst heraus. Das ist Absicht. Eine Sicherung kann sie deshalb nicht enthalten, und eine, die es behauptet, sollte dich misstrauisch machen. Der Ausweg besteht aus zwei Teilen.
- Ein Inventar ohne Werte.
backup/secrets_inventory.pyschreibtsecrets_inventory.json. Es hält fest, wo ein Secret fehlt: bei 10 Benutzern ein Kennwort, bei einer App ein Secret mit Anzeigename und Ablauf, bei zwei Apps ein Zertifikat. Dazu steht eine Checkliste mit 12 Punkten dabei, die kein Skript erledigt: MFA-Methoden neu registrieren, Notfallkonten, Gäste einladen, Zustimmungen erneuern, Verbindungen in Power Automate und Logic Apps, Lizenzen vor der ersten Anmeldung. - Ein Restore-Skript.
restore/secrets_restore.pyliest das Inventar und fragt beim Einspielen im Ziel-Tenant, was es tun soll. Es legt neue Werte an, nie alte.
Das Skript folgt vier Regeln:
- Trockenlauf ist der Standard. Ohne
--executegibt es nur einen Plan, ohne Netz und ohne Änderung. - Neue Werte landen in einem Tresor. Das ist eine Datei mit Rechten 600. Wer die Werte am Bildschirm sehen will, bekommt sie einmal am Ende.
- Werte stehen nie im Protokoll. Das Protokoll hält nur Objekt, Art, Ablauf und Schlüssel-ID fest.
- Die Anmeldung läuft nie über die Kommandozeile. Das Skript fragt das Secret per Eingabe ab oder nimmt ein Zertifikat.
# Plan ansehen: Trockenlauf, kein Netz, keine Änderung python3 restore/secrets_restore.py --backup ./backup/contoso/20261116-0557 \ --tenant <TENANT-ID> --client-id <CLIENT-ID> --new-domain example.com # Erst nach dem Plan: wirklich einspielen python3 restore/secrets_restore.py ... --execute
def write_600(path, data):
"""Atomar mit Rechten 600 schreiben (die Datei ist nie für andere lesbar)."""
p = Path(path); tmp = p.with_name(p.name + ".tmp")
fd = os.open(tmp, os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o600)
with os.fdopen(fd, "w", encoding="utf-8") as f:
json.dump(data, f, indent=1, ensure_ascii=False)
os.chmod(tmp, 0o600); os.replace(tmp, p)
Im Trockenlauf meldet das Skript für den Demo-Tenant: 10 Benutzerkennwörter, 1 App-Secret, 2 App-Zertifikate und 12 Checklistenpunkte. Benutzer bekommen wahlweise ein zufälliges Kennwort mit Zwang zum Wechsel bei der ersten Anmeldung oder ein eingegebenes. Secrets erhalten den gleichen Anzeigenamen und eine wählbare Laufzeit, Zertifikate entstehen neu oder du lädst eine Datei hoch.
Ehrlich bleibt: Den Einspielmodus hat bisher niemand gegen einen echten Ziel-Tenant getestet. Der Trockenlauf und der Selbsttest (--self-test, 7 Tests) liefen sauber. Auch die Ablage im Azure Key Vault (--keyvault) ist gebaut, aber noch nicht gegen einen echten Tresor geprüft. Teste das Skript zuerst mit einem leeren Test-Tenant, bevor du ihm einen Notfall anvertraust.
Übersicht: Was ist drin, womit geholt, was fehlt
| Was | Womit geholt | Was fehlt |
|---|---|---|
Entra-Konfiguration |
Microsoft365DSC und Graph |
Teile mit 403 oder 400 (19 Abfragen) |
SharePoint-Struktur, Dateien, Versionen |
Graph |
Papierkorb-Inhalt, 11'792 ältere Versionen (nur Metadaten), Termspeicher (403), 4 Seiten |
SharePoint-Tenant-Einstellungen |
Admin-REST mit Zertifikat |
5 Abfragen (405, 404, 403) |
Postfächer, Termine, Kontakte |
Graph ( Mail.Read und weitere) |
145 Elemente in «Gelöschte Elemente», Ursache offen |
Teams, Kanäle, Chats |
Graph |
36 Mitgliederlisten (403) |
Conditional Access, Rollen, PIM |
Graph |
Nichts Bekanntes |
Intune |
Graph |
11 Abfragen ohne Recht oder Pfad |
Exchange |
Admin-REST mit Zertifikat |
8 Cmdlets (6 mal 403, je 1 mal 404 und 405) |
Security & Compliance |
Connect-IPPSSession mit Zertifikat |
4 von 37 Cmdlets |
Teams-Einstellungen |
Connect-MicrosoftTeams mit Zertifikat |
22 Cmdlets mit Pflichtparameter übersprungen |
Kennwörter, Secrets, Zertifikate |
Inventar plus Restore-Skript |
Werte selbst, Einspielen ungetestet |
Grenzen, die du kennen solltest
- Eine Sicherung ohne Restore-Test ist ein Wunsch. Weder die Dateien noch die Postfächer wurden zurückgespielt. Gesichert heisst hier: gelesen und als Dateien abgelegt.
- Der Papierkorb und Versionen sind begrenzt. Der Papierkorb liefert nur Metadaten, Dateiversionen liegen höchstens zehn je Datei als Inhalt vor, die übrigen 11'792 nur als Metadaten.
- Fehlende Rechte sehen nach leerem Bereich aus. Ein 403 ist sichtbar, ein leeres Ergebnis nicht. Vergleiche Summen, wo es sie gibt.
- Chats und Kanalnachrichten sind persönlich. Kläre vor dem Lesen die Datenschutzlage.
- Die Sicherung ist so heikel wie der Tenant. Sie enthält Mails und Chats. Lege sie verschlüsselt ab und lösche, was du nicht mehr brauchst.
- Ein Demo-Tenant ist klein. Bei einem Tenant mit Tausenden Postfächern dauert der Lauf Tage, und Drosselung wird zum Thema.
Einordnung: Was das für Admins und IT-Dienstleister heisst
Für Admins ist die Folge klar: Microsoft365DSC ist ein Teil der Sicherung, nie die ganze. Wer einen Tenant vor einer Migration, einem Ablauf oder einem Ausstieg sichert, plant drei Wege ein: Konfiguration per Modul, Inhalte per Graph oder Backup-Produkt, Secrets per Inventar. Dienstleister gewinnen eine Checkliste, die sie je Kunde abarbeiten. Das Wichtigste dabei: Die App-Rechte brauchen eine Frist. Vergib sie am Anfang, entziehe sie am Ende, und halte den Zeitraum schriftlich fest. Wer produktive Daten sichern will, nimmt besser ein geprüftes Produkt wie Microsoft 365 Backup, das Restore mitbringt.
Fazit
Die Sicherung eines Demo-Tenants gelang zu grossen Teilen: Dateien, Postfächer, Teams, Richtlinien, Exchange-, Compliance- und Teams-Einstellungen liegen als lesbare Dateien vor, Secrets als Inventar. Lücken bleiben bei Papierkorb-Inhalten, dem Termspeicher, einigen Intune-Bereichen, acht Exchange-Abfragen und der Mitgliederliste von Teams. Starte mit einer kleinen Auswahl, trage nur die Rechte ein, die du brauchst, und teste den Restore, bevor die Lizenz abläuft.
Die Skripte
Die Skripte liegen als Ordner m365-backup bereit. Dateinamen, Optionen und Ausgaben sind englisch, die Kommentare im Code deutsch. Alle Aufrufe gegen Microsoft sind lesend. Jedes Skript nimmt --out <Zielordner> und zeigt mit --help seine Optionen. Oben stehen die PowerShell-Skripte, die Python-Hilfsskripte lassen sich aufklappen, im Editor sind alle Dateien zu sehen.
Backup- und Restore-Skripte19 Dateien
- backup/compliance.ps1Security-&-Compliance-Konfiguration
- backup/teams_settings.ps1Teams-Richtlinien
Python-Hilfsskripte und README (17)
- m365_auth.pyGemeinsame Anmeldung mit Zertifikat, Wiederholung bei 429/5xx, Paging
- backup/graph_export.pyVerzeichnis, Richtlinien, Rollen, Apps, Intune, SharePoint-Sites mit Listen
- backup/drive_inventory.pyInventar aller Laufwerke
- backup/files_export.pyAlle Dateien samt
manifest.jsonl(SHA-256) - backup/file_versions.pyÄltere Dateiversionen (
--max-versions) - backup/sharepoint_lists.pyListeneintrag-Versionen, Papierkorb-Metadaten, Seiten mit Layout
- backup/mailboxes.pyMail, Anhänge, Kalender und Kontakte je Benutzer
- backup/teams.pyTeams, Kanäle, Nachrichten, Chats
- backup/graph_settings.pyWeitere Richtlinien, Rollen, Intune-Details, Lizenzen
- backup/spo_tenant.pySharePoint-Tenant-Einstellungen über die Admin-Site
- backup/exchange.pyExchange-Online-Konfiguration (
--retry-gzip) - backup/secrets_inventory.pyInventar der App-Secrets und Zertifikate, nur Metadaten
- backup/permission_probe.pyRechteprobe
- backup/verify_files.pyVollständigkeitsprüfung
- backup/report.pySammelbericht
- restore/secrets_restore.pyRestore der Secrets, Trockenlauf ohne
--execute - README.mdAnleitung und Stand der Prüfung
Ehrlich zum Stand: Seit der Umbenennung ins Englische lief kein Skript gegen einen Tenant, denn der Demo-Tenant ist abgelaufen. Geprüft sind die Syntax der Python-Dateien, --help jedes Skripts, der Selbsttest und ein Trockenlauf des Restore. Die zwei PowerShell-Skripte (compliance.ps1, teams_settings.ps1) sind ungetestet, PowerShell stand nicht zur Verfügung. Lies jedes Skript, bevor du es laufen lässt, und teste zuerst in einem leeren Tenant.
Quellen: Microsoft Graph, Berechtigungsreferenz, Versionen eines Elements auflisten, Papierkorb-Einträge auflisten, Nachrichten auflisten, Kanalnachrichten auflisten, Chatnachrichten auflisten, Teammitglieder auflisten, Conditional-Access-Richtlinien auflisten, App-only-Anmeldung für Exchange Online PowerShell, SharePoint: App-only mit Entra ID. Foto: Taken / Pixabay. Zuletzt geprüft: 16. November 2026.
Versionen auflisten – Microsoft Graph v1.0
Der Namespace lautet microsoft.graph. Die Schnittstelle ruft die Versionen einer Datei ab.
OneDrive und SharePoint lassen sich so einstellen, dass sie den Verlauf von Dateien aufbewahren. Je nach Dienst und Konfiguration entsteht eine neue Version bei jeder Bearbeitung, bei jedem Speichern, nur manuell oder nie. Frühere Versionen eines Dokuments bleiben unter Umständen nur für eine begrenzte Zeit erhalten, abhängig von Administratoreinstellungen, die je Benutzer oder Standort verschieden sein können.
Die Schnittstelle steht in diesen nationalen Cloud-Umgebungen zur Verfügung: Global service, US Government L4, US Government L5 (DOD) und China operated by 21Vianet. Die Tabelle markiert alle vier Umgebungen als unterstützt.
Berechtigungen
Man wählt die Berechtigung, die als am wenigsten privilegiert gekennzeichnet ist, und nutzt höher privilegierte nur, wenn die App sie braucht. Delegiert (Geschäfts-, Schul- oder Uni-Konto) und delegiert (persönliches Microsoft-Konto) ist Files.Read die am wenigsten privilegierte Berechtigung, bei der Anwendung ist es Files.Read.All. Höher privilegiert sind bei delegiertem Geschäfts-, Schul- oder Uni-Konto Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All und Sites.ReadWrite.All, beim persönlichen Microsoft-Konto Files.Read.All, Files.ReadWrite und Files.ReadWrite.All, bei der Anwendung Files.ReadWrite.All, Sites.Read.All und Sites.ReadWrite.All. SharePoint Embedded braucht zusätzlich die Berechtigung FileStorageContainer.Selected für den Zugriff auf den Inhalt des Containers, und die App benötigt ausserdem die nötigen Berechtigungen des Containertyps.
HTTP-Anfrage
Dieser Teil enthält im Original keinen Text.
Anfrage-Header
Der Header Authorization ist erforderlich und enthält Bearer gefolgt vom Token. Weitere Informationen stehen im Abschnitt zu Authentifizierung und Autorisierung.
Antwort
Bei Erfolg liefert die Methode den Antwortcode 200 OK. Der Antwortkörper enthält eine Sammlung von DriveItemVersion-Objekten.
Beispiel
Das Beispiel ruft die Versionen einer Datei im Laufwerk des aktuellen Benutzers ab.
Anfrage
Die Anfrage lässt sich in HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python darstellen.
Antwort
Die Antwort liefert eine Sammlung von Versionen.
Hinweise
Die Versionen erscheinen in absteigender Reihenfolge, von der neuesten zur ältesten, und der OData-Abfrageparameter $orderby wird nicht unterstützt. OneDrive bewahrt die Metadaten früherer Dateiversionen nicht vollständig auf. Ruft eine App die verfügbaren Versionen einer Datei ab, erhält sie eine DriveItemVersion-Ressource mit den vorhandenen Angaben zur jeweiligen Version.
«Retrieve the versions of a file.»
Wörtliches Zitat aus dem Original.
Quelle: learn.microsoft.com, «List versions - Microsoft Graph v1.0». Die Rechte liegen beim Herausgeber. Zusammenfassung und Übersetzung: brauckmann.ch.
Original öffnenElemente auflisten - Microsoft Graph v1.0
Der Namespace lautet microsoft.graph. Die Methode liefert eine Sammlung von recycleBinItem-Ressourcen aus dem Papierkorb eines angegebenen SharePoint-Embedded-fileStorageContainers.
Die Schnittstelle steht in diesen nationalen Cloud-Umgebungen bereit: globaler Dienst, US Government L4, US Government L5 (DOD) und China, betrieben von 21Vianet. Die Tabelle markiert alle vier Umgebungen als unterstützt.
Berechtigungen
Es soll die Berechtigung gewählt werden, die als am wenigsten privilegiert markiert ist, und eine höher privilegierte nur, wenn die App sie braucht. Für delegierte Berechtigungen (Geschäfts-, Schul- oder persönliches Microsoft-Konto) und für Anwendungsberechtigungen gilt jeweils FileStorageContainer.Selected als am wenigsten privilegiert. Höher privilegierte Berechtigungen gibt es nicht.
Optionale Abfrageparameter
Die Methode unterstützt die OData-Abfrageparameter $select und $top, um die Antwort anzupassen. Allgemeine Informationen stehen unter OData-Abfrageparameter.
Anfrage-Header
Der Header Authorization mit dem Wert Bearer {token} ist erforderlich. Mehr dazu steht unter Authentifizierung und Autorisierung.
Anfragetext
Für diese Methode wird kein Anfragetext mitgeschickt.
Antwort
Bei Erfolg gibt die Methode den Code 200 OK zurück. Der Antworttext enthält eine Sammlung von recycleBinItem-Objekten.
Beispiele
Dieser Abschnitt leitet die Beispiele ein und enthält selbst keinen weiteren Text.
Anfrage
Das Beispiel zeigt eine Anfrage, die alle recycleBinItem-Ressourcen eines bestimmten SharePoint-Embedded-fileStorageContainers auflistet. Der Codeausschnitt liegt in den Varianten HTTP, C#, Go, Java, JavaScript, PHP und Python vor.
Antwort
Das folgende Beispiel zeigt die zugehörige Antwort.
«Get a collection of recycleBinItem resources in the recycleBin of the specified SharePoint Embedded fileStorageContainer.»
Wörtliches Zitat aus dem Original.
Quelle: learn.microsoft.com, «List items - Microsoft Graph v1.0». Die Rechte liegen beim Herausgeber. Zusammenfassung und Übersetzung: brauckmann.ch.
Original öffnenNachrichten auflisten - Microsoft Graph v1.0
Der Namespace lautet microsoft.graph. Die Operation liefert die Nachrichten im Postfach des angemeldeten Benutzers, auch aus den Ordnern «Gelöschte Elemente» und «Clutter».
Je nach Seitengrösse und Postfachdaten kann das Abrufen mehrere Anfragen erfordern; standardmässig umfasst eine Seite 10 Nachrichten, mit $top lässt sich die Grösse zwischen 1 und 1000 festlegen. Mit $select lassen sich genau die benötigten Eigenschaften angeben, was die Antwortzeit verbessert (siehe Beispiel 1). Besonders bei grossen Seiten sollten $select und $top fein abgestimmt werden, weil Hunderte Nachrichten mit vollständigem Inhalt einen Gateway-Timeout (HTTP 504) auslösen können.
Für die nächste Seite wird die komplette URL aus @odata.nextLink in der folgenden Abfrage verwendet, da sie die ursprünglichen Abfrageparameter enthält. Der $skip-Wert soll nicht aus dieser URL herausgelöst und verändert werden, denn die API zählt damit alle durchlaufenen Elemente im Postfach, um eine Seite mit Nachrichten zu liefern. Deshalb kann $skip schon in der ersten Antwort grösser als die Seitengrösse sein; weitere Informationen stehen unter «Paging Microsoft Graph data in your app».
Derzeit gibt die Operation Nachrichteninhalte nur im HTML-Format zurück. Eine App kann Nachrichten aus dem Postfachordner eines anderen Benutzers in zwei Szenarien abrufen.
Das ist möglich, wenn die App Anwendungsberechtigungen besitzt oder passende delegierte Berechtigungen eines Benutzers hat, dem ein anderer Benutzer einen Postfachordner freigegeben oder delegierten Zugriff gewährt hat. Details und ein Beispiel sind verlinkt, und die API ist in den folgenden nationalen Cloud-Bereitstellungen verfügbar.
Die Tabelle nennt vier Bereitstellungen: Global Service, US Government L4, US Government L5 (DOD) und China, betrieben von 21Vianet. Für alle vier ist die API verfügbar.
Berechtigungen
Es soll die Berechtigung mit den geringsten Rechten gewählt werden, und höhere Berechtigungen nur, wenn die App sie braucht; Details stehen unter «Permission types» und in der Berechtigungsreferenz. Für delegierte Zugriffe (Geschäfts-, Schul- oder persönliches Microsoft-Konto) ist Mail.ReadBasic die Berechtigung mit den geringsten Rechten, höher privilegiert sind Mail.ReadWrite und Mail.Read. Für Anwendungsberechtigungen gilt Mail.ReadBasic.All als geringste Berechtigung, höher privilegiert sind Mail.ReadWrite und Mail.Read.
HTTP-Anfrage
Dieser Teil führt die Anfrage auf, um alle Nachrichten im Postfach eines Benutzers abzurufen. Ausserdem folgt die Anfrage für Nachrichten in einem bestimmten Ordner des Postfachs.
Optionale Abfrageparameter
Die Methode unterstützt die OData-Abfrageparameter, mit denen sich die Antwort anpassen lässt.
$filter und $orderby in derselben Abfrage verwenden
Wer beim Abrufen von Nachrichten $filter und $orderby gemeinsam nutzt, muss die Eigenschaften nach drei Regeln angeben: Jede Eigenschaft aus $orderby muss auch in $filter vorkommen, und zwar in derselben Reihenfolge. Ausserdem müssen die Eigenschaften aus $orderby in $filter vor allen Eigenschaften stehen, die nicht in $orderby auftauchen. Wer das nicht beachtet, erhält den Fehlercode InefficientFilter mit der Meldung, die Einschränkung oder Sortierung sei für diesen Vorgang zu komplex.
Anfrage-Header
Der Header Authorization ist erforderlich, vom Typ string und enthält Bearer {token}; zur Authentifizierung und Autorisierung gibt es weiterführende Informationen. Der optionale Header Prefer: outlook.body-content-type legt das Format fest, in dem die Eigenschaften body und uniqueBody zurückkommen, nämlich "text" oder "html". Fehlt dieser Header, liefert die Methode body und uniqueBody im HTML-Format.
Anfragetext
Für diese Methode darf kein Anfragetext mitgeschickt werden.
Antwort
Bei Erfolg gibt die Methode den Antwortcode 200 OK zurück. Im Antworttext liegt eine Sammlung von Message-Objekten.
Beispiele
Dieser Teil enthält keinen eigenen Text, er leitet die folgenden Beispiele ein.
Beispiel 1: Alle Nachrichten auflisten
Dieser Teil enthält keinen eigenen Text, er leitet das erste Beispiel ein, in dem alle Nachrichten aufgelistet werden.
Anfrage
Das Beispiel ruft standardmässig die obersten 10 Nachrichten im Postfach des angemeldeten Benutzers ab. Mit $select kommt in der Antwort nur eine Teilmenge der Eigenschaften jeder Nachricht zurück. Der Codebeispiel-Reiter bietet die Varianten HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python.
Antwort
Das folgende Beispiel zeigt die Antwort des Dienstes. Um die nächste Seite mit Nachrichten abzurufen, verwendet man die in @odata.nextLink gelieferte URL in einer weiteren GET-Anfrage.
«To get the next page of messages, simply apply the entire URL returned in @odata.nextLink to the next get-messages request.»
Wörtliches Zitat aus dem Original.
Quelle: learn.microsoft.com, «List messages - Microsoft Graph v1.0». Die Rechte liegen beim Herausgeber. Zusammenfassung und Übersetzung: brauckmann.ch.
Original öffnenKanalnachrichten auflisten - Microsoft Graph v1.0
Der Namensraum lautet microsoft.graph. Die API ruft die Nachrichten eines Kanals in einem Team ab, allerdings ohne die Antworten.
Antworten auf eine Nachricht lassen sich über die API zum Auflisten von Nachrichtenantworten oder über die API zum Abrufen einer einzelnen Antwort holen. Die Methode unterstützt Föderation. Wer Kanalnachrichten im Anwendungskontext auflisten will, muss die Anfrage aus dem Mandanten stellen, zu dem der Kanalbesitzer gehört, den die Eigenschaft tenantId des Kanals angibt.
Die API erlaubt es, Änderungen (Erstellen, Aktualisieren, Löschen) per Änderungsbenachrichtigung zu abonnieren und so in Echtzeit zu erhalten. Details stehen im Artikel «Benachrichtigungen für Nachrichten abrufen». Die API ist in den folgenden nationalen Cloud-Umgebungen verfügbar.
Die Tabelle nennt vier Umgebungen: den globalen Dienst, US Government L4, US Government L5 (DOD) und China, betrieben von 21Vianet. Für alle vier ist die API mit einem Häkchen als verfügbar markiert.
Berechtigungen
Es sollen die Berechtigungen mit den geringsten Rechten gewählt werden, höhere nur bei Bedarf der App. Delegiert (Geschäfts- oder Schulkonto) ist ChannelMessage.Read.All die am wenigsten privilegierte Berechtigung, höher privilegiert sind Group.Read.All und Group.ReadWrite.All; für persönliche Microsoft-Konten wird nichts unterstützt. Für Anwendungen genügt ChannelMessage.Read.Group, höher privilegiert sind ChannelMessage.Read.All, Group.Read.All und Group.ReadWrite.All, wobei ChannelMessage.Read.Group ressourcenspezifische Zustimmung nutzt.
HTTP-Anfrage
Dieser Teil enthält im Original keinen Text.
Optionale Abfrageparameter
Die Methode unterstützt zwei OData-Parameter: $top legt die Zahl der Kanalnachrichten pro Seite fest, standardmässig 20 und höchstens 50. Mit $expand erhält man die Eigenschaften der Nachrichten, die Antworten sind, wobei eine Antwort bis zu 200 Antworten enthalten kann. Bei mehr als 200 Antworten dient die in [email protected] zurückgegebene Anfrage-URL für die nächste Seite, andere OData-Parameter werden derzeit nicht unterstützt.
Anfrage-Header
Der Header Authorization mit dem Wert Bearer {token} ist erforderlich. Mehr dazu steht in der Dokumentation zu Authentifizierung und Autorisierung.
Anfragetext
Für diese Methode darf kein Anfragetext mitgeschickt werden.
Antwort
Bei Erfolg gibt die Methode den Antwortcode 200 OK zurück, im Antworttext steht eine Sammlung von chatMessage-Objekten. Die Kanalnachrichten sind nach dem letzten Änderungsdatum der gesamten Antwortkette sortiert, wobei die ursprüngliche Kanalnachricht und ihre Antworten zusammen zählen.
Beispiele
Dieser Teil enthält nur die Überschrift und leitet die folgenden Beispiele ein.
Beispiel 1: Anfrage mit dem Abfrageparameter $top und ohne den optionalen Prefer-Header
Dieser Teil enthält nur die Überschrift des ersten Beispiels. Es zeigt eine Anfrage mit $top und ohne den optionalen Prefer-Header.
Anfrage
Das Beispiel zeigt eine Anfrage mit der Abfrageoption $top und ohne den optionalen Prefer-Header. Es steht in HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python zur Verfügung.
Antwort
Das Beispiel zeigt eine Anfrage. Mit @odata.nextLink in der Antwort lässt sich die nächste Seite mit Nachrichten abrufen.
Beispiel 2: Anfrage mit optionalem Prefer-Header
Dieser Teil enthält nur die Überschrift des zweiten Beispiels. Es zeigt eine Anfrage mit dem optionalen Prefer-Header.
Anfrage
Das Beispiel zeigt eine Anfrage. Es steht in HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python zur Verfügung.
Antwort
Das Beispiel zeigt die Antwort auf eine Anfrage, deren Header den Wert Prefer: include-unknown-enum-members enthält.
Beispiel 3: Anfrage mit den Abfrageoptionen $top und $expand für Antworten
Dieser Teil trägt nur die Überschrift und enthält keinen weiteren Text.
Anfrage
Die Anfrage nutzt $top, um pro Seite eine Kanalnachricht zurückzugeben, und $expand, um die Antworten auf diese Nachricht einzubeziehen. Aufgeführt sind Codebeispiele für HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python.
Antwort
Die Antwort enthält eine Kanalnachricht auf der Seite sowie in @odata.nextLink eine URL, mit der sich die nächste Nachricht des Kanals abrufen lässt. Sie umfasst auch die Antworten auf diese Nachricht: Die Operation kann bis zu 1,000 Antworten je Kanalnachricht liefern, und [email protected] verweist auf weitere Antworten jenseits der Seitengrösse von 1,000. Das Beispiel geht von mehr als 1,000 Antworten aus, zeigt aber der Lesbarkeit halber nur drei.
«Retrieve the list of messages (without the replies) in a channel of a team.»
Wörtliches Zitat aus dem Original.
Quelle: learn.microsoft.com, «List channel messages - Microsoft Graph v1.0». Die Rechte liegen beim Herausgeber. Zusammenfassung und Übersetzung: brauckmann.ch.
Original öffnenNachrichten in einem Chat auflisten – Microsoft Graph v1.0
Der Namespace lautet microsoft.graph. Die Methode ruft die Liste der Nachrichten eines Chats ab.
Die Methode unterstützt Föderation. Um Chatnachrichten im Anwendungskontext aufzulisten, muss die Anfrage aus dem Tenant stammen, zu dem der Kanalbesitzer gehört, den die Eigenschaft tenantId des Kanals angibt. Die API erlaubt es, Änderungen (Erstellen, Aktualisieren, Löschen) per Änderungsbenachrichtigung zu abonnieren und so in Echtzeit zu erhalten; Details stehen unter «Get notifications for messages». In einer oder mehreren nationalen Clouds funktioniert die API anders, was unter «Implementation differences in national clouds» beschrieben ist.
Die API ist in diesen nationalen Cloud-Bereitstellungen verfügbar: Global Service, US Government L4, US Government L5 (DOD) und China, betrieben von 21Vianet. Die Tabelle markiert alle vier mit einem Häkchen.
Berechtigungen
Man soll die Berechtigung wählen, die als am wenigsten privilegiert gekennzeichnet ist, und höhere Berechtigungen nur nutzen, wenn die App sie braucht. Bei delegierten Berechtigungen (Geschäfts- oder Schulkonto) ist Chat.Read die am wenigsten privilegierte und Chat.ReadWrite die höhere; für persönliche Microsoft-Konten wird nichts unterstützt. Bei Anwendungsberechtigungen ist ChatMessage.Read.Chat die am wenigsten privilegierte, höher privilegiert sind Chat.Read.All und Chat.ReadWrite.All.
HTTP-Anfrage
Dieser Teil enthält im vorliegenden Text keine Angaben.
Optionale Abfrageparameter
Die Methode unterstützt OData-Parameter: $top steuert die Anzahl Elemente pro Antwort, der Höchstwert beträgt 50. $orderby unterstützt lastModifiedDateTime (Standard) und createdDateTime in absteigender Reihenfolge, aufsteigend ist nicht möglich. $filter setzt einen Datumsbereich: bei lastModifiedDateTime mit gt und lt, bei createdDateTime mit lt; er wirkt nur, wenn $orderby und $filter für dieselbe Eigenschaft in der URL stehen, andere OData-Parameter werden nicht unterstützt.
Anfrage-Header
Der Header Authorization ist erforderlich und hat den Wert Bearer {token}. Weitere Informationen stehen unter Authentifizierung und Autorisierung.
Anfragetext
Für diese Methode darf kein Anfragetext mitgeschickt werden.
Antwort
Bei Erfolg liefert die Methode den Antwortcode 200 OK. Der Antworttext enthält eine Sammlung von chatMessage-Objekten.
Beispiel 1: Anfrage ohne den optionalen Prefer-Header
Das folgende Beispiel zeigt eine Anfrage. Mit $top=2 werden zwei Nachrichten abgerufen.
Anfrage
Das folgende Beispiel zeigt die Anfrage. Die Codebeispiele gibt es für HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python.
Antwort
Das folgende Beispiel zeigt die Antwort.
Beispiel 2: Anfrage mit dem optionalen Prefer-Header
Das folgende Beispiel zeigt eine Anfrage. Mit $top=2 werden zwei Nachrichten abgerufen.
Anfrage
Das folgende Beispiel zeigt die Anfrage. Die Codebeispiele gibt es für HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python.
Antwort
Das folgende Beispiel zeigt die Antwort, wenn im Anfrage-Header Prefer: include-unknown-enum-members angegeben ist.
Beispiel 3: Chatnachrichten nach Erstellungsdatum sortiert auflisten
Das Beispiel zeigt eine Anfrage, die die obersten zwei Nachrichten ($top=2) abruft. Die Nachrichten sind nach der Eigenschaft createdDateTime sortiert ($orderby=createdDateTime).
Anfrage
Das folgende Beispiel zeigt die Anfrage. Es gibt Darstellungen für HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python.
Antwort
Das folgende Beispiel zeigt die Antwort.
Beispiel 4: Chatnachrichten nach Bereich des letzten Änderungsdatums gefiltert auflisten
Die Anfrage listet die obersten zwei Nachrichten ($top=2) auf und sortiert sie absteigend nach lastModifiedDateTime ($orderby=lastModifiedDateTime desc). Zusätzlich filtert sie auf einen bestimmten Datumsbereich: lastModifiedDateTime grösser als 2022-09-22T00:00:00.000Z und kleiner als 2022-09-24T00:00:00.000Z.
Anfrage
Das folgende Beispiel zeigt die Anfrage. Es gibt Darstellungen für HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python.
Antwort
Das folgende Beispiel zeigt die Antwort.
«Don't supply a request body for this method.»
Wörtliches Zitat aus dem Original.
Quelle: learn.microsoft.com, «List messages in a chat - Microsoft Graph v1.0». Die Rechte liegen beim Herausgeber. Zusammenfassung und Übersetzung: brauckmann.ch.
Original öffnenMitglieder eines Teams auflisten – Microsoft Graph v1.0
Der Namensraum lautet microsoft.graph. Die Methode ruft die Sammlung der conversationMember-Objekte eines Teams ab.
Die vom Server gelieferten Mitgliedschafts-IDs gelten als undurchsichtige Zeichenfolgen, die der Client weder auswerten noch deuten soll. Künftig können die Ergebnisse laut Antwort auch Benutzer aus verschiedenen Mandanten enthalten. Clients sollen deshalb nicht davon ausgehen, dass alle Mitglieder zum aktuellen Mandanten gehören.
Ruft ein neu erstellter Mandant diese Methode auf, gibt die API einen 401-Fehler zurück. Weitere Angaben stehen unter den bekannten Problemen.
Die API ist in diesen nationalen Cloud-Umgebungen verfügbar: Global Service, US Government L4, US Government L5 (DOD) und China, betrieben von 21Vianet. Die Tabelle markiert alle vier mit einem Häkchen.
Berechtigungen
Man soll die als am wenigsten privilegiert markierte Berechtigung wählen und eine höhere nur verwenden, wenn die App sie braucht. Delegiert mit Geschäfts- oder Schulkonto ist TeamMember.Read.All die am wenigsten privilegierte und TeamMember.ReadWrite.All die höher privilegierte Berechtigung; mit persönlichem Microsoft-Konto wird nichts unterstützt. Für Anwendungen ist TeamMember.Read.Group am wenigsten privilegiert, höher privilegiert sind TeamMember.ReadWrite.All und TeamMember.Read.All, und TeamMember.Read.Group nutzt ressourcenspezifische Zustimmung.
HTTP-Anfrage
Dieser Teil enthält keinen Text.
Optionale Abfrageparameter
Die Methode unterstützt die OData-Parameter $filter, $select und $top, um die Antwort anzupassen. Die Standardgrösse einer Seite beträgt 100 Objekte, die maximale 999.
Anfrage-Header
Der Header Authorization ist erforderlich und enthält Bearer {token}. Weitere Informationen stehen unter Authentifizierung und Autorisierung.
Anfragetext
Für diese Methode darf kein Anfragetext mitgeschickt werden.
Antwort
Bei Erfolg gibt die Methode den Antwortcode 200 OK zurück. Im Antworttext steht eine Sammlung von conversationMember-Objekten.
Beispiele
Dieser Teil nennt nur die Überschrift und enthält keinen weiteren Text.
Beispiel 1: Liste der Mitglieder eines Teams abrufen
Dieser Teil nennt nur die Überschrift des ersten Beispiels und enthält keinen weiteren Text.
Anfrage
Die Anfrage wird in acht Varianten gezeigt: HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python.
Antwort
Der Hinweis besagt, dass das gezeigte Antwortobjekt zur besseren Lesbarkeit gekürzt sein kann.
Beispiel 2: Mitglieder eines Teams über die Objekt-ID ihres Microsoft-Entra-Benutzers finden
Das Beispiel zeigt eine Anfrage, die Mitgliedschaftsressourcen anhand der ID des Microsoft-Entra-Benutzers sucht. Dieser Benutzer gehört zum aadUserConversationMember.
Anfrage
Die Anfrage wird wieder in acht Varianten gezeigt: HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python.
Antwort
Der Hinweis lautet, dass das gezeigte Antwortobjekt zur besseren Lesbarkeit gekürzt sein kann.
Beispiel 3: Mitglieder eines Teams anhand von Namen oder E-Mail finden
Das Beispiel zeigt eine Anfrage, die Mitgliedschaftsressourcen über den Anzeigenamen (displayName) oder die E-Mail-Adresse eines aadUserConversationMember sucht.
Anfrage
Der Teil führt die verfügbaren Darstellungen der Anfrage auf: HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python.
Antwort
Der Hinweis lautet, dass das gezeigte Antwortobjekt zur besseren Lesbarkeit gekürzt sein kann.
«The membership IDs returned by the server must be treated as opaque strings. The client shouldn't try to parse or make assumptions about these resource IDs.»
Wörtliches Zitat aus dem Original.
Quelle: learn.microsoft.com, «List members of team - Microsoft Graph v1.0». Die Rechte liegen beim Herausgeber. Zusammenfassung und Übersetzung: brauckmann.ch.
Original öffnenÜbersicht über das Microsoft Teams PowerShell-Modul
Das Microsoft Teams PowerShell-Modul ist eine Sammlung von Cmdlets, mit der sich Teams direkt über die PowerShell-Befehlszeile verwalten lässt. Dank der Automatisierungsfunktionen von PowerShell kann man alle Bereiche der Teams-Verwaltung abdecken, darunter Benutzer, Teams, Richtlinien und Konfiguration. Das Modul lässt sich auf mehreren Wegen installieren, wobei die neueste Version empfohlen wird; Angaben zu unterstützten Versionen stehen auf einer eigenen Seite zu den Versionen des Teams PowerShell-Moduls.
Die empfohlene Installationsart führt über den PowerShell Gallery. Alternativ kann man das Modul per manuellem Download installieren.
Datenerfassung
In den Standardeinstellungen sammelt das Teams PowerShell-Modul Telemetriedaten, die Microsoft aggregiert, um Nutzungsmuster und häufige Probleme zu erkennen, etwa Cmdlets mit geringer Erfolgsquote. Damit setzt Microsoft Prioritäten, um die Arbeit mit Teams PowerShell zu verbessern, und das Modul erfasst dabei keine privaten oder persönlichen Daten. Weitere Angaben finden sich in der Datenschutzerklärung von Microsoft; zudem verweist der Text auf Seiten zu Installation, Verwaltung, Versionshinweisen, Cmdlet-Referenz und Teams-Administratorrollen.
«Microsoft Teams PowerShell module is a set of cmdlets for managing Teams directly from the PowerShell command line.»
Wörtliches Zitat aus dem Original.
Quelle: learn.microsoft.com, «Microsoft Teams PowerShell Overview - Microsoft Teams». Die Rechte liegen beim Herausgeber. Zusammenfassung und Übersetzung: brauckmann.ch.
Original öffnenRichtlinien auflisten - Microsoft Graph v1.0
Der Namespace lautet microsoft.graph. Die Methode ruft eine Liste von conditionalAccessPolicy-Objekten ab.
Die API steht in allen genannten nationalen Cloud-Umgebungen bereit: im globalen Dienst, bei US Government L4, bei US Government L5 (DOD) und bei China, betrieben von 21Vianet.
Berechtigungen
Es sollen die als am wenigsten privilegiert gekennzeichneten Berechtigungen gewählt werden, höher privilegierte nur bei Bedarf der App. Für delegierten Zugriff mit Geschäfts- oder Schulkonto und für Anwendungsberechtigungen genügt Policy.Read.All, höher privilegierte Berechtigungen gibt es nicht, und persönliche Microsoft-Konten werden nicht unterstützt. Handelt die angemeldete Person bei delegiertem Zugriff stellvertretend für einen anderen Benutzer, braucht sie eine unterstützte Microsoft-Entra-Rolle oder eine benutzerdefinierte Rolle mit den nötigen Rechten. Unterstützt werden die integrierten Rollen Global Secure Access Administrator (Standardeigenschaften lesen), Security Reader (Standardeigenschaften lesen), Security Administrator (Standardeigenschaften lesen), Global Reader und Conditional Access Administrator.
HTTP-Anfrage
Dieser Teil enthält im Original keinen Text, der Inhalt der HTTP-Anfrage fehlt.
Optionale Abfrageparameter
Die Methode unterstützt die OData-Abfrageparameter $skip, $top, $count, $filter, $orderby und $select, um die Antwort anzupassen. Allgemeine Informationen dazu stehen unter OData-Abfrageparameter.
Anfrage-Header
Der Header Authorization mit dem Wert Bearer {token} ist erforderlich. Weitere Hinweise gibt es zu Authentifizierung und Autorisierung.
Anfragetext
Für diese Methode wird kein Anfragetext mitgeschickt.
Antwort
Bei Erfolg gibt die Methode den Antwortcode 200 OK zurück. Im Antworttext steht eine Sammlung von conditionalAccessPolicy-Objekten.
Beispiel
Dieser Teil enthält keinen eigenen Text, er leitet nur das Beispiel ein.
Anfrage
Das folgende Beispiel zeigt eine Anfrage. Der Teil nennt dazu die Darstellungen HTTP, C#, Go, Java, JavaScript, PHP, PowerShell und Python.
Antwort
Das folgende Beispiel zeigt die Antwort. Der Hinweis lautet, dass das gezeigte Antwortobjekt zur besseren Lesbarkeit gekürzt sein kann.
«Retrieve a list of conditionalAccessPolicy objects.»
Wörtliches Zitat aus dem Original.
Quelle: learn.microsoft.com, «List policies - Microsoft Graph v1.0». Die Rechte liegen beim Herausgeber. Zusammenfassung und Übersetzung: brauckmann.ch.
Original öffnenZugriff über Entra ID mit reinem App-Zugriff (App-Only) gewähren
Bei SharePoint Online lassen sich Anwendungen in Entra ID definieren, denen Berechtigungen für SharePoint und für alle anderen Dienste in Microsoft 365 erteilt werden können. Dieses Modell gilt für SharePoint Online als das bevorzugte, während SharePoint on-premises das SharePoint-Only-Modell über Azure ACS verwenden muss.
Eine Entra-ID-App für App-Only-Zugriff einrichten
Bei App-Only in Entra ID muss ein Zertifikat verwendet werden, um Zugriff auf die SharePoint-CSOM- und REST-APIs anzufordern. Wer das Zertifikat samt privatem Schlüssel besitzt, kann die App und ihre Berechtigungen nutzen, und die folgenden Schritte führen durch die Einrichtung.
Eine Entra-Anwendung über das Entra-Portal erstellen
Im Entra-Portal öffnet man unter Applications die App registrations, wählt New registration und vergibt einen Namen, zum Beispiel Microsoft365AssessmentToolForWorkflow. Man wählt Public client/native (mobile & desktop) mit http://localhost als Redirect-URI, klickt auf Register, prüft die benötigten Anwendungsberechtigungen unter API permissions und lädt unter Certificates & secrets die .cer-Datei des Zertifikats hoch. Zuletzt bestätigt man die Berechtigungen mit Grant admin consent for...; ohne Zertifikat lässt sich eines mit Windows PowerShell erstellen, und weitere Hinweise zum Erstellen einer Entra-Anwendung stehen in der Entra-Dokumentation.
Eine Entra-Anwendung mit PnP PowerShell erstellen
Das Cmdlet Register-PnPAzureADApp legt eine Entra-Anwendung an, erzeugt ein selbstsigniertes Zertifikat im persönlichen Bereich (My) des CurrentUser-Zertifikatspeichers, verknüpft es mit der Anwendung, setzt die Berechtigungen und fordert zur Zustimmung auf. Bei Fehlern fehlen vermutlich Berechtigungen, dann helfen die Tenant- oder Entra-Administratoren; contoso.onmicrosoft.com und [email protected] sind durch den eigenen Tenant-Namen und einen Entra- oder Global-Admin zu ersetzen, und den Tenant-Namen zeigt der Wert Primary domain im Entra-Portal. Nach der Anmeldung mit dem angegebenen Benutzer wird die Anwendung erstellt, es folgen 60 Sekunden Wartezeit für die Verbreitung und ein Zustimmungsdialog mit Accept, und das Zertifikat liegt im persönlichen Speicher des Benutzers (öffnbar mit certmgr) sowie zusätzlich als exportierte PFX- und cer-Datei, die sich löschen lassen.
Diesen Principal mit PnP PowerShell verwenden
Nach der Installation des PnP-PowerShell-Moduls kann man sich mit der nicht interaktiven Authentifizierung mit SharePoint Online verbinden und Operationen über diese zertifikatsbasierte App-Only-Vertrauensstellung ausführen. PnP PowerShell ist eine Open-Source-Lösung mit aktiver Community, und Microsoft bietet für diesen Support kein SLA.
Diesen Principal in einer CSOM-Anwendung verwenden
Für eine C#-Konsolenanwendung mit CSOM und Entra-ID-Authentifizierung über Anwendungsberechtigungen erstellt man eine neue .NET-Konsolenlösung. Man installiert das NuGet-Paket MSAL.NET mit Install-Package Microsoft.Identity.Client und fügt Code hinzu, der MSAL konfiguriert und mit einem Zertifikat ein Zugriffstoken holt.
Diesen Principal in einer CSOM-Anwendung mit der SharePoint-PnP-Framework-Bibliothek verwenden
Zuerst fügt man das NuGet-Paket PnP Framework (https://www.nuget.org/packages/PnP.Framework) hinzu, danach lässt sich der gezeigte Code nutzen. PnP Framework ist eine Open-Source-Lösung mit aktiver Community, und Microsoft bietet für diesen Support kein SLA.
Diesen Principal in PowerShell-Skripten verwenden, ohne von PnP PowerShell abzuhängen
Dieser Teil enthält keinen Text.
Häufige Fragen
Alle anderen Möglichkeiten sind nicht zulässig, denn SharePoint Online sperrt sie. Wer es trotzdem versucht, erhält die Meldung «Zugriff verweigert».
«In Entra ID when doing app-only you must use a certificate to request access to SharePoint CSOM/REST API's: anyone having the certificate and its private key can use the app and the permissions granted to the app.»
Wörtliches Zitat aus dem Original.
Quelle: learn.microsoft.com, «Granting access via Entra ID App-Only». Die Rechte liegen beim Herausgeber. Zusammenfassung und Übersetzung: brauckmann.ch.
Original öffnenApp-only-Authentifizierung in Exchange Online PowerShell und Security & Compliance PowerShell
Prüfungs- und Berichtsszenarien in Microsoft 365 nutzen oft unbeaufsichtigte Skripte in Exchange Online PowerShell und Security & Compliance PowerShell. Früher musste man dafür Benutzername und Passwort in einer lokalen Datei oder in einem zur Laufzeit abgefragten Geheimnistresor speichern, was sicherheitstechnisch nicht empfehlenswert ist. Die zertifikatbasierte Authentifizierung (CBA), auch App-only-Authentifizierung genannt, ermöglicht unbeaufsichtigte Skripte und Automatisierung mit Microsoft-Entra-Apps und Zertifikaten.
Die beschriebenen Funktionen setzen bei Exchange Online PowerShell (Connect-ExchangeOnline) die Modulversion 2.0.4 oder neuer und bei Security & Compliance PowerShell (Connect-IPPSSession) die Version 3.0.0 oder neuer voraus. CBA steht auch in Office 365 betrieben von 21Vianet in China zur Verfügung, und REST-API-Verbindungen im V3-Modul benötigen die Module PowerShellGet und PackageManagement, wobei Vorabversionen dieser Module per Get-InstalledModule geprüft werden sollten, falls die Verfahren nicht funktionieren. Nicht nutzbar sind die Verfahren in Exchange Online mit den Microsoft-365-Gruppen-Cmdlets New-UnifiedGroup, Remove-UnifiedGroup, Remove-UnifiedGroupLinks und Add-UnifiedGroupLinks; deren Funktionen lassen sich grösstenteils mit Microsoft Graph ersetzen. Für die Microsoft-Purview-eDiscovery-Cmdlets in Security & Compliance PowerShell (etwa New-ComplianceSearch, Start-ComplianceSearch, New-CaseHoldPolicy) bleibt App-only unterstützt nicht, bestehende Automatisierungen sollen auf Microsoft-Graph-APIs wechseln, und wer die nicht unterstützte Konfiguration weiter nutzt, braucht ExchangeOnlineManagement ab Version 3.10.1, den Schalter EnableSearchOnlySession bei Connect-IPPSSession sowie Dienstprinzipal und eDiscovery-RBAC-Konfiguration, ohne dass sich der Supportstatus ändert. Delegierte Szenarien werden in Exchange Online unterstützt, empfohlen sind GDAP und App Consent, und mandantenübergreifende Anwendungen sind möglich, wenn keine CSP-Beziehung zum Kunden besteht. Tritt beim Verbinden über das Windows PowerShell SDK ein Fehler zu Update-ModuleManifest auf, hilft der Schalter SkipLoadingFormatData bei Connect-ExchangeOnline.
Wie funktioniert es?
Das Exchange-Online-PowerShell-Modul holt mit der Active Directory Authentication Library anhand von Anwendungs-ID, Mandanten-ID (Organisation) und Zertifikat-Fingerabdruck ein App-only-Token. Dem Anwendungsobjekt in Microsoft Entra ID ist eine Verzeichnisrolle zugewiesen, die im Zugriffstoken zurückgegeben wird, und die rollenbasierte Zugriffssteuerung (RBAC) der Sitzung wird anhand dieser Rolleninformation eingerichtet.
Verbindungsbeispiele
Die Beispiele verwenden die AppID 36ee4c6c-0812-40a2-b820-b22ebd02bce3 und die primäre .onmicrosoft.com-Domäne (contosoelectronics.onmicrosoft.com) als Organization-Wert, und sie zeigen drei Zertifikatsvarianten: Fingerabdruck (nur Windows, Zertifikat im Benutzerspeicher), Zertifikatsobjekt (darf remote liegen, wird beim Skriptlauf abgerufen) und lokale PFX-Datei mit Passwort. Bei der lokalen Datei gibt es keinen automatisierten und sicheren Weg, weil ConvertTo-SecureString den Zweck der Absicherung aushebelt und Get-Credential für Automatisierung unpassend ist; die übrigen Optionen entsprechen den Artikeln zu Exchange Online und Security & Compliance PowerShell, und GCC High, DoD und China (21Vianet) brauchen zusätzlich ExchangeEnvironmentName (O365USGovGCCHigh, O365USGovDoD, O365China) sowie bei Connect-IPPSSession ConnectionUri und AzureADAuthorizationEndpointUri. Der Endpunkt mit /organizations lässt nur Geschäfts- oder Schulkonten zu und wird für Unternehmen empfohlen, während der ältere Wert mit /common weiter funktioniert, aber eine Kontenauswahl auslösen kann; erscheint bei Connect-IPPSSession eine Anmeldeaufforderung, hilft vorher $Global:IsWindows = $true, und bestehende eDiscovery-Automatisierungen mit nicht unterstützter Konfiguration brauchen ExchangeOnlineManagement 3.10.1 oder neuer mit dem Schalter EnableSearchOnlySession.
App-only-Authentifizierung einrichten
Für Anwendungsobjekte ist ein einmaliges Onboarding nötig, wobei eine Anwendung einer Klasse und ein Dienstprinzipal einer Instanz davon entspricht; der erste Schritt ist die Registrierung der Anwendung in Microsoft Entra ID (Ablauf unter https://aka.ms/azuread-app). Danach folgen die API-Berechtigungen: Die Anwendung hat standardmässig die delegierte Berechtigung Microsoft Graph > User.Read, dazu kommt die Anwendungsberechtigung Exchange.ManageAsApp unter Office 365 Exchange Online für Connect-ExchangeOnline oder unter Microsoft Exchange Online Protection für Connect-IPPSSession (bei beiden Umgebungen beide), jeweils mit Administratorzustimmung für den ganzen Mandanten. Das Zertifikat darf selbstsigniert sein, und wer es samt privatem Schlüssel besitzt, kann die App mit deren Berechtigungen nutzen; CNG-Zertifikate (unter modernem Windows der Standard) werden nicht unterstützt, es braucht ein Zertifikat eines CSP-Schlüsselanbieters, wofür zwei Methoden folgen, und zuletzt wird das Zertifikat an die Entra-Anwendung angehängt und der Anwendung werden Rollenberechtigungen zugewiesen.
Schritt 1: Die Anwendung in Microsoft Entra ID registrieren
Bei Problemen sind die erforderlichen Berechtigungen zu prüfen, damit das Konto die Identität anlegen kann. Man öffnet das Microsoft Entra Admin Center unter https://portal.azure.com/, sucht nach App registrations und wählt dort New registration (direkter Weg: https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade). Auf der Seite Register an application vergibt man einen aussagekräftigen Namen, etwa ExO PowerShell CBA, und lässt als Kontotyp die Einstellung nur für dieses Organisationsverzeichnis (Single tenant) gewählt. Für mandantenübergreifende, delegierte Exchange-Online-Szenarien wählt man stattdessen Multitenant. Die Redirect URI ist optional: Dann wählt man die Plattform Web und trägt die URI ein, an die das Zugriffstoken gesendet wird. Native Anwendungen sind nicht möglich, weil sie sich nicht für automatisierte Anwendungen eignen. Nach Register öffnet sich die Übersichtsseite der App, die man für den nächsten Schritt offen lässt.
Schritt 2: Der Anwendung API-Berechtigungen zuweisen
Es gibt zwei Methoden, um der App API-Berechtigungen zuzuweisen. Entweder wählt und weist man sie im Portal zu, oder man ändert das App-Manifest. Organisationen mit Microsoft 365 GCC High und DoD müssen die Methode über das Manifest verwenden.
API-Berechtigungen im Portal auswählen und zuweisen
Auf der Übersichtsseite wählt man unter Manage den Punkt API permissions, dann Add a permission und den Reiter APIs my organization uses. Für Exchange Online PowerShell (Connect-ExchangeOnline) wählt man Office 365 Exchange Online, für Security & Compliance PowerShell (Connect-IPPSSession) Microsoft Exchange Online Protection; verbindet sich die App mit beiden Umgebungen, wiederholt man die Schritte 2 bis 5 für die andere API vor Schritt 6. Danach wählt man Application permissions, klappt Exchange auf, markiert Exchange.ManageAsApp und klickt auf Add permissions. In der Liste müssen alle nötigen Einträge Exchange.ManageAsApp den Typ Application und Admin consent required: Yes zeigen, und der Status steht zunächst fälschlich auf Not granted for <Organization>. Den Status ändert man mit Grant admin consent for <Organization> und der Bestätigung Yes, danach lautet er Granted for <Organization>. Beim Standardeintrag Microsoft Graph > User.Read wählt man ... > Revoke admin consent und bestätigt mit Yes, damit der Status wieder leer ist. Zum Schluss schliesst man die Seite API permissions, nicht den Browser-Tab, um zur Seite App registrations zurückzukehren.
Das App-Manifest ändern, um API-Berechtigungen zuzuweisen
Die Schritte ergänzen die vorhandenen Standardberechtigungen der App (delegiertes User.Read in Microsoft Graph) um die Anwendungsberechtigung Exchange.ManageAsApp. Man nutzt die Ressourcenwerte passend zur PowerShell-Verbindung; bei beiden Verbindungen nimmt man beide Exchange-Ressourcenobjekte und ein Microsoft-Graph-Objekt auf. Auf der Übersichtsseite wählt man unter Manage den Punkt Manifest und passt den Eintrag requiredResourceAccess (etwa um Zeile 42) an. Für Exchange Online PowerShell verwendet man resourceAppId 00000002-0000-0ff1-ce00-000000000000 mit der id dc50a0fb-09a3-484d-be87-e023b12c6440 und dem type Role, dazu Microsoft Graph mit resourceAppId 00000003-0000-0000-c000-000000000000, der id e1fe6dd8-ba31-4d61-89e7-88639da4683d und dem type Scope. Für Security & Compliance PowerShell in jeder Umgebung, auch GCC High und DoD, gilt resourceAppId 00000007-0000-0ff1-ce00-000000000000 mit der id 455e5cd2-84e8-4751-8344-5672145dfa17 und dem type Role, ebenfalls mit demselben Graph-Eintrag. Nach Save prüft man unter API permissions Typ Application und Admin consent required: Yes, erteilt die Zustimmung wie zuvor, widerruft sie für Microsoft Graph > User.Read und schliesst die Seite, nicht den Tab.
Schritt 3: Ein Zertifikat erstellen
Zertifikate der Art Cryptography: Next Generation (CNG) funktionieren für die hier beschriebene App-only-Authentifizierung nicht, obwohl moderne Windows-Versionen sie standardmässig erzeugen; man braucht ein Zertifikat eines CSP-Schlüsselanbieters. Zulässig sind ein selbstsigniertes Zertifikat, eines aus einer internen PKI (etwa Active Directory Certificate Services, AD CS) oder eines einer vertrauenswürdigen kommerziellen Zertifizierungsstelle, sofern der private Schlüssel (.pfx) exportierbar und verfügbar ist und das öffentliche Zertifikat (.cer) vorliegt. Für ein selbstsigniertes Zertifikat empfiehlt der Text die Cmdlets New-SelfSignedCertificate, Export-Certificate und Export-PfxCertificate in einer PowerShell-Sitzung mit Administratorrechten (standardmässig SHA1), im Beispiel mit DNS-Name contoso.org, Gültigkeit von 1 Jahr und passwortgeschützter .pfx-Datei; alternativ erzeugt das Skript Create-SelfSignedCertificate SHA1-Zertifikate, im Beispiel für den Zeitraum 2026-01-06 bis 2027-01-06.
Schritt 4: Das Zertifikat an die Microsoft-Entra-Anwendung anhängen
Nach der Registrierung des Zertifikats bei der Anwendung lässt sich die Authentifizierung mit dem privaten Schlüssel (.pfx-Datei) oder dem Fingerabdruck durchführen. Dazu wählt man auf der Registerkarte Owned applications die Anwendung, öffnet unter Manage den Bereich Certificates & secrets, wählt Upload certificate, sucht die in Schritt 3 exportierte .cer-Datei, klickt auf Add und schliesst danach die Seiten, um zum Hauptportal zurückzukehren. Wurde die Anwendung in Schritt 1 für delegierte Exchange-Online-Szenarien mandantenfähig gemacht, muss in jedem Kundenmandanten die Admin-Zustimmung für die Berechtigung Exchange.ManageAsApp erteilt werden, wofür ein Administrator des Kunden vor der ersten Verbindung eine URL mit Mandanten-ID, Client-ID der Anwendung und dem Standardbereich für Anwendungsberechtigungen öffnet.
Schritt 5: Der Anwendung Rollenberechtigungen zuweisen
Option 1 weist der Anwendung integrierte Microsoft-Entra-Rollen zu, die alle Berechtigungen der Rolle gewähren und sich weder anpassen noch eingrenzen lassen. Option 2 weist über Dienstprinzipale benutzerdefinierte Rollengruppen zu und wird empfohlen, wenn die verfügbaren Befehle eingeschränkt werden müssen oder ein Write-Bereich festlegen soll, welche Empfänger änderbar sind. Option 3 kombiniert Entra-Rollen mit benutzerdefinierten Rollengruppen, wobei RBAC die Berechtigungen aller Quellen vereint, etwa um die Rolle Exchange Recipient Administrator zu erweitern; bei mandantenfähigen Anwendungen in delegierten Szenarien müssen die Berechtigungen in jedem Kundenmandanten zugewiesen werden.
Option 1: Der Anwendung Microsoft-Entra-Rollen zuweisen
Unterstützt werden Compliance Administrator, Global Reader und Security Reader für beide PowerShell-Umgebungen, ebenso Global Administrator und Security Administrator. Exchange Administrator und Exchange Recipient Administrator gelten nur für Exchange Online PowerShell, Helpdesk Administrator ebenfalls. Global Administrator und Exchange Administrator decken jede Aufgabe in Exchange Online PowerShell ab, etwa die Empfängerverwaltung sowie Schutzfunktionen wie Anti-Spam, Anti-Malware, Anti-Phishing und die zugehörigen Berichte, die der Security Administrator nicht abdeckt. Microsoft verweist auf das Prinzip der minimalen Rechte und empfiehlt, Global Administrator auf Notfälle oder Fälle ohne Alternative zu beschränken. Im Microsoft Entra Admin Center öffnet man die Seite für Rollen und Administratoren, wählt eine unterstützte Rolle (etwa Exchange Administrator oder Compliance Administrator) und klickt auf Zuweisungen hinzufügen. Dort wählt man die in Schritt 1 erstellte App, bestätigt mit Hinzufügen und prüft die Zuweisung. Für die zweite Umgebung wiederholt man die Schritte.
Option 2: Der Anwendung über Dienstprinzipale benutzerdefinierte Rollengruppen zuweisen
Vor dem Erstellen eines neuen Dienstprinzipals muss man mit Exchange Online PowerShell oder Security & Compliance PowerShell verbunden sein, weil App-ID und Objekt-ID nötig sind. Die benutzerdefinierte Rollengruppe darf beliebige integrierte und eigene Rollen enthalten. In Microsoft Graph PowerShell verbindet man sich mit Connect-MgGraph und den Scopes AppRoleAssignment.ReadWrite.All sowie Application.Read.All und speichert die in Schritt 1 registrierte Anwendung mit Get-MgServicePrincipal in einer Variablen. Danach legt man in der Exchange-Verbindung mit New-ServicePrincipal einen Dienstprinzipal an und speichert ihn mit Get-ServicePrincipal in einer zweiten Variablen. Zum Schluss fügt man den Dienstprinzipal mit Add-RoleGroupMember der benutzerdefinierten Rollengruppe als Mitglied hinzu, etwa über Identity, ObjectId oder Id der Variablen. Das Beispiel nutzt die Gruppe Contoso View-Only Recipients.
«Certificate based authentication (CBA) or app-only authentication as described in this article supports unattended script and automation scenarios by using Microsoft Entra apps and certificates.»
Wörtliches Zitat aus dem Original.
Quelle: learn.microsoft.com, «App-only authentication in Exchange Online PowerShell and Security & Compliance PowerShell». Die Rechte liegen beim Herausgeber. Zusammenfassung und Übersetzung: brauckmann.ch.
Original öffnenMicrosoft Graph permissions reference - Microsoft Graph
«Microsoft Graph exposes granular permissions that control the access that apps have to resources, like users, groups, and mail. As a developer, you decide which permissions for Microsoft Graph your app requests.»
Quelle: learn.microsoft.com, «Microsoft Graph permissions reference - Microsoft Graph». Die Rechte liegen beim Herausgeber.
Original öffnenEin Bauplan ersetzt kein Haus, aber er lässt dich ein zweites bauen, ohne das erste anzufassen. Genau das verspricht Microsoft365DSC für einen Microsoft-365-Tenant: Du exportierst die Konfiguration einmal und spielst sie in einen Test-Tenant ein.
Auf einen Blick
- Microsoft365DSC beschreibt einen Tenant als PowerShell-Code. Das Modul ist Open Source, steht unter MIT-Lizenz und deckt laut PowerShell Gallery über 600 DSC-Ressourcen ab, von Entra ID über Exchange und SharePoint bis Teams und Intune.
- Als Sicherung taugt der Export nur für die Konfiguration. Einstellungen von Entra ID, Exchange, SharePoint, Teams und Intune lassen sich sichern und wiederherstellen. Mails, Dateien und SharePoint-Dokumente sichert das Modul nicht.
- Ein Export enthält keine Werte der Quelle. Tenantspezifische Angaben landen in einer Datei
ConfigurationData.psd1. Für das Ziel änderst du nur diese Datei und kompilierst neu. - Die Voraussetzungen haben sich verschoben. Die aktuelle Dokumentation verlangt PowerShell 7.6. Windows PowerShell 5.1 braucht es nur noch für den Local Configuration Manager.
- Das Werkzeug kann Schaden anrichten. Die Dokumentation sagt selbst, dass falsche Anwendung ernste Folgen haben kann. Teste deshalb nie zuerst im Produktiv-Tenant.
Warum ein Test-Tenant als Code
Änderungen an Richtlinien, Gruppen oder Freigaben gehören zuerst in eine Umgebung, in der ein Fehler nichts kostet. Dasselbe gilt für KI-Szenarien, etwa einen Agenten, der auf SharePoint-Inhalte und Gruppen zugreift. Ein leerer Test-Tenant hilft dabei kaum, weil ihm die Struktur fehlt, die im Betrieb den Unterschied macht.
Dazu kommt ein Zeitproblem. Microsoft schreibt zum Entwickler-Tenant im Developer Program, ein Abonnement laufe bis zu 90 Tage und Tenants könnten alle 90 Tage neu erstellt werden müssen. Wer dort testet, baut seine Umgebung regelmässig neu auf. Von Hand dauert das jedes Mal Stunden. Ein Export als Code verkürzt es auf einen Befehl und macht den Stand nachvollziehbar.
Was Microsoft365DSC ist
Microsoft365DSC ist ein PowerShell-Modul von Microsoft-Entwicklern, gepflegt von der Community. Die Einführung der Dokumentation nennt es die deklarative Form einer Tenant-Konfiguration und vergleicht es mit ARM-Vorlagen für Azure. Das Modul liest einen Tenant aus (Snapshot), wendet eine Konfiguration an, überwacht auf Abweichungen, klont einen Tenant auf einen anderen und vergleicht Konfigurationen. Dazu erzeugt es Berichte als CSV, HTML, Excel, Markdown oder JSON.
Der Stand zum Redaktionsschluss: Version 2.26.1021.1 erschien am 21. Oktober 2026 in der PowerShell Gallery, die Seite zeigt rund 3,3 Millionen Downloads. Ein Hinweis zur Einordnung steht ebenfalls in der Dokumentation: Das Projekt ist Open Source und nicht über die regulären Microsoft-Supportkanäle abgedeckt. Fehler meldest du im GitHub-Repository.
Voraussetzungen, ehrlich genannt
Die Voraussetzungen sind der Teil, an dem die meisten Versuche scheitern. Deshalb hier der Stand aus der Dokumentation vom Oktober 2026, nicht aus älteren Anleitungen.
| Thema | Anforderung laut Dokumentation | Bemerkung |
|---|---|---|
PowerShell |
PowerShell 7.6 oder höher, alle Cmdlets laufen in einer PowerShell-7-Konsole |
Das Modulmanifest nennt weiterhin Mindestversion 5.1 und schränkt die Edition nicht ein |
Windows PowerShell 5.1 |
Nur zum Anwenden und Testen einer kompilierten Konfiguration über den LCM |
Der LCM läuft nur unter Windows PowerShell und reicht jede Ressource an PowerShell 7 weiter |
Betriebssystem |
Windows für den LCM-Weg |
Export, Kompilieren und Vergleich laufen laut Dokumentation direkt in PowerShell 7 |
WinRM |
PowerShell-Remoting aktivieren, zusätzlich in einer erhöhten PowerShell-7-Konsole |
Registriert die Sitzungskonfiguration PowerShell.7 für den Relay des LCM |
Anmeldung |
Benutzer oder Dienstprinzipal, empfohlen ist der Dienstprinzipal |
Eine Anmeldung mit Multi-Faktor ist nur beim Export möglich, nicht beim Anwenden |
Ein Wort zum Widerspruch in der Tabelle: Das Modulmanifest der aktuellen Version nennt PowerShellVersion = '5.1' und schränkt die Edition nicht ein, die Dokumentation verlangt dagegen 7.6. Wo beide abweichen, folgt dieser Artikel der Dokumentation. Prüfe vor dem Start die Seiten „Prerequisites“ und „PowerShell 7+ support“, denn sie ändern sich mit den Versionen.
Installieren und Abhängigkeiten holen
Das Modul kommt aus der PowerShell Gallery. Die Anleitung verlangt eine erhöhte Windows-PowerShell-5.1-Sitzung, weil sonst nur der Benutzerbereich entsteht, den der LCM nicht findet. Danach holst du die Abhängigkeiten, in beiden Editionen.
# Erhöhte Windows-PowerShell-5.1-Sitzung Install-Module Microsoft365DSC -Force Update-M365DSCDependencies # Danach in einer erhöhten PowerShell-7-Konsole Update-M365DSCDependencies Enable-PSRemoting -Force -SkipNetworkProfileCheck
Update-M365DSCDependencies liest die Liste aus Dependencies/Manifest.psd1 im Modul und installiert die festgelegten Versionen. Führe den Befehl nach jedem Update aus. Ein Update des Moduls selbst erledigt Update-M365DSCModule, es entfernt auch ältere Versionen.
Berechtigungen vergeben
Der Export liest, das Einspielen schreibt. Das Modul trennt beides sauber: Get-M365DSCCompiledPermissionList liefert zu einer Liste von Ressourcen die minimalen Lese- und Schreibrechte. Dazu nimmt es für jede Graph-Ressource Organization.Read.All auf, ohne das jede Graph-Komponente mit „Failed to initialize Graph HTTP client“ scheitert.
# Welche Rechte brauchen diese beiden Ressourcen für den Export? Get-M365DSCCompiledPermissionList ` -ResourceNameList @('AADGroup','AADGroupsNamingPolicy') ` -PermissionType 'Application' -AccessType 'Read' # Delegierte Rechte der "Microsoft Graph PowerShell"-App einwilligen (Lesen im Quell-Tenant) Update-M365DSCAllowedGraphScopes ` -ResourceNameList @('AADGroup','AADGroupsNamingPolicy') -Type Read # Vor dem Einspielen im Ziel-Tenant: Schreibrechte Update-M365DSCAllowedGraphScopes ` -ResourceNameList @('AADGroup','AADGroupsNamingPolicy') -Type Update
Die Dokumentation empfiehlt den Dienstprinzipal, weil er die feinsten Rechte erlaubt und keine hoch privilegierten Anmeldedaten über die Leitung schickt. Eine App-Registrierung mit Zertifikat legt Update-M365DSCAzureAdApplication an, samt Admin-Zustimmung und selbstsigniertem Zertifikat. Die Beispiele der Dokumentation zeigen dort Rechte für SharePoint. Die Graph-Rechte deiner Ressourcen holst du aus der Liste oben und trägst sie in der App ein.
Zu beachten: Hochprivilegierte Apps gehören überwacht. Die Dokumentation rät dazu, sie mit Conditional Access auf bestimmte Quellen oder Konten zu beschränken.
Export: gezielt nach Komponenten
Export-M365DSCConfiguration ist der Snapshot-Befehl. Ohne Parameter fragt er nach Anmeldedaten und exportiert die Standardkomponenten. Gezielter geht es mit -Components oder -Workloads. Der Parameter -Mode unterscheidet Default (nur Konfigurationsobjekte) und Full (zusätzlich Datenobjekte). Standardmässig fehlt, was sehr lange dauert oder eher Daten als Einstellungen sind, etwa Planner-Aufgaben oder SPOUserProfileProperty.
Export-M365DSCConfiguration ` -Components @('AADGroup','AADGroupsNamingPolicy') ` -ApplicationId $appId -TenantId 'source.onmicrosoft.com' ` -CertificateThumbprint $thumb -Path C:\Dsc\Source # Nur Gruppen, deren Name mit TST beginnt $Filters = @{ AADGroup = "startsWith(displayName, 'TST')" }
Der Export läuft nach dem Muster: erst die Komponenten sammeln, dann je Workload anmelden, dann auslesen. Wer die Befehle nicht zusammenbauen will, startet mit -LaunchWebUI die Oberfläche unter export.microsoft365dsc.com. Dort wählst du Komponenten aus und kopierst den fertigen Befehl.
Was im Export steht
Der Export legt mehrere Dateien an. Die wichtigsten zwei sind M365TenantConfig.ps1 und ConfigurationData.psd1. Die Dokumentation zum Klonen beschreibt das Ziel so: Die Konfigurationsdatei enthält keine Angaben zum Quell-Tenant und führt alles als Variablen. Erst beim Kompilieren gibst du die Angaben der Zielumgebung mit.
Wichtig ist die Anmeldung. Die Datei übernimmt dieselbe Methode wie der Export: Mit Zertifikat-Fingerabdruck enthält jede Ressource ApplicationId, TenantId und CertificateThumbprint, deren Werte in der ConfigurationData.psd1 stehen. Die Ressourcen heissen in der Datei nach zufälligen GUIDs, die du frei umbenennen darfst, solange kein Name doppelt vorkommt.
# M365TenantConfig.ps1 (gekürzt, schematisch) Configuration M365TenantConfig { param ( ... ) # Anmeldedaten bzw. ApplicationId, TenantId, Zertifikat $OrganizationName = $ConfigurationData.NonNodeData.OrganizationName Import-DscResource -ModuleName 'Microsoft365DSC' -ModuleVersion '<Version>' Node localhost { AADGroup '<GUID>' { DisplayName = '...'; Description = '...'; ... } } }
Ehrlich bleibt der Hinweis der Dokumentation selbst: Das Ziel sei, tenantspezifische Angaben nur in der ConfigurationData.psd1 zu speichern, doch an einigen Stellen stünden sie noch in der M365TenantConfig.ps1. Suche dort nach der Domain der Quelle, bevor du kompilierst. Der Parameter -TokenReplacement ersetzt bestimmte Werte im Export durch Variablen und hilft bei Szenarien über mehrere Tenants.
Kompilieren und im Ziel einspielen
Jetzt folgt die Arbeit am Ziel. Du trägst in der ConfigurationData.psd1 die Daten des Test-Tenants ein, kompilierst die Konfiguration zu einer MOF-Datei und wendest sie an. Die Dokumentation empfiehlt Invoke-M365DSCConfigurationBuild aus PowerShell 7. Es nimmt die ConfigurationData.psd1 neben dem Skript automatisch und bewahrt Eigenschaften mit leerem Array, die ein direkter Aufruf des Skripts in PowerShell 7 weglässt.
Invoke-M365DSCConfigurationBuild -Path C:\Dsc\M365TenantConfig.ps1 # Anwenden (Windows PowerShell 5.1, LCM) Start-DscConfiguration -Path C:\Dsc\M365TenantConfig -Wait -Verbose -Force # Einmalig einspielen, ohne dass der LCM weiter prüft Stop-DscConfiguration -Force Remove-DscConfigurationDocument -Stage Current
Dazu ein Sicherheitshinweis aus dem Kapitel „Securing your Configurations“: Bei Anmeldung mit Benutzername und Kennwort landet das Kennwort standardmässig im Klartext in der MOF-Datei. Mit Set-M365DSCAgentCertificateConfiguration erzeugst du ein Zertifikat, das die Zugangsdaten verschlüsselt. Mit einem Dienstprinzipal und Zertifikat entfällt das Problem.
Das Einspielen kann Minuten bis Stunden dauern, wie die Dokumentation schreibt, und der LCM prüft danach alle 15 Minuten auf Abweichungen. Für ein einmaliges Einspielen entfernst du die Konfiguration wieder, wie oben gezeigt.
Der Ablauf im Überblick
| Schritt | Befehl | Ergebnis | Bemerkung |
|---|---|---|---|
1. Installieren |
Install-Module Microsoft365DSC |
Modul, danach holt Update-M365DSCDependencies die Abhängigkeiten |
In beiden PowerShell-Editionen ausführen |
2. Rechte vergeben |
Get-M365DSCCompiledPermissionList |
Benötigte Rechte, Zustimmung mit Update-M365DSCAllowedGraphScopes |
Lesen im Quell-Tenant, Schreiben im Ziel |
3. Exportieren |
Export-M365DSCConfiguration -Components ... |
Konfigurationsskript und Datei ConfigurationData.psd1 |
Gezielt nach Komponenten oder Workloads |
4. Anpassen |
Datei ConfigurationData.psd1 von Hand ändern |
Werte des Ziel-Tenants |
Skript auf Reste der Quelle prüfen |
5. Kompilieren |
Invoke-M365DSCConfigurationBuild -Path ... |
MOF-Datei im Ordner der Konfiguration |
Prüft Pflichtparameter und Tippfehler |
6. Einspielen |
Start-DscConfiguration -Wait -Verbose -Force |
Ziel-Tenant im Soll-Zustand |
Unter Windows PowerShell 5.1 mit LCM |
7. Vergleichen |
New-M365DSCDeltaReport |
HTML-Bericht der Unterschiede |
Optional vor und nach dem Einspielen |
Vergleichen und Abweichungen erkennen
Der Vergleich ist oft nützlicher als das Einspielen. New-M365DSCDeltaReport nimmt zwei Konfigurationsdateien (-Source, -Destination) und schreibt einen HTML-Bericht mit allen Unterschieden nach -OutputPath. Nach der Dokumentation geht das für zwei Snapshots desselben Tenants zu verschiedenen Zeitpunkten und für zwei verschiedene Tenants, etwa Entwicklung und Produktion.
New-M365DSCDeltaReport ` -Source C:\Dsc\Source\M365TenantConfig.ps1 ` -Destination C:\Dsc\Test\M365TenantConfig.ps1 ` -OutputPath C:\Dsc\Delta.html New-M365DSCReportFromConfiguration -Type 'Markdown' ` -ConfigurationPath C:\Dsc\Source\M365TenantConfig.ps1 ` -OutputPath C:\Dsc\Source-Report.md
Eine laufende Überwachung gibt es ebenfalls. Nach dem Einspielen prüft der LCM alle 15 Minuten, ob die Einstellungen im Tenant noch stimmen, und schreibt Abweichungen ins Ereignisprotokoll M365DSC. Stellst du den Konfigurationsmodus auf ApplyAndAutocorrect, setzt der LCM abweichende Werte selbst zurück. Im Test-Tenant ist das oft gewollt, im Produktiv-Tenant nur nach reiflicher Überlegung.
Wie sich ein Soll-Ist-Vergleich mit eigenen Graph-Skripten anfühlt, zeigt der Artikel zum Conditional-Access-Vergleich über mehrere Tenants. Beide Ansätze ergänzen sich: DSC beschreibt und setzt, ein Skript bewertet.
Die Technik dahinter: DSC, LCM, MOF
Microsoft365DSC setzt auf PowerShell Desired State Configuration auf. Microsoft Learn beschreibt DSC als deklarative Plattform mit drei Bausteinen. Eine Konfiguration legt fest, wie das Ziel aussehen soll. Ressourcen sind der Teil, der den Zustand herstellt und hält. Der Local Configuration Manager (LCM) fragt regelmässig ab, ob der Zustand noch stimmt, und ruft bei Abweichungen die Ressource auf.
Die Konfiguration wird zu einer MOF-Datei kompiliert, einem Format der Management-Welt, das dem LCM als Auftrag dient. Der Vorteil: Du beschreibst das Ergebnis, nicht den Weg. Microsoft Learn nennt DSC-Konfigurationen idempotent. Wendest du dieselbe Konfiguration zweimal an, ändert der zweite Lauf nichts mehr, weil der Zustand schon stimmt. Für Test-Tenants ist das ein Gewinn, denn ein abgebrochener Lauf lässt sich einfach wiederholen.
Praxis: Vorlage für Test-Tenants
Eine gute Vorlage ist klein und gezielt. Sie enthält, was ein Test-Tenant haben muss, damit er sich wie der Produktiv-Tenant verhält. Dazu zählen bei vielen Firmen eine Namenskonvention für Gruppen und eine Beschreibung, die den Zweck jeder Gruppe nennt. Beides lässt sich mit zwei Ressourcen ausliefern: AADGroupsNamingPolicy für die Regel und AADGroup für die Gruppen samt Beschreibung.
Das folgende Beispiel baut auf den Eigenschaften der beiden Ressourcen auf (PrefixSuffixNamingRequirement, CustomBlockedWordsList, DisplayName, MailNickname, Description, SecurityEnabled, MailEnabled). Die Namen und Texte sind frei gewählt und ein Muster, kein Standard.
AADGroupsNamingPolicy 'NamingConvention' { IsSingleInstance = 'Yes' PrefixSuffixNamingRequirement = 'TST_[GroupName]' CustomBlockedWordsList = @('Payroll','CEO') Ensure = 'Present' ApplicationId = $ApplicationId TenantId = $TenantId CertificateThumbprint = $CertificateThumbprint } AADGroup 'TestGroup-Sales' { DisplayName = 'TST_Sales' MailNickname = 'tst-sales' Description = 'Test group for permission tests in sales. Contains test accounts only.' SecurityEnabled = $true MailEnabled = $false Ensure = 'Present' ApplicationId = $ApplicationId TenantId = $TenantId CertificateThumbprint = $CertificateThumbprint }
Dabei gilt laut Microsoft Learn: Die Namensrichtlinie greift für Microsoft-365-Gruppen, die Nutzer anlegen, und sie setzt eine Entra-ID-P1-Lizenz voraus. Globale Administratoren sind ausgenommen. Eine Sicherheitsgruppe wie im Beispiel bekommt die Konvention nur, wenn du den Namen selbst so vergibst.
Ein Muster, das sich bewährt: Eine Vorlage pro Zweck. Eine für Grundstruktur und Gruppen, eine für Sicherheitseinstellungen, eine für SharePoint. Die Dokumentation rät ohnehin, Workloads auf mehrere Konfigurationsdateien zu verteilen, damit sie überschaubar bleiben. Die Cmdlets Join-M365DSCConfiguration und Split-M365DSCConfiguration stehen im Modulmanifest; prüfe ihre Hilfe, bevor du sie einsetzt.
Backup und Restore: was Microsoft365DSC sichert und was nicht
Wer einen Tenant sichern oder wiederherstellen will, landet oft hier. Der Export ist ein Snapshot der Konfiguration. Das Einspielen mit Start-DscConfiguration stellt diese Konfiguration in einem Tenant wieder her, im selben oder in einem anderen. Das gilt für alles, wofür das Modul eine Ressource hat, zum Beispiel Einstellungen und Richtlinien in Entra ID, Exchange, SharePoint, Teams und Intune.
Nicht gesichert werden Inhalte. Postfächer, Dateien und SharePoint-Dokumente liegen ausserhalb der Ressourcen (siehe Grenzen unten). Für sie brauchst du eine echte Datensicherung, etwa Microsoft 365 Backup oder die Lösung eines Drittanbieters. Wie du Inhalte, Postfächer, Teams und Secrets trotzdem selbst holst, zeigt Teil 2 dieser Serie, ein Praxisbericht aus einem Demo-Tenant (in Vorbereitung).
| Was | Mit Microsoft365DSC | Bemerkung |
|---|---|---|
Einstellungen und Richtlinien (Entra ID, Exchange, SharePoint, Teams, Intune) |
Ja |
Export als Code, Einspielen stellt sie wieder her |
Mails, Dateien, SharePoint-Dokumente |
Nein |
Dafür Microsoft 365 Backup oder ein Drittanbieter |
Was keine Ressource im Modul hat |
Nein |
Fehlt im Export, siehe Grenzen |
- 1ExportierenDer Snapshot hält die Konfiguration als Code festExport-Befehl der Dokumentation
- 2AblegenPrüfe die Dateien und lege sie in einem Repository abKeine Secrets einchecken
- 3EinspielenKompilieren und mit Start-DscConfiguration anwendenStellt die Konfiguration wieder her
Beides ergänzt sich: Der Export hält fest, wie der Tenant eingerichtet ist, die Datensicherung hält fest, was darin liegt.
Grenzen, die du kennen solltest
- Nicht alles ist exportierbar. Unterstützt sind die Ressourcen im Modul. Was keine Ressource hat, fehlt im Export.
- Daten sind keine Konfiguration. Der Standardmodus exportiert nur Konfigurationsobjekte. Postfächer, Dateien und Benutzerdaten verschiebt das Modul nicht.
- Lizenzen müssen im Ziel stimmen. Sechs Ressourcen für Defender for Office 365 brauchen laut README Plan 2, etwa
EXOSafeLinksPolicy. Unterstützt sind Microsoft 365 E5, E3 mit Defender-Plan-2-Zusatz und Office 365 E5. Microsoft 365 E3 allein genügt für diese sechs nicht. - Der Entwickler-Tenant ist nur für die Entwicklung gedacht. Die FAQ nennt 25 Lizenzen und schliesst jede andere Nutzung als Entwicklung aus. Für Demos vor Kunden brauchst du einen eigenen Test-Tenant mit passender Lizenz.
- Die Laufzeit kann lang sein. Die Dokumentation spricht von Minuten bis Stunden. Der Parameter
-Parallelbeschleunigt den Export nicht in jedem Fall und braucht laut Dokumentation viel Arbeitsspeicher (empfohlen sind 8 GB oder mehr). - Die Anmeldung ist je Workload verschieden. Nicht jede Workload unterstützt jede Methode, und der Export warnt, wenn Komponenten mit der gewählten Methode nicht erreichbar sind.
- Secrets bleiben ein eigenes Thema. Zertifikate und Kennwörter gehören in einen Tresor. Was der Export zu Secrets enthält, belegt die Dokumentation nicht im Detail. Prüfe jede Exportdatei, bevor du sie in ein Repository legst.
Alternativen kurz eingeordnet
Für einzelne SharePoint-Sites gibt es PnP-Provisioning: Get-PnPSiteTemplate erzeugt aus einer Site eine Vorlage in XML oder als .pnp-Paket, mit Listen, Inhaltstypen, Sicherheit und Branding. Die Dokumentation von PnP PowerShell warnt, dass Vorlagen ohne ihre Abhängigkeiten nicht funktionieren können. Das passt, wenn du eine Site klonen willst, aber nicht den ganzen Tenant.
Graph-Skripte sind die Alternative für Dinge ohne Ressource. Du schreibst sie selbst, bekommst volle Kontrolle und trägst die Pflege allein. Bei vielen Teams liegt der Mittelweg: Microsoft365DSC für die Breite, Skripte für die Lücken und den Soll-Ist-Vergleich. Wer Microsoft-365-Daten für KI-Agenten öffnet, findet im Artikel zum MCP-Server für Microsoft 365 einen Anlass mehr, vorher in einem Test-Tenant zu üben.
Einordnung: Was das für Admins und IT-Dienstleister heisst
Für Admins ist der Gewinn ein reproduzierbarer Test-Tenant: Zugang klären, Vorlage exportieren, kompilieren, einspielen, vergleichen. Das spart nach jeder Neuerstellung des Entwickler-Tenants Stunden und macht Änderungen vorab prüfbar. Dienstleister erhalten eine Grundlage, die sich je Kunde mit anderen Werten einspielen lässt, ohne jedes Mal bei null zu beginnen. Plane den Aufwand ehrlich ein. Die Umstellung auf PowerShell 7.6, die Berechtigungen und die Pflege der Vorlage kosten Zeit, und das Projekt hat keinen regulären Microsoft-Support. Beginne mit zwei Ressourcen, einer Gruppe und einer Namensregel, und baue die Vorlage erst aus, wenn dieser Lauf im Test-Tenant sauber durchgeht.
Fazit
Microsoft365DSC macht aus einem Tenant eine Vorlage, die du exportieren, anpassen, einspielen und vergleichen kannst. Die Hürden liegen bei PowerShell 7.6, den Berechtigungen und der Tatsache, dass nicht jede Einstellung eine Ressource hat. Starte mit einem kleinen Export, prüfe ihn im Test-Tenant und erweitere die Vorlage Schritt für Schritt.
Teil 2 der Serie (in Vorbereitung): Was das Modul nicht sichert, und wie du es trotzdem holst.
Quellen: Microsoft365DSC, Dokumentation, Microsoft365DSC auf GitHub (Prerequisites, PowerShell 7+ support, Deploying, Cloning Tenants), Microsoft365DSC in der PowerShell Gallery, PowerShell DSC bei Microsoft Learn, Microsoft 365 Developer Program FAQ, Gruppen-Namensrichtlinie in Entra ID, Get-PnPSiteTemplate. Foto: Haer_breizh / Pixabay. Zuletzt geprüft: 25. Oktober 2026.
Artikel öffnenGeschrieben von Andreas Brauckmann · So arbeitet die Redaktion
Änderungshistorie
- — Interner Entwurf, noch nicht veröffentlicht: Teil 2 der Serie, Inhalte, Postfächer, Teams und Secrets eines Demo-Tenants sichern.