Configurazione dei dispositivi tramite lo script di configurazione dei report di Windows Update for Business
Lo script di configurazione dei report di Windows Update for Business è il metodo consigliato per configurare i dispositivi per l'invio di dati a Microsoft per l'uso con i report di Windows Update for Business. Lo script configura i criteri di backup delle chiavi del Registro di sistema, garantisce l'esecuzione dei servizi necessari e altro ancora. Questo script è un complemento consigliato alla configurazione dei criteri necessari documentati in Configurare manualmente i dispositivi per i report di Windows Update for Business, in quanto può fornire commenti e suggerimenti sull'eventuale presenza di problemi di configurazione al di fuori dei criteri configurati.
Informazioni sullo script
Lo script di configurazione configura direttamente le chiavi del Registro di sistema. Le chiavi del Registro di sistema possono essere potenzialmente sovrascritte da impostazioni di criteri come Criteri di gruppo o MDM. La riconfigurazione dei dispositivi con lo script non riconfigura i criteri impostati in precedenza, sia nel caso di Criteri di gruppo che di MDM. Se si verificano conflitti tra le configurazioni di Criteri di gruppo o MDM e le configurazioni necessarie elencate in Configurazione manuale dei dispositivi per i report di Windows Update per le aziende, i dati del dispositivo potrebbero non essere visualizzati correttamente nei report di Windows Update for Business.
È possibile scaricare lo script dall'Area download Microsoft.
Come è organizzato questo script
I due file primari di questo script sono ConfigScript.ps1 e RunConfig.bat. È possibile configurare RunConfig.bat in base alle istruzioni in sé, che verranno quindi eseguite ConfigScript.ps1 con i parametri immessi in .batRunConfig.bat. Esistono due modi per usare lo script: in modalità pilota o in modalità di distribuzione .
Importante
PsExec viene usato per eseguire lo script nel contesto di sistema. Dopo aver configurato il dispositivo, rimuovere PsExec.exe dal dispositivo.
Come usare questo script
Modificare il RunConfig.bat file per configurare le variabili seguenti, quindi eseguire il file di .bat modificato:
| Variabile | Valori e descrizione consentiti | Esempio |
|---|---|---|
| runMode |
Pilota (impostazione predefinita): modalità dettagliata con diagnostica e registrazione aggiuntive. La modalità pilota è ideale per un'esecuzione di test dello script o per la risoluzione dei problemi. Distribuzione: non esegue alcuna diagnostica aggiuntiva o aggiunge registrazione aggiuntiva |
runMode=Pilot |
| logPath | Percorso in cui vengono salvati i log. Il percorso predefinito dei log è .\UCLogs. |
logPath=C:\temp\logs |
| logMode |
0: accedere alla console solo 1 (impostazione predefinita): Accedere al file e alla console. 2: Accedere solo al file. |
logMode=2 |
| DeviceNameOptIn |
true (impostazione predefinita): il nome del dispositivo viene inviato a Microsoft. false: il nome del dispositivo non viene inviato a Microsoft. |
DeviceNameOptIn=true |
| ClientProxy |
Diretto (impostazione predefinita): non viene usato alcun proxy. La connessione agli endpoint è diretta. Sistema: viene usato il proxy di sistema, senza autenticazione. Questo tipo di proxy è in genere configurato con netsh e può essere verificato tramite netsh winhttp show proxy.
Utente: il proxy viene configurato tramite Internet Explorer e potrebbe richiedere o meno l'autenticazione utente. Per altre informazioni, vedere Come il client Windows Update determina quale server proxy usare per connettersi al sito Web di Windows Update |
ClientProxy=Direct |
| fonte | Usato dal file .bat e dallo script di PowerShell per individuare le dipendenze. È consigliabile non modificare questo valore. | source=%~dp0 |
Errori di script
| Errore | Descrizione |
|---|---|
| 1 | Errore imprevisto |
| 12 | CheckVortexConnectivity non riuscito, controllare l'output del log per altre informazioni. |
| 12 | Errore imprevisto durante l'esecuzione di CheckVortexConnectivity. |
| 16 | Il riavvio è in sospeso nel dispositivo. Riavviare il dispositivo e rieseguire lo script. |
| 17 | Eccezione imprevista in CheckRebootRequired. |
| 27 | Non account di sistema. |
| 30 | Impossibile disabilitare il proxy di autenticazione dell'organizzazione. Questo valore del Registro di sistema deve essere 0 perché l'ora UTC funzioni in un ambiente proxy autenticato. |
| 34 | Eccezione imprevista durante il tentativo di controllare le impostazioni proxy. |
| 35 | Eccezione imprevista durante il controllo del proxy utente. |
| 37 | Eccezione imprevista durante la raccolta dei log. |
| 40 | Eccezione imprevista durante il controllo e l'impostazione dei dati di telemetria. |
| 41 | Impossibile rappresentare l'utente connesso. |
| 42 | Eccezione imprevista durante il tentativo di rappresentare l'utente connesso. |
| 43 | Eccezione imprevista durante il tentativo di rappresentare l'utente connesso. |
| 44 | Errore durante l'esecuzione del servizio CheckDiagTrack. |
| 45 | DiagTrack.dll non trovato. |
| 50 | Il servizio DiagTrack non è in esecuzione. |
| 51 | Eccezione imprevista durante il tentativo di eseguire Census.exe. |
| 52 | Impossibile trovare Census.exe. |
| 54 | Servizio Microsoft Account Sign In Assistant (MSA) disabilitato. |
| 55 | Impossibile creare il nuovo percorso del Registro di sistema per SetDeviceNameOptIn. |
| 56 | Impossibile creare la proprietà per SetDeviceNameOptIn nel percorso del Registro di sistema. |
| 57 | Impossibile aggiornare il valore per SetDeviceNameOptIn. |
| 58 | Eccezione imprevista in SetDeviceNameOptIn. |
| 59 | Impossibile eliminare la proprietà LastPersistedEventTimeOrFirstBoot nel percorso del Registro di sistema quando si tenta di pulire OneSettings. |
| 60 | Impossibile eliminare la chiave del Registro di sistema durante il tentativo di pulizia di OneSettings. |
| 61 | Eccezione imprevista durante il tentativo di pulizia di OneSettings. |
| 62 | La chiave del Registro di sistema AllowTelemetry non è il tipo corretto di REG_DWORD. |
| 63 | AllowTelemetry non è impostato sul valore appropriato e non può essere impostato dallo script. |
| 64 | AllowTelemetry non è il tipo corretto di REG_DWORD. |
| 66 | Impossibile verificare la connettività UTC e i caricamenti recenti. |
| 67 | Errore imprevisto durante la verifica del provider di servizi di configurazione UTC. |
| 99 | Il dispositivo non è Windows 10 o Windows 11. |
| 100 | Il dispositivo deve essere aggiunto a Microsoft Entra o aggiunto a Microsoft Entra ibrido per usare i report di Windows Update for Business. |
| 101 | Verificare che l'aggiunta a Microsoft Entra non sia riuscita con un'eccezione imprevista. |
| 102 | I criteri DisableOneSettingsDownloads non devono essere abilitati. Disabilitare questo criterio. |