Colecionador de registos desktop Analytics

  • Artigo

Utilize a ferramenta DesktopAnalyticsLogsCollector.ps1 do diretório de instalação do Gestor de Configuração para ajudar a resolver problemas de inscrição de dispositivos desktop Analytics. Executa algumas etapas básicas de resolução de problemas e recolhe os registos relevantes num único diretório de trabalho. Pode partilhar este conteúdo com o suporte da Microsoft.

Pré-requisitos

  • Um cliente do Desktop Analytics a executar Windows 10, Windows 8.1 ou Windows 7 com o Service Pack 1.

  • Executar o script no dispositivo como utilizador administrativo e executar como Administrador.

    Dica

    Pode utilizar a funcionalidade Scripts do Gestor de Configuração com esta ferramenta. Para obter mais informações, consulte Exemplo 5: Implementar script através de Scripts do Gestor de Configuração.

  • Para Windows 7 com Bloco de Serviço 1: Versão PowerShell 4.0 ou posterior

Utilização

Obtenha o script a partir do conteúdo de instalação do Gestor de Configuração: 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 registo e outros ficheiros de saída.

Valores:

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

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

Tipo: Cadeia

Posição: 1

Valor predefinido: $Env:SystemDrive\M365AnalyticsLogs (Quando este parâmetro é nulo, vazio ou espaço branco, o script cria a pasta M365AnalyticsLogs sob a unidade do sistema.)

-LogMode

Especifica o nível verboso dos troncos.

Valores:

  • 0: Registar mensagens de script apenas na janela de comando PowerShell.

  • 1: Registar mensagens de script para ambos os ficheiros de registo sob a pasta de saída e a janela de comando PowerShell.

  • 2: Registar mensagens de script para registar apenas o ficheiro sob a pasta de saída.

Tipo: Int16

Posição: 2

Valor predefinido: 1 (Registar mensagens de script para o ficheiro de registo e para a janela de comando PowerShell.)

-CollectNetTrace

Especifica se o script recolhe os vestígios de rede.

Valores:

  • 0: Não ative os vestígios da rede.

  • 1 (qualquer valor inteiro não zero): Ativar o rastreio da rede e recolher resultados.

Tipo: Int16

Posição: 3

Valor predefinido: 0 (Não ative o rastreio da rede)

-CollectUTCTrace

Especifica se o script recolhe o Windows o rastreio UTC e executar o diagnóstico de conectividade.

Valores:

  • 0: Não ative o rastreio UTC ou executar o diagnóstico de conectividade.

  • 1 (qualquer valor inteiro não zero): Ativar o rastreio UTC, executar o diagnóstico de conectividade e recolher resultados.

Tipo: Int16

Posição: 4

Valor predefinido: 0 (Não ative o rastreio UTC ou executar o diagnóstico de conectividade)

Saída

O script cria uma pasta de trabalho sob o caminho especificado. Por exemplo, M365AnalyticsLogs_yy_MM_dd_HH_mm_ss. Coloca todos os seus ficheiros de saída nesta pasta de trabalho.

Se ativar o script para escrever num ficheiro de registo, gera um na pasta de trabalho. Por exemplo, M365AnalyticsLogs_ yy_MM_dd_HH_mm_ss.txt.

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

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

Exemplos

Exemplo 1: Executar o script através da janela de comando PowerShell com valores predefinidos

.\DesktopAnalyticsLogsCollector.ps1

Exemplo 2: Executar o script através da janela de comando PowerShell com parâmetros especificados

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

Exemplo 3: Executar o script através da janela de comando PowerShell com parâmetros especificados na posição

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

Exemplo 4: Executar o script através da janela de comando PowerShell com parâmetros especificados e mensagens verbosas

.\DesktopAnalyticsLogsCollector.ps1 -LogMode 1 -Verbose

Exemplo 5: Implementar scripts através de Scripts do Gestor de Configuração

Para obter mais informações, consulte Criar e executar scripts PowerShell a partir da consola 'Gestor de Configuração'.

DesktopAnalyticsLogsCollector.ps1 é digitalmente assinado pela Microsoft. Poderá ter de adicionar o certificado de assinatura de código microsoft como um Publisher fidedigno no dispositivo-alvo.

  1. Abra as propriedades do script no Windows Explorer. Mude para o separador Assinaturas Digitais e selecione Detalhes.

  2. No separador Geral, selecione 'Ver' Certificado.

    Nota

    Para distribuir o certificado através de outros mecanismos, primeiro exporte o certificado para um ficheiro. Vá ao separador Detalhes e selecione Copy to File.

  3. Selecione o Certificado de Instalação. Importe o certificado, colocando-o na loja Trusted Publishers.

Passos seguintes