coletor de log Análise de Área de Trabalho

  • Artigo

Use a ferramenta DesktopAnalyticsLogsCollector.ps1 do diretório de instalação do Configuration Manager para ajudar a solucionar problemas Análise de Área de Trabalho registro de dispositivo. Ele executa algumas etapas básicas de solução de problemas e coleta os logs relevantes em um único diretório de trabalho. Você pode compartilhar esse conteúdo com Microsoft suporte.

Pré-requisitos

Uso

Obtenha o script do conteúdo de instalação do Configuration Manager:SMSSETUP\TOOLS\DesktopAnalyticsLogsCollector\DesktopAnalyticsLogsCollector.ps1

DesktopAnalyticsLogsCollector.ps1
    [-LogPath] <String>
    [-LogMode] <Int16>
    [-CollectNetTrace] <Int16>
    [-CollectUTCTrace] <Int16>

Parâmetros

-LogPath

Especifica um caminho local ou UNC para colocar o log e outros arquivos de saída.

Valores:

  • Caminho local (comprimento máximo = 130), por exemplo: c:\myfolder

  • Caminho UNC (comprimento máximo = 130), por exemplo: \\myserver\myfolder

Tipo: Cadeia de caracteres

Posição: 1

Valor padrão: $Env:SystemDrive\M365AnalyticsLogs (quando esse parâmetro é nulo, vazio ou espaço em branco, o script cria a pasta M365AnalyticsLogs sob a unidade do sistema.)

-LogMode

Especifica o nível verboso dos logs.

Valores:

  • 0: registrar mensagens de script somente na janela de comando do PowerShell.

  • 1: registrar mensagens de script em ambos os arquivos de log na pasta de saída e na janela de comando do PowerShell.

  • 2: registrar mensagens de script no arquivo de log somente na pasta de saída.

Tipo: Int16

Posição: 2

Valor padrão: 1 (Log script messages to log file and PowerShell command window.)

-CollectNetTrace

Especifica se o script coleta o rastreamento de rede.

Valores:

  • 0: não habilite o rastreamento de rede.

  • 1 (qualquer valor inteiro não zero): habilitar rastreamento de rede e coletar resultados.

Tipo: Int16

Posição: 3

Valor padrão: 0 (Não habilite o rastreamento de rede)

-CollectUTCTrace

Especifica se o script coleta o rastreamento UTC do Windows e executa o diagnóstico de conectividade.

Valores:

  • 0: não habilite o rastreamento utc ou execute o diagnóstico de conectividade.

  • 1 (qualquer valor inteiro não zero): habilite o rastreamento UTC, execute o diagnóstico de conectividade e colete resultados.

Tipo: Int16

Posição: 4

Valor padrão: 0 (Não habilite o diagnóstico de conectividade de rastreamento ou execução do UTC)

Saída

O script cria uma pasta de trabalho no caminho especificado. Por exemplo, M365AnalyticsLogs_yy_MM_dd_HH_mm_ss. Ele coloca todos os arquivos de saída nessa pasta de trabalho.

Se você habilitar o script para gravar em um arquivo de log, ele gerará um na pasta de trabalho. Por exemplo, M365AnalyticsLogs_ yy_MM_dd_HH_mm_ss.txt.

O script também gera outros arquivos de diagnóstico na pasta de trabalho. Por exemplo:

  • installedKBs.txt: uma lista de atualizações do Windows instaladas no dispositivo
  • appcompat: dados de compatibilidade do aplicativo
  • Reg*.txt: uma série de arquivos com dados exportados do Registro do Windows

Exemplos

Exemplo 1: executar script por meio da janela de comando do PowerShell com valores padrão

.\DesktopAnalyticsLogsCollector.ps1

Exemplo 2: executar script por meio da janela de comando do PowerShell com parâmetros especificados

.\DesktopAnalyticsLogsCollector.ps1 -LogPath "c:\testABC" -LogMode 0 -CollectNetTrace 0 -CollectUTCTrace 0

Exemplo 3: executar script por meio da janela de comando do PowerShell com parâmetros especificados na posição

.\DesktopAnalyticsLogsCollector.ps1 "c:\testABC" 2 0 0

Exemplo 4: executar script por meio da janela de comando do PowerShell com parâmetro especificado e mensagens verbosas

.\DesktopAnalyticsLogsCollector.ps1 -LogMode 1 -Verbose

Exemplo 5: Implantar script por meio de scripts de Configuration Manager

Para obter mais informações, consulte Criar e executar scripts do PowerShell no console Configuration Manager.

DesktopAnalyticsLogsCollector.ps1 é assinado digitalmente por Microsoft. Talvez seja necessário adicionar seu certificado de assinatura de código Microsoft como um Publicador Confiável no dispositivo de destino.

  1. Abra as propriedades do script no Windows Explorer. Alterne para a guia Assinaturas Digitais e selecione Detalhes.

  2. Na guia Geral , selecione Exibir Certificado.

    Observação

    Para distribuir o certificado por meio de outros mecanismos, primeiro exporte o certificado para um arquivo. Acesse a guia Detalhes e selecione Copiar para Arquivo.

  3. Escolha Instalar Certificado. Importe o certificado, colocando-o no repositório Editores Confiáveis .

Próximas etapas