Configurar dispositivos através 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 para configurar dispositivos para enviar dados para a Microsoft para utilização com relatórios do Windows Update para Empresas. O script configura as políticas de apoio das chaves de registo, garante que os serviços necessários estão em execução e muito mais. Este script é um complemento recomendado para configurar as políticas necessárias documentadas em Configurar manualmente dispositivos para relatórios do Windows Update para Empresas, uma vez que pode fornecer feedback sobre se existem problemas de configuração fora das políticas que estão a ser configuradas.
Acerca do script
O script de configuração configura as chaves de registo diretamente. As chaves de registo podem potencialmente ser substituídas por definições de política, como a Política de Grupo ou a MDM. Reconfigurar dispositivos com o script não reconfigura as políticas definidas anteriormente, tanto no caso da Política de Grupo como da MDM. Se existirem conflitos entre a Política de Grupo ou as configurações de MDM e as configurações necessárias listadas em Configurar manualmente dispositivos para relatórios do Windows Update para Empresas, os dados do dispositivo poderão não aparecer corretamente nos relatórios do Windows Update para Empresas.
Pode transferir o script a partir do Centro de Transferências da Microsoft.
Como este script está organizado
Os dois ficheiros principais deste script são ConfigScript.ps1 e RunConfig.bat. Pode configurar RunConfig.bat de acordo com as direções em .bat si, que serão executadas ConfigScript.ps1 com os parâmetros introduzidos RunConfig.batem . Existem duas formas de utilizar o script: no modo Piloto ou no Modo de implementação .
Importante
O PsExec é utilizado para executar o script no contexto do sistema. Assim que o dispositivo estiver configurado, remova PsExec.exe do dispositivo.
Como utilizar este script
Edite o RunConfig.bat ficheiro para configurar as seguintes variáveis e, em seguida, execute o ficheiro de .bat editado:
| Variável | Valores e descrição permitidos | Exemplo |
|---|---|---|
| runMode |
Piloto (predefinição): modo verboso com diagnósticos e registos adicionais. O modo piloto é melhor para uma execução de teste do script ou para resolução de problemas. Implementação: não executa diagnósticos adicionais nem adiciona registos adicionais |
runMode=Pilot |
| logPath | Caminho onde os registos são guardados. A localização predefinida dos registos é .\UCLogs. |
logPath=C:\temp\logs |
| logMode |
0: Inicie sessão na consola apenas 1 (predefinição): Inicie sessão no ficheiro e na consola. 2: Iniciar sessão apenas no ficheiro. |
logMode=2 |
| DeviceNameOptIn |
true (predefinição): o nome do dispositivo é enviado à Microsoft. false: o nome do dispositivo não é enviado para a Microsoft. |
DeviceNameOptIn=true |
| ClientProxy |
Direto (predefinição): não é utilizado nenhum proxy. A ligação aos pontos finais é direta. Sistema: o proxy do sistema, sem autenticação, é utilizado. Normalmente, este tipo de proxy é configurado com netsh e pode ser verificado com netsh winhttp show proxy.
Utilizador: o proxy está configurado através do IE e pode ou não exigir a autenticação do utilizador. Para obter mais informações, veja How the Windows Update client determine which proxy server to use to connect to the Windows Update website (Como o cliente do Windows Update determina que servidor proxy utilizar para ligar ao site do Windows Update) |
ClientProxy=Direct |
| origem | Utilizado pelo ficheiro .bat e script do PowerShell para localizar dependências. Recomenda-se que não altere este valor. | source=%~dp0 |
Erros de script
| Erro | Descrição |
|---|---|
| 1 | Erro inesperado |
| 12 | CheckVortexConnectivity falhou, verifique a saída do registo para obter mais informações. |
| 12 | Falha inesperada ao executar CheckVortexConnectivity. |
| 16 | O reinício está pendente no dispositivo. Reinicie o dispositivo e volte a executar o script. |
| 17 | Exceção inesperada em CheckRebootRequired. |
| 27 | Não é a conta do sistema. |
| 30 | Não é possível desativar o Proxy de Autenticação Empresarial. Este valor de registo tem de ser 0 para que a UTC opere num ambiente de proxy autenticado. |
| 34 | Exceção inesperada ao tentar verificar as definições de proxy. |
| 35 | Exceção inesperada ao verificar o proxy do utilizador. |
| 37 | Exceção inesperada ao recolher registos. |
| 40 | Exceção inesperada ao verificar e definir a telemetria. |
| 41 | Não é possível representar o utilizador com sessão iniciada. |
| 42 | Exceção inesperada ao tentar representar o utilizador com sessão iniciada. |
| 43 | Exceção inesperada ao tentar representar o utilizador com sessão iniciada. |
| 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 Início de Sessão da Conta Microsoft (MSA) desativado. |
| 55 | Falha ao criar um novo caminho de registo para SetDeviceNameOptIn. |
| 56 | Falha ao criar a propriedade para SetDeviceNameOptIn no caminho do registo. |
| 57 | Falha ao atualizar o valor de SetDeviceNameOptIn. |
| 58 | Exceção inesperada em SetDeviceNameOptIn. |
| 59 | Falha ao eliminar a propriedade LastPersistedEventTimeOrFirstBoot no caminho do registo ao tentar limpar o OneSettings. |
| 60 | Falha ao eliminar a chave de registo ao tentar limpar o OneSettings. |
| 61 | Exceção inesperada ao tentar limpar o OneSettings. |
| 62 | A chave de registo AllowTelemetry não é o tipo correto de REG_DWORD. |
| 63 | AllowTelemetry não está definido para o valor adequado e não foi possível defini-lo pelo script. |
| 64 | AllowTelemetry não é o tipo correto de REG_DWORD. |
| 66 | Falha ao verificar a conectividade UTC e os carregamentos recentes. |
| 67 | Falha inesperada ao verificar o CSP UTC. |
| 99 | O dispositivo não é o Windows 10 ou o Windows 11. |
| 100 | O dispositivo tem de estar associado ao Microsoft Entra ou associado ao Microsoft Entra híbrido para utilizar relatórios do Windows Update para Empresas. |
| 101 | Verifique se a associação ao Microsoft Entra falhou com uma exceção inesperada. |
| 102 | A política DisableOneSettingsDownloads não deve estar ativada. Desative esta política. |