Problembehandlung bei der Zero Trust-Bewertung

Untersuchen Sie Verbindungsfehler, übersprungene Prüfungen, langsame Ausführungen, Abhängigkeitskonflikte und Probleme mit Berichten bei Zero Trust Assessment. Beginnen Sie mit der betroffenen Phase, und sammeln Sie anschließend Diagnosedaten, wenn die symptomspezifischen Prüfungen das Problem nicht beheben. Behalten Sie die PowerShell-Sitzung oder die verfügbaren Diagnosedaten für Ihre Untersuchung bei.

Bevor Sie beginnen, sammeln Sie Ihre Einschätzungen- und PowerShell-Versionen, den Ausführungsbereich und die Fehlerzusammenfassung. Die benötigten Informationen finden Sie unter Voraussetzungen.

Prerequisites

  • Die PowerShell-Bewertungssitzung, falls noch verfügbar, oder die generierte Diagnose.
  • Die Bewertungs- und PowerShell-Versionen, ausgewählte Säulen- und Test-IDs, betroffene Phase und Fehlerzusammenfassung.

Checkliste zur Problembehandlung

Identifizieren Sie die Fehlerphase, bevor Sie Berechtigungen, Abhängigkeiten oder Timeouts ändern.

Betroffene Phase identifizieren

Ermitteln Sie, welche Bewertungsphase fehlgeschlagen ist, damit Sie die relevanten Diagnoseinformationen auswählen können.

  1. Überprüfen Sie Verbindungsmeldungen und die Diagnosedateien pro Ausführung, um festzustellen, ob das Problem während der Verbindung, des Exports, der Datenbankerstellung, der Tests oder der Berichtsverarbeitung auftritt.
  2. Zeichnen Sie die Bewertungsversion, PowerShell-Version, ausgewählte Säulen- und Test-IDs und eine bereinigte Fehlerzusammenfassung auf.
  3. Bewahren Sie abgeschlossene Exporte und die Datenbank auf, wenn Sie fortsetzen verwenden könnten.

Überprüfen des Zugriffs und der Abdeckung

Verwenden Sie die Symptomtabelle, um die nächste Prüfung auszuwählen. Eine erfolgreiche Microsoft Graph Verbindung richtet nicht automatisch alle anderen Dienste ein, und eine übersprungene Überprüfung ist kein Beweis für eine sichere Konfiguration.

Symptom Was soll überprüft werden?
Die Graph-Zustimmung oder Rollenüberprüfung schlägt fehl. Vergleichen Sie Berechtigungen mit Get-ZtGraphScope, aktivieren Sie die erforderliche Benutzerrolle oder konfigurieren Sie App-Berechtigungen, und stellen Sie die Verbindung erneut her. Ein neues Paket kann zusätzliche Zustimmung erfordern.
Ein Dienst kann keine Verbindung herstellen oder Tests werden übersprungen. Überprüfen Sie die Rolle, Lizenz, Plattform und Verbindungsmeldung des Diensts. Siehe Verbindungsleitfaden.
Eine Schutz-, Bezeichnungs-, DLP- oder Hunting-Überprüfung führt zu einem Autorisierungsfehler. Überprüfen Sie Rollenzuweisungen für Workloads und Datenbereiche für den Befehl oder die API, nicht nur Microsoft Entra ID-Rollennamen. Verwenden Sie die Zugriffstabellen.
Infrastruktur hat keine Befunde. Überprüfen Sie Azure-Lesezugriff und Abonnementtags. Keine markierten/zugänglichen Abonnements gelten nicht als bestandene Einschätzung.
Die Laufzeit ist lang, Anfragen werden gedrosselt oder der Speicherdruck steigt. Überprüfen Sie Collector- und Testprotokolle. Überprüfen Sie Lookback, Parallelität, Caches und Timeouts in Konfigurationseinstellungen.
Eine Zertifikatverbindung schlägt fehl. Überprüfen Sie die Gültigkeit des Zertifikats/privaten Schlüssels, die Registrierung des öffentlichen App-Schlüssels, die Mandanten-GUID, die Zustimmung und die Rollen des Dienstprinzipals. SharePoint benötigt auch einen exportierbaren Schlüssel im aktuellen Connector.
Der eingeschränkte Sprachmodus verhindert die Ausführung. Verwenden Sie einen genehmigten Host/eine genehmigte Richtlinie, die die Bewertung unterstützt. Umgehen Sie keine organisatorischen Kontrollen; die erweiterte Override-Funktion führt nicht dazu, dass eingeschränkte Vorgänge funktionieren.

Ursachen und Lösungen

