Configurando dispositivos por meio do script de configuração de relatórios do Windows Update para Empresas

O script de configuração de relatórios do Windows Update para Empresas é o método recomendado de configuração de dispositivos para enviar dados à Microsoft para uso com relatórios do Windows Update para Empresas. O script configura as chaves do Registro, as políticas de apoio, garante que os serviços necessários estejam em execução e muito mais. Esse script é um complemento recomendado para configurar as políticas necessárias documentadas nos relatórios configurar manualmente dispositivos para o Windows Update para Empresas, pois pode fornecer comentários sobre se há algum problema de configuração fora das políticas que estão sendo configuradas.

Sobre o script

O script de configuração configura as chaves do Registro diretamente. As chaves do Registro podem ser substituídas por configurações de política, como Política de Grupo ou MDM. A reconfiguração de dispositivos com o script não reconfigura as políticas definidas anteriormente, tanto no caso da Política de Grupo quanto do MDM. Se houver conflitos entre as configurações da Política de Grupo ou do MDM e as configurações necessárias listadas em Configurando manualmente dispositivos para relatórios do Windows Update para Empresas, os dados do dispositivo podem não aparecer corretamente nos relatórios do Windows Update para Empresas.

Você pode baixar o script do Centro de Download da Microsoft.

Como este script é organizado

Os dois arquivos principais deste script são ConfigScript.ps1 e RunConfig.bat. Você configura RunConfig.bat de acordo com as direções no próprio, que será executado ConfigScript.ps1 com os parâmetros inseridos em RunConfig.bat.bat . Há duas maneiras de usar o script: no modo Piloto ou no modo Implantação .

Importante

O PsExec é usado para executar o script no contexto do sistema. Depois que o dispositivo for configurado, remova PsExec.exe do dispositivo.

Como usar este script

Edite o RunConfig.bat arquivo para configurar as seguintes variáveis e execute o arquivo .bat editado:

Variável Valores permitidos e descrição Exemplo
runMode Piloto (padrão): modo detalhado com diagnósticos e registro adicionais. O modo piloto é melhor para uma execução de teste do script ou para solução de problemas.
Implantação: não executa nenhum diagnóstico adicional nem adiciona registro em log extra		 runMode=Pilot
logPath Caminho em que os logs são salvos. O local padrão dos logs é .\UCLogs. logPath=C:\temp\logs
logMode 0: Registrar apenas
no console 1 (padrão): Registrar no arquivo e no console.
2: Registrar somente no arquivo.		 logMode=2
DeviceNameOptIn verdadeiro (padrão): o nome do dispositivo é enviado à Microsoft.
false: o nome do dispositivo não é enviado à Microsoft.		 DeviceNameOptIn=true
ClientProxy Direto (padrão): nenhum proxy é usado. A conexão com os pontos de extremidade é direta.
Sistema: o proxy do sistema, sem autenticação, é usado. Esse tipo de proxy geralmente é configurado com netsh e pode ser verificado usando netsh winhttp show proxy.
Usuário: o proxy é configurado por meio do IE e pode ou não exigir autenticação do usuário.

Para obter mais informações, consulte Como o cliente do Windows Update determina qual servidor proxy usar para se conectar ao site do Windows Update		 ClientProxy=Direct
fonte Usado pelo arquivo .bat e pelo script do PowerShell para localizar dependências. É recomendável que você não altere esse valor. source=%~dp0

Erros de script

Erro Descrição
1 Erro inesperado
12 Falha em CheckVortexConnectivity, marcar a saída do log para obter mais informações.
12 Falha inesperada ao executar CheckVortexConnectivity.
16 A reinicialização está pendente no dispositivo. Reinicie o dispositivo e execute o script novamente.
17 Exceção inesperada em CheckRebootRequired.
27 Não é uma conta do sistema.
30 Não é possível desabilitar o Enterprise Auth Proxy. Esse valor do Registro deve ser 0 para que o UTC opere em um ambiente de proxy autenticado.
34 Exceção inesperada ao tentar marcar as configurações de proxy.
35 Exceção inesperada ao verificar o proxy do usuário.
37 Exceção inesperada ao coletar logs.
40 Exceção inesperada ao verificar e definir a telemetria.
41 Não é possível representar um usuário conectado.
42 Exceção inesperada ao tentar representar um usuário conectado.
43 Exceção inesperada ao tentar representar um usuário conectado.
44 Erro ao executar o serviço CheckDiagTrack.
45 DiagTrack.dll não encontrado.
50 O serviço DiagTrack não está em execução.
51 Exceção inesperada ao tentar executar Census.exe.
52 Não foi possível encontrar Census.exe.
54 Serviço do Assistente de Entrada de Conta Microsoft (MSA) desabilitado.
55 Falha ao criar um novo caminho do Registro para SetDeviceNameOptIn.
56 Falha ao criar a propriedade para SetDeviceNameOptIn no caminho do Registro.
57 Falha ao atualizar o valor para SetDeviceNameOptIn.
58 Exceção inesperada em SetDeviceNameOptIn.
59 Falha ao excluir a propriedade LastPersistedEventTimeOrFirstBoot no caminho do Registro ao tentar limpar OneSettings.
60 Falha ao excluir a chave do Registro ao tentar limpar o OneSettings.
61 Exceção inesperada ao tentar limpar o OneSettings.
62 A chave do Registro AllowTelemetry não é o tipo correto de REG_DWORD.
63 AllowTelemetry não está definido com o valor apropriado e não pôde ser definido pelo script.
64 AllowTelemetry não é o tipo correto de REG_DWORD.
66 Falha ao verificar a conectividade UTC e uploads recentes.
67 Falha inesperada ao verificar o CSP UTC.
99 O dispositivo não é o Windows 10 ou o Windows 11.
100 O dispositivo deve ser associado ao Microsoft Entra ou ao Microsoft Entra híbrido para usar relatórios do Windows Update para Empresas.
101 Verifique se o ingresso no Microsoft Entra falhou com uma exceção inesperada.
102 A política DisableOneSettingsDownloads não deve ser habilitada. Desabilite essa política.

Próximas etapas

Usar relatórios do Windows Update para Empresas

  • Last updated on