Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Investigue falhas de conexão da Avaliação do Confiança Zero, verificações ignoradas, execuções lentas, conflitos de dependência e problemas de relatório. Comece com o estágio afetado e colete o diagnóstico se as verificações específicas do sintoma não resolverem o problema. Mantenha a sessão do PowerShell ou o diagnóstico disponível para sua investigação.
Antes de começar, reúna as informações da avaliação e versões do PowerShell, escopo de execução e resumo de erros. Consulte Prerrequisitos para obter as informações necessárias.
Prerequisites
- A sessão do PowerShell de avaliação, se ainda estiver disponível, ou seu diagnóstico gerado.
- As versões de avaliação e do PowerShell, IDs de pilar e teste selecionadas, estágio afetado e resumo de erros.
Lista de verificação de solução de problemas
Identifique o estágio de falha antes de alterar permissões, dependências ou tempos limite.
Identificar o estágio afetado
Identifique qual estágio de avaliação falhou para que você possa selecionar os diagnósticos relevantes.
- Examine as mensagens de conexão e os arquivos de diagnóstico por execução para identificar se o problema ocorre durante a conexão, exportação, criação de banco de dados, testes ou processamento de relatório.
- Registre a versão da avaliação, a versão do PowerShell, as IDs de pilar e de teste selecionadas e um resumo de erros higienizado.
- Preserve as exportações concluídas e o banco de dados se você puder usar resume.
Verificar o acesso e a cobertura
Use a tabela de sintomas para selecionar a próxima verificação. Uma conexão de Microsoft Graph bem-sucedida não estabelece todos os outros serviços e uma verificação ignorada não é evidência de uma configuração segura.
| Sintoma | O que verificar |
|---|---|
| Falha no consentimento do Graph ou na validação de perfil. | Compare as concessões com Get-ZtGraphScope, ative a função de usuário necessária ou configure permissões de aplicativo e reconecte. Um novo pacote pode exigir consentimento adicional. |
| Um serviço falha ao se conectar ou os testes são ignorados. | Verifique a função, a licença, a plataforma e a mensagem de conexão do serviço. Consulte as diretrizes de conexão. |
| Uma proteção, rótulo, prevenção contra perda de dados (DLP) ou verificação de busca retorna um erro de autorização. | Verifique as atribuições de função de carga de trabalho e os escopos de dados do comando ou da API, não apenas Microsoft Entra ID nomes de função. Use as tabelas de acesso. |
| A infraestrutura não apresenta achados. | Verifique o acesso de leitura do Azure e tags de assinatura. Nenhuma assinatura marcada/acessível é uma avaliação aprovada. |
| O tempo de execução é longo, as solicitações são limitadas ou a pressão de memória aumenta. | Inspecione os logs de coletor e de teste. Examine a janela retroativa, a concorrência, os caches e os tempos limite nas configurações. |
| Uma conexão com certificado falha. | Verifique a validade do certificado/chave privada, o registro de chave pública do aplicativo, o GUID do locatário, o consentimento e as funções de entidade de serviço. SharePoint também precisa de uma chave exportável no conector atual. |
| O Modo de Idioma Restrito impede a execução. | Use um host ou política aprovados que deem suporte à avaliação. Não ignore os controles organizacionais; a sobrescrita avançada não faz com que as operações restritas funcionem. |
Causas e soluções
Use os procedimentos a seguir para erros de dependência e de relatório. Verifique a versão afetada antes de escolher uma solução alternativa.
Resolver conflitos de assembly do Graph
Para Could not load file or assembly Microsoft.Graph.Authentication, comece com um processo limpo em vez de remover módulos compartilhados.
- Inicie um novo processo
pwsh -NoProfile. - Deixe que a avaliação carregue suas dependências fixadas antes de outros módulos de nuvem.
- Verifique o cache de dependência e as diretrizes de host limpo se o problema persistir.
Outro módulo instalado não é automaticamente um conflito, mas assemblies já carregados podem ser incompatíveis. Remover ou reimportar um módulo não descarrega os assemblies de forma confiável. Evite a remoção geral de módulos compartilhados do Graph e scripts de limpeza de terceiros como o remédio padrão.
Resolva erros de inicialização do DuckDB
O erro The type initializer for 'DuckDB.NET.Data.DuckDBConnectionStringBuilder' threw an exception pode ter diferentes causas subjacentes.
- Inspecione a exceção interna. Em Windows, um
DllNotFoundExceptionforduckdbpode indicar uma dependência nativa ausente. - Se estiver ausente, instale o Microsoft Visual C++ Redistribuível (x64).
- Tente novamente em uma nova sessão do PowerShell. Não suponha que cada erro de banco de dados tenha a mesma causa.
Recuperar-se de erros de renderização de relatórios
Relatórios mais antigos podem mostrar Unexpected Application Error! Invalid array length. Os relatórios relacionados incluem microsoft/zerotrustassessment#1235, microsoft/zerotrustassessment#1272, microsoft/zerotrustassessment#1310 e microsoft/zerotrustassessment#1388.
- Verifique o problema e o histórico de lançamento da sua versão. Não suponha que um pré-lançamento seja sempre necessário.
- Se as exportações e a criação do banco de dados forem concluídas, preserve-as.
- Depois de instalar uma correção aplicável, reconecte e use
-Resumecom o caminho e o pilar originais para executar novamente a avaliação e o processamento de relatório. - Use o relatório HTML clássico se ele tiver sido gerado com êxito.
Inspecionar a atividade de avaliação
Examine o código-fonte do PowerShell, o painel de progresso e os logs por execução para entender a atividade da avaliação. O guia original de solução de problemas avançados aborda a análise de pacote de suporte.
Solução de problemas avançada e coleta de dados
Diagnósticos diferentes capturam diferentes estágios. Escolha o local que corresponde à falha antes de coletar ou compartilhar dados.
Logs e arquivos de diagnóstico
<Path> é o diretório que você passa para Invoke-ZtAssessment -Path ou .\ZeroTrustReport por padrão. O pacote de suporte opcional, os arquivos por execução e os logs de PSFramework estendidos são três locais de diagnóstico separados.
| Local | Conteúdo e uso |
|---|---|
<Path>\log\ |
Um ZIP de pacote de suporte do PSFramework criado por -ExportLog próximo da conclusão bem-sucedida, contendo um snapshot de .cliDat. Ele pode estar ausente se a opção não tiver sido usada ou a execução tenha falhado antes desse estágio. |
<Path>\zt-export\logs\<run>\1-export_progress.log |
Exportar o progresso e o status do coletor. Comece aqui para problemas de coleta de dados. |
<Path>\zt-export\logs\<run>\2-database_progress.log |
Progresso e tempos de compilação do banco de dados. Ao retomar, essa fase é ignorada. |
<Path>\zt-export\logs\<run>\3-test_progress.log |
Progresso e status da execução da avaliação. |
<Path>\zt-export\logs\<run>\1-Export\export_<Name>.md |
Status do coletor, duração, carimbos de data/hora, endpoint/tipo, versão do módulo e mensagens de diagnóstico. |
<Path>\zt-export\logs\<run>\2-Tests\<TestID>.md |
Título de teste, status, duração, carimbos de data/hora, versão do módulo e mensagens detalhadas, potencialmente incluindo texto de consulta. |
%APPDATA%\PowerShell\PSFramework\Logs\no Windows |
Logs de mensagens estendidas e registros de erro XML, independentemente do caminho de saída. Útil para problemas de conexão/importação, exceções, locais de origem, rastreamentos de pilha e mensagens fora de testes individuais. |
<run> usa o formato yy-MM-dd-HHmmssde carimbo de data/hora. Os arquivos aparecem conforme suas fases são executadas; uma execução parcial ou retomada não precisa conter todos os arquivos. Os arquivos por execução são gerados independentemente de -ExportLog.
Os arquivos PSFramework estendidos incluem identificadores de computador/processo e segmentos numerados, como <computer>_<pid>_message_0.log e <computer>_<pid>_error_0.xml. A disponibilidade e a retenção dependem da configuração do provedor de log.
Em Windows, %APPDATA% identifica a pasta Roaming do usuário, normalmente%USERPROFILE%\AppData\Roaming. No PowerShell, use $env:APPDATA; o caminho de log equivalente é Join-Path $env:APPDATA 'PowerShell\PSFramework\Logs'.
O restante de <Path>\zt-export são dados de avaliação, não apenas logs: entidades exportadas, ztConfig.json, db\zt.db, ZeroTrustAssessmentReport.json e ZeroTrustWorkshop.json. Esses arquivos podem ajudar a reproduzir ou retomar uma execução, mas podem conter dados confidenciais do locatário. Excluir <Path> não remove logs separados do PSFramework.
Capturar um pacote de suporte
Se uma execução falhar antes de criar um pacote de suporte opcional, capture o diagnóstico na mesma sessão do PowerShell antes de fechá-lo.
Escolha um destino separado para o pacote de diagnóstico. Ele não precisa corresponder ao caminho de saída da avaliação. Substitua o destino de exemplo por uma pasta para sua execução:
New-PSFSupportPackage -Path C:\AssessmentLogs\Run01 -ForceExtraia o ZIP gerado para acessar seu
.cliDatarquivo.Examine e oculte os dados de diagnóstico antes de compartilhar. Para importar e investigar o instantâneo, consulte o guia avançado de análise de log.
Um diagnóstico de sessão disponível para instantâneos de pacote de suporte, incluindo histórico de mensagens e erros e potencialmente histórico de comandos ou saída do console. Não é um arquivo automático de todos os arquivos de tenant exportados.
Warning
Relatórios, exportações, pacotes de suporte e logs estendidos podem conter informações pessoais, identificadores de locatário, valores de consulta e detalhes de configuração. Nunca os anexe a issues públicas no GitHub sem revisá-los nem faça upload deles para uma ferramenta não aprovada. Compartilhe diagnósticos adicionais apenas por meio de um canal privado aprovado, conforme acordado com o destinatário.
Relatar um problema ou fornecer comentários
Pesquise ou registre issues no GitHub ou use o canal de feedback. Inclua a versão da avaliação, a versão do PowerShell, os IDs do pilar e dos testes selecionados, o estágio afetado e um resumo dos erros sem informações sensíveis.
A avaliação é um projeto de comunidade, não um produto Microsoft oficial. O relatório de problemas da comunidade não é um contrato de suporte ou uma garantia de resposta. Leia a política de suporte antes de compartilhar o diagnóstico.