Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Analizzare errori di connessione di Zero Trust Assessment, controlli ignorati, esecuzioni lente, conflitti di dipendenza e problemi di segnalazione. Iniziare con la fase interessata, quindi raccogliere la diagnostica se i controlli specifici dei sintomi non risolvono il problema. Mantenere la sessione di PowerShell o i dati diagnostici disponibili per l'indagine.
Prima di iniziare, raccogliere le versioni di valutazione e PowerShell, l'ambito di esecuzione e il riepilogo degli errori. Per le informazioni necessarie, vedere Prerequisiti.
Prerequisites
- Sessione di PowerShell per la valutazione, se ancora disponibile, o la relativa diagnostica generata.
- Le versioni di valutazione e PowerShell, gli ID dei pilastri e dei test selezionati, la fase interessata e il riepilogo degli errori.
Elenco di controllo per la risoluzione dei problemi
Identificare la fase del guasto prima di modificare autorizzazioni, dipendenze o timeout.
Identificare la fase interessata
Identificare la fase di valutazione non riuscita in modo da poter selezionare la diagnostica pertinente.
- Esaminare i messaggi di connessione e i file di diagnostica per esecuzione per identificare se il problema si verifica durante la connessione, l'esportazione, la creazione del database, i test o l'elaborazione di report.
- Registrare la versione di valutazione, la versione di PowerShell, gli ID pilastro e gli ID test selezionati e un riepilogo degli errori sanificati.
- Mantenere le esportazioni completate e il database se è possibile usare resume.
Controllare l'accesso e la copertura
Usare la tabella dei sintomi per selezionare il controllo successivo. Una connessione Microsoft Graph riuscita non configura automaticamente tutti gli altri servizi e un controllo ignorato non costituisce prova di una configurazione sicura.
| Sintomo | Controlli da eseguire |
|---|---|
| Il consenso di Graph o la convalida del ruolo non riesce. | Confrontare le autorizzazioni con Get-ZtGraphScope, attivare il ruolo utente richiesto o configurare le autorizzazioni dell'app e riconnettersi. Un nuovo pacchetto può richiedere un consenso aggiuntivo. |
| Un servizio non riesce a connettersi o i test vengono ignorati. | Controllare il ruolo, la licenza, la piattaforma e il messaggio di connessione del servizio. Vedi le linee guida per la connessione. |
| Un controllo di protezione, di etichetta, di prevenzione della perdita dei dati (DLP) o di ricerca restituisce un errore di autorizzazione. | Controllare le assegnazioni di ruolo del carico di lavoro e gli ambiti dati per il comando o l'API, non solo Microsoft Entra ID nomi di ruolo. Usare le tabelle di accesso. |
| L'infrastruttura non presenta problemi rilevati. | Verificare l'accesso in lettura ad Azure e i tag della sottoscrizione. L'assenza di sottoscrizioni contrassegnate/accessibili non corrisponde a una valutazione superata. |
| Il tempo di esecuzione è lungo, le richieste vengono sottoposte a throttling o aumenta la pressione della memoria. | Esaminare i log dell'agente di raccolta e dei test. Esaminare lookback, concorrenza, cache e timeout nelle impostazioni di configurazione. |
| Una connessione basata su certificato non riesce. | Controllare la validità del certificato/chiave privata, la registrazione della chiave pubblica dell'app, il GUID del tenant, il consenso e i ruoli dell'entità servizio. SharePoint richiede anche una chiave esportabile nel connettore corrente. |
| La modalità linguaggio vincolato impedisce l'esecuzione. | Usare un host/criteri approvati che supportino la valutazione. Non ignorare i controlli dell'organizzazione; l'override avanzato non consente di eseguire operazioni limitate. |
Cause e soluzioni
Utilizzare le procedure seguenti per le dipendenze e gli errori di report. Controllare la versione interessata prima di scegliere una soluzione alternativa.
Risolvere i conflitti di graph assembly
Per Could not load file or assembly Microsoft.Graph.Authentication, iniziare con un processo pulito invece di rimuovere moduli condivisi.
- Avviare un nuovo
pwsh -NoProfileprocesso. - Consentire alla valutazione di caricare le dipendenze bloccate prima di altri moduli cloud.
- Controllare la cache delle dipendenze e le indicazioni per l'host pulito se il problema persiste.
Un altro modulo installato non è automaticamente un conflitto, ma gli assembly già caricati possono essere incompatibili. La rimozione o la reimportazione di un modulo non scarica in modo affidabile gli assembly. Evitare la rimozione indiscriminata di moduli Graph condivisi e script di pulizia di terze parti come rimedio predefinito.
Risolvere gli errori di inizializzazione di DuckDB
L'errore The type initializer for 'DuckDB.NET.Data.DuckDBConnectionStringBuilder' threw an exception può avere diverse cause alla base.
- Esaminare l'eccezione interna. In Windows, un errore
DllNotFoundExceptionperduckdbpuò indicare una dipendenza nativa mancante. - Se mancante, installare il Microsoft Visual C++ Redistributable (x64).
- Riprovare in una nuova sessione di PowerShell. Non presupporre che ogni errore del database abbia la stessa causa.
Ripristino da errori di rendering del report
I report meno recenti potrebbero mostrare Unexpected Application Error! Invalid array length. I report correlati includono microsoft/zerotrustassessment#1235, microsoft/zerotrustassessment#1272, microsoft/zerotrustassessment#1310 e microsoft/zerotrustassessment#1388.
- Controllare il problema e la cronologia delle versioni per la propria versione. Non presupporre che sia sempre necessaria una versione preliminare.
- Se le esportazioni e la creazione del database sono completate, conservarle.
- Dopo aver installato una correzione applicabile, riconnettersi e usare
-Resumecon il percorso originale e il pilastro per eseguire di nuovo l'elaborazione della valutazione e del report. - Usare il report HTML classico se è stato generato correttamente.
Esaminare l'attività di valutazione
Esaminare il codice sorgente PowerShell, il dashboard di stato e i log per esecuzione per comprendere l'attività della valutazione. La guida principale alla risoluzione dei problemi avanzata illustra l'analisi del pacchetto di supporto.
Risoluzione dei problemi avanzata e raccolta dati
Strumenti diagnostici diversi acquisiscono fasi diverse. Scegliere la posizione corrispondente all'errore prima di raccogliere o condividere i dati.
Log e file di diagnostica
<Path> è la directory passata a Invoke-ZtAssessment -Patho .\ZeroTrustReport per impostazione predefinita. Il pacchetto di supporto facoltativo, i file per esecuzione e i log PSFramework estesi sono tre percorsi di diagnostica separati.
| Luogo | Contenuto e utilizzo |
|---|---|
<Path>\log\ |
File ZIP del pacchetto di supporto PSFramework creato da -ExportLog in prossimità del completamento corretto, contenente un’istantanea .cliDat. Può essere assente se l'opzione non è stata usata o l'esecuzione non è riuscita prima di questa fase. |
<Path>\zt-export\logs\<run>\1-export_progress.log |
Stato e avanzamento del collector di esportazione. Iniziare da qui per i problemi di raccolta dati. |
<Path>\zt-export\logs\<run>\2-database_progress.log |
Avanzamento e tempistiche della compilazione del database. Riprendi ignora questa fase. |
<Path>\zt-export\logs\<run>\3-test_progress.log |
Avanzamento e stato dell'esecuzione della valutazione. |
<Path>\zt-export\logs\<run>\1-Export\export_<Name>.md |
Stato dell'agente di raccolta, durata, timestamp, endpoint/tipo, versione del modulo e messaggi di diagnostica. |
<Path>\zt-export\logs\<run>\2-Tests\<TestID>.md |
Titolo, stato, durata, timestamp, versione del modulo e messaggi dettagliati, potenzialmente incluso il testo della query. |
%APPDATA%\PowerShell\PSFramework\Logs\su Windows |
Log dei messaggi estesi e record di errore XML, indipendentemente dal percorso di output. Utile per problemi di connessione/importazione, eccezioni, posizioni di origine, analisi dello stack e messaggi esterni a singoli test. |
<run> usa il formato timestamp yy-MM-dd-HHmmss. I file vengono visualizzati durante l'esecuzione delle fasi; un'esecuzione parziale o ripresa non necessariamente contiene tutti i file. I file per esecuzione vengono generati indipendentemente da -ExportLog.
I file PSFramework estesi includono identificatori computer/processo e segmenti numerati, ad esempio <computer>_<pid>_message_0.log e <computer>_<pid>_error_0.xml. La disponibilità e la conservazione dipendono dalla configurazione del provider di registrazione.
In Windows %APPDATA% identifica la cartella Roaming dell'utente, in genere %USERPROFILE%\AppData\Roaming. In PowerShell usare $env:APPDATA. Il percorso del log equivalente è Join-Path $env:APPDATA 'PowerShell\PSFramework\Logs'.
Il resto di <Path>\zt-export sono dati di valutazione, non solo i log: entità esportate, ztConfig.json, ZeroTrustAssessmentReport.json, db\zt.db e ZeroTrustWorkshop.json. Questi file possono essere utili per riprodurre o riprendere un'esecuzione, ma possono contenere dati del tenant sensibili. L'eliminazione di <Path> non rimuove i log PSFramework separati.
Acquisire un pacchetto di supporto
Se un'esecuzione ha esito negativo prima di creare un pacchetto di supporto facoltativo, acquisire la diagnostica nella stessa sessione di PowerShell prima di chiuderla.
Scegliere una destinazione separata per il pacchetto di diagnostica. Non è necessario che corrisponda al percorso di output della valutazione. Sostituire la destinazione di esempio con una cartella per l'esecuzione:
New-PSFSupportPackage -Path C:\AssessmentLogs\Run01 -ForceEstrarre il file ZIP generato per accedere al file
.cliDat.Esaminare e rimuovere i dati sensibili dalla diagnostica prima di condividerla. Per l'importazione e l'analisi dello snapshot, vedere la guida all'analisi avanzata dei log.
Un'istantanea di un pacchetto di supporto acquisisce i dati diagnostici della sessione disponibili, inclusi la cronologia dei messaggi e degli errori ed eventualmente la cronologia dei comandi o l'output della console. Non è un archivio automatico di tutti i file tenant esportati.
Warning
I report, le esportazioni, i pacchetti di supporto e i log estesi possono contenere informazioni personali, identificatori tenant, valori di query e dettagli di configurazione. Non allegarli mai, senza averli prima esaminati, a issue pubbliche su GitHub e non caricarli in uno strumento non approvato. Condividi diagnostica aggiuntiva solo tramite un canale privato approvato concordato con il destinatario.
Segnala un problema o invia feedback
Cercare o segnalare issue su GitHub o usare il canale di feedback. Includere la versione di valutazione, la versione di PowerShell, gli ID del pilastro e dei test selezionati, la fase interessata e un riepilogo degli errori sanificati.
La valutazione è un progetto della community, non un prodotto Microsoft ufficiale. La segnalazione dei problemi della community non è un contratto di supporto o una garanzia di risposta. Leggere i criteri di supporto prima di condividere la diagnostica.