Purview-Skript

Automatisierte Version von Fehlerbehebung bei Purview-Aktivierungsfehlern und -Verzögerungen. Es verbindet sich mit Exchange Online, erzwingt ein Deaktivieren und anschließendes erneutes Aktivieren der Auditprotokollaufnahme und bestätigt das Ergebnis. Wenn der Mandant dehydriert ist, führt es Enable-OrganizationCustomization, wartet, bis es abgeschlossen ist, und aktiviert dann die Auditprotokollierung erneut. Wenn die Aktivierung tatsächlich verweigert wird, gibt es eine Diagnose aus (Kontorollen, Mandantenhydration, Lizenz- und Abonnementstatus).

Repair-PurviewAuditLogging.ps1

17KB

Öffnen

Führen Sie es aus in Windows PowerShell oder Azure Cloud Shell (PowerShell-Modus). Es verweigert die Ausführung unter macOS/Linux, wo das Exchange-Online-Modul bei Schreibvorgängen fehlschlägt.

Kein Windows-Rechner? Wenn der Mandant ein aktives Azure-Abonnement hat, führen Sie es aus in Azure Cloud Shell im PowerShell-Modus: Laden Sie das Skript hoch und führen Sie es aus ohne -AdminUpn. Cloud Shell verwendet Ihre Sitzung erneut, daher erscheint keine Anmeldeaufforderung. Purview selbst erfordert kein Azure-Abonnement.

Führen Sie es aus

1

Skript herunterladen

Herunterladen Repair-PurviewAuditLogging.ps1 über den obigen Link.

2

Skriptausführung zulassen

Führen Sie dies in PowerShell einmal pro Fenster aus (nur für die Sitzung, nichts Dauerhaftes):

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

3

Führen Sie es mit dem Administratorkonto aus

Ersetzen Sie <[e-mail]> durch einen Mandantenadministrator. Ein Browser-Anmeldefenster wird geöffnet; das Skript erledigt den Rest.

cd C:\path\to\the\folder
.\Repair-PurviewAuditLogging.ps1 -AdminUpn <[e-mail]>

4

Später überprüfen

Falsch direkt nach der Ausführung ist normal: Microsoft wendet es innerhalb weniger Minuten an (bis zu etwa 60 Min.). Stellen Sie die Verbindung erneut her, um zu überprüfen:

Connect-ExchangeOnline -UserPrincipalName <[e-mail]> -ShowBanner:$false
Get-AdminAuditLogConfig | Format-List UnifiedAuditLogIngestionEnabled

Wahr bedeutet, dass es abgeschlossen ist.

Wenn es fehlschlägt

Das Skript führt eine Diagnose aus und teilt Ihnen mit, in welchem Fall Sie sich befinden. Senden Sie die .log von ihm erstellte Datei an [e-mail].

• Dehydrierter Mandant: wird automatisch behandelt. Das Skript führt Enable-OrganizationCustomization, wartet auf die Hydrierung und aktiviert dann die Auditprotokollierung erneut.

• 403 Verboten / verweigert: eine echte Ablehnung. Dem Konto fehlt die richtige Rolle (die Auditprotokolle Rolle, gewährt über Organization Management oder Compliance Management), oder der Mandant hat keine Lizenz, die Exchange Online umfasst.

• Serverseitiger Fehler: ein vorübergehendes „Versuchen Sie es später erneut“ von Microsoft. Das Skript versucht es bereits erneut; wenn es weiterhin besteht, führen Sie es einige Minuten später erneut aus.