Verwenden Sie die folgenden Verfahren für Abhängigkeits- und Berichtsfehler. Überprüfen Sie die betroffene Version, bevor Sie eine Problemumgehung auswählen.

Beheben von Graph-Assemblykonflikten

Für Could not load file or assembly Microsoft.Graph.Authentication beginnen Sie mit einem sauberen Prozess, anstatt gemeinsam genutzte Module zu entfernen.

  1. Starten Sie einen neuen pwsh -NoProfile Prozess.
  2. Lassen Sie die Bewertung ihre angehefteten Abhängigkeiten vor anderen Cloudmodulen laden.
  3. Überprüfen Sie den Abhängigkeitscache und den Clean-Host-Leitfaden , wenn das Problem weiterhin besteht.

Ein weiteres installiertes Modul ist nicht automatisch ein Konflikt, aber bereits geladene Assemblys können inkompatibel sein. Durch das Entfernen oder erneute Importieren eines Moduls werden Assemblys nicht zuverlässig entladen. Vermeiden Sie die pauschale Entfernung von freigegebenen Graph-Modulen und Bereinigungsskripts von Drittanbietern als Standardmaßnahme.

Beheben von DuckDB-Initialisierungsfehlern

Der Fehler The type initializer for 'DuckDB.NET.Data.DuckDBConnectionStringBuilder' threw an exception kann unterschiedliche zugrunde liegende Ursachen haben.

  1. Untersuchen Sie die innere Ausnahme. Bei Windows kann ein DllNotFoundException für duckdb auf eine fehlende systemeigene Abhängigkeit hinweisen.
  2. Falls nicht vorhanden, installieren Sie die Microsoft Visual C++ Redistributable (x64).
  3. Wiederholen Sie den Vorgang in einer neuen PowerShell-Sitzung. Gehen Sie nicht davon aus, dass jeder Datenbankfehler die gleiche Ursache hat.

Von Bericht-Renderingfehlern wiederherstellen

Ältere Berichte könnten Unexpected Application Error! Invalid array length anzeigen. Verwandte Berichte umfassen microsoft/zerotrustassessment#1235, microsoft/zerotrustassessment#1272, microsoft/zerotrustassessment#1310 und microsoft/zerotrustassessment#1388.

  1. Überprüfen Sie das Problem und die Versionsgeschichte für Ihre Version. Gehen Sie nicht davon aus, dass eine Vorabversion immer erforderlich ist.
  2. Wenn die Exporte und die Datenbankerstellung abgeschlossen sind, bewahren Sie sie auf.
  3. Nach der Installation eines anwendbaren Fixes stellen Sie erneut eine Verbindung her und verwenden Sie -Resume mit dem ursprünglichen Pfad und der ursprünglichen Säule, um die Bewertungs- und Berichtsverarbeitung erneut zu starten.
  4. Verwenden Sie den klassischen HTML-Bericht, wenn er erfolgreich generiert wurde.

Bewertungsaktivität überprüfen

Überprüfen Sie die PowerShell-Quelle, das Fortschrittsdashboard und die Protokolle pro Durchlauf, um die Aktivität der Auswertung zu verstehen. Der übergeordnete Leitfaden für erweiterte Problembehandlung umfasst supportpaketbasierte Analysen.

Erweiterte Problembehandlung und Datensammlung

Verschiedene Diagnoseaufzeichnungen erfassen unterschiedliche Phasen. Wählen Sie den Speicherort aus, der dem Fehler entspricht, bevor Daten gesammelt oder freigegeben werden.

Protokolle und Diagnosedateien

<Path> ist das Verzeichnis, das Sie an Invoke-ZtAssessment -Path übergeben, oder standardmäßig .\ZeroTrustReport. Das optionale Supportpaket, Dateien pro Ausführung und erweiterte PSFramework-Protokolle sind drei separate Diagnoseorte.

Speicherort Inhalt und Verwendung
<Path>\log\ Ein von -ExportLog kurz vor erfolgreichem Abschluss erstelltes PSFramework-Unterstützungspaket im ZIP-Format, das eine .cliDat-Momentaufnahme enthält. Es kann nicht vorhanden sein, wenn der Schalter nicht verwendet wurde oder die Ausführung vor dieser Phase fehlgeschlagen ist.
<Path>\zt-export\logs\<run>\1-export_progress.log Fortschritt und Status des Collectors exportieren. Beginnen Sie hier bei Problemen mit der Datenerfassung.
<Path>\zt-export\logs\<run>\2-database_progress.log Fortschritt und Zeitangaben des Datenbankbuilds. Fortsetzen überspringt diese Phase.
<Path>\zt-export\logs\<run>\3-test_progress.log Bewertung des Ausführungsfortschritts und des Status.
<Path>\zt-export\logs\<run>\1-Export\export_<Name>.md Sammelstatus, Dauer, Zeitstempel, Endpunkt/Typ, Modulversion und Diagnosemeldungen.
<Path>\zt-export\logs\<run>\2-Tests\<TestID>.md Testtitel, Status, Dauer, Zeitstempel, Modulversion und detaillierte Nachrichten, einschließlich Abfragetext.
%APPDATA%\PowerShell\PSFramework\Logs\auf Windows Erweiterte Nachrichtenprotokolle und XML-Fehlereinträge, unabhängig vom Ausgabepfad. Nützlich für Verbindungs-/Importprobleme, Ausnahmen, Quellspeicherorte, Stack-Traces und Nachrichten außerhalb einzelner Tests.

<run> verwendet das Zeitstempelformat yy-MM-dd-HHmmss. Dateien werden während der Ausführung ihrer Phasen angezeigt; Eine teilweise oder fortgesetzte Ausführung muss nicht jede Datei enthalten. Dateien pro Ausführung werden unabhängig von -ExportLog generiert.

Erweiterte PSFramework-Dateien umfassen Computer-/Prozess-IDs und nummerierte Segmente, wie z. B. <computer>_<pid>_message_0.log und <computer>_<pid>_error_0.xml. Verfügbarkeit und Aufbewahrung hängen von der Konfiguration des Protokollierungsanbieters ab.

Unter Windows bezeichnet %APPDATA% normalerweise den Roamingordner des Benutzers, %USERPROFILE%\AppData\Roaming. Verwenden Sie $env:APPDATAin PowerShell ; der entsprechende Protokollpfad ist Join-Path $env:APPDATA 'PowerShell\PSFramework\Logs'.

Der Rest von <Path>\zt-export sind Bewertungsdaten, nicht nur Protokolle: exportierte Entitäten, ztConfig.json, db\zt.db, ZeroTrustAssessmentReport.json und ZeroTrustWorkshop.json. Diese Dateien können beim Reproduzieren oder Fortsetzen einer Ausführung helfen, aber können vertrauliche Mandantendaten enthalten. Das Löschen von <Path> entfernt keine separaten PSFramework-Protokolle.

Erfassen eines Supportpakets

Wenn eine Ausführung fehlschlägt, bevor dabei ein optionales Supportpaket erstellt werden kann, erfassen Sie die Diagnose in derselben PowerShell-Sitzung, bevor Sie sie schließen.

  1. Wählen Sie ein separates Ziel für das Diagnosepaket aus. Es muss nicht mit dem Ausgabepfad der Bewertung übereinstimmen. Ersetzen Sie das Beispielziel durch einen Ordner für Ihre Ausführung:

    New-PSFSupportPackage -Path C:\AssessmentLogs\Run01 -Force
    
  2. Extrahieren Sie die generierte ZIP-Datei, um auf ihre .cliDat Datei zuzugreifen.

  3. Überprüfen und redigieren Sie die Diagnose vor der Freigabe. Informationen zum Importieren und Untersuchen der Momentaufnahme finden Sie im Leitfaden zur erweiterten Protokollanalyse.

Ein Support-Paket erfasst verfügbare Sitzungsdiagnosen, einschließlich Meldungs- und Fehlerverlauf und potenziell Befehlsverlauf oder Konsolenausgabe. Es handelt sich nicht um ein automatisches Archiv aller exportierten Mandantendateien.

Warning

Berichte, Exporte, Supportpakete und erweiterte Protokolle können persönliche Informationen, Mandanten-IDs, Abfragewerte und Konfigurationsdetails enthalten. Fügen Sie sie niemals an öffentliche GitHub Probleme an, oder laden Sie sie in ein nicht genehmigtes Tool hoch. Teilen Sie zusätzliche Diagnosedaten nur über einen genehmigten privaten Kanal, der mit dem Empfänger abgestimmt wurde.

Problem melden oder Feedback geben

Suchen oder archivieren Sie GitHub-Probleme oder verwenden Sie den Feedbackkanal. Schließen Sie die Bewertungsversion, PowerShell-Version, ausgewählte Säulen- und Test-IDs, die betroffene Phase und eine bereinigte Fehlerzusammenfassung mit ein.

Die Bewertung ist ein Communityprojekt, kein offizielles Microsoft Produkt. Das Melden von Problemen in der Community ist weder ein Supportvertrag noch eine Garantie für eine Antwort. Lesen Sie die Supportrichtlinie, bevor Sie Diagnosedaten freigeben.