Windows Update voor Bedrijven-rapporten: het configuratiescript gebruiken om problemen met apparaatconfiguratie op te lossen

2025-01-15

Van toepassing op: Windows Server, alle ondersteunde versies

Wanneer u problemen wilt oplossen, kunt u het configuratiescript voor Windows Update voor Bedrijven-rapporten gebruiken om eindpuntconnectiviteit te testen, ervoor te zorgen dat de juiste services worden uitgevoerd en te controleren op veelvoorkomende problemen.

U kunt het script downloaden via het Microsoft Downloadcentrum.

Zie Apparaten configureren via het configuratiescript voor Windows Update voor Bedrijven voor meer informatie over het script, inclusief de beschikbare parameters.

Notitie

Als u geen problemen vindt in de apparaatconfiguratie en u bepaalt dat de Windows Update voor Bedrijven-rapporten correct zijn geconfigureerd, heeft uw probleem waarschijnlijk te maken met gegevensoverdracht. Zie Windows Update voor Bedrijven-rapporten voor meer informatie: problemen met de overdracht van diagnostische gegevens oplossen.

Het script configureren

Op het apparaat moet Windows 10 of een latere versie en de nieuwste versie van Windows PowerShell zijn geïnstalleerd. Als u het script wilt uitvoeren, moet u een PowerShell-venster met verhoogde bevoegdheid op het apparaat gebruiken (het script zelf wordt uitgevoerd in de systeemcontext).

Belangrijk

Het scriptpakket bevat PSExec.exe. Als u een mobile device manager zoals Microsoft Intune gebruikt en u ASR-regels (Attack Surface Reduction) hebt geïmplementeerd buiten de standaard ASR-regels, kunnen de regels het script blokkeren. Zie Procescreaties blokkeren die afkomstig zijn van PSExec- en WMI-opdrachten voor meer informatie.
Nadat u klaar bent met het oplossen van problemen met het apparaat, verwijdert u PSExec.exe.

Het script uitvoeren

Het script gebruiken om problemen met een clientapparaat op te lossen:

Meld u als beheerder aan bij het apparaat.
Download het scriptpakket naar het apparaat dat u wilt oplossen en vouw het scriptpakket uit.
Maak een map op het apparaat voor logboekgegevens. De standaardnaam en het pad dat door het script wordt gebruikt, is *De standaardwaarde is .\UCLogs.
Bewerk RunConfig.bat om de volgende vereiste parameters in te stellen:
- runMode=Pilot
- logPath=<path of the folder that you created for log data>
Notitie
- De pilotmodus is een uitgebreide modus. Het script heeft een andere modus, Implementatie, die op de achtergrond wordt uitgevoerd.
- Wijzig de Commercial ID parameters niet. Ze worden gebruikt voor de eerdere versie van Windows Update voor Bedrijven-rapporten (Updatecompatibiliteit).

Als u extra parameters wilt instellen, zijn de volgende RunConfig.bat parameters optioneel.

Parameter	Toegestane waarden en beschrijving	Voorbeeld
logMode	0: Meld u alleen aan bij de console. 1: (standaard) Logboek naar bestand en console. 2: Meld u alleen aan bij het bestand.	`logMode=2`
DeviceNameOptIn	true: (standaard) De apparaatnaam wordt naar Microsoft verzonden. false: de apparaatnaam wordt niet naar Microsoft verzonden.	`DeviceNameOptIn=true`
ClientProxy	Direct: (standaard) Het apparaat maakt rechtstreeks verbinding met de eindpunten. Systeem: Het apparaat maakt verbinding met behulp van een systeemproxy, zonder verificatie. Gebruiker: Het apparaat maakt verbinding met behulp van de internetconfiguratie van het gebruikersaccount. Voor de verbinding is mogelijk geen gebruikersverificatie vereist. Zie Hoe de Windows Update-client bepaalt welke proxyserver moet worden gebruikt om verbinding te maken met de Windows Update-website voor meer informatie	`ClientProxy=Direct`

Sla de wijzigingen op in RunConfig.bat en sluit het bestand.
Open een PowerShell-venster met verhoogde bevoegdheid, navigeer naar de map met de scriptbestanden en voer vervolgens RunConfig.bat uit.

De scriptuitvoer controleren

Het script maakt een werkmap in de map die u hebt geïdentificeerd in de logPath parameter in RunConfig.bat. De standaardmapnaam is UA_yy_MM_dd_HH_mm_ss_GUID, waarbij yy_MM_dd_HH_mm_ss de datum en tijd vertegenwoordigt waarop u het script hebt uitgevoerd. Het script slaat alle uitvoerbestanden en andere diagnostische bestanden op in deze werkmap.

Het scriptlogboekbestand en de foutcodes analyseren

Het scriptlogboekbestand, UA_yy_MM_dd_HH_mm_ss_GUID.txt, heeft dezelfde naam als de werkmap. Controleer eerst dit bestand. U kunt de volgende tabel gebruiken om foutcodes te interpreteren die in het bestand worden vermeld.

Fout	Beschrijving
1	Onverwachte fout
12	CheckVortexConnectivity is mislukt, controleer de logboekuitvoer voor meer informatie.
12	Onverwachte fout bij het uitvoeren van CheckVortexConnectivity.
16	Opnieuw opstarten is in behandeling op het apparaat. Start het apparaat opnieuw op en voer het script opnieuw uit.
17	Onverwachte uitzondering in CheckRebootRequired.
27	Geen systeemaccount.
30	Kan enterprise-verificatieproxy niet uitschakelen. Deze registerwaarde moet 0 zijn voor UTC om te kunnen werken in een geverifieerde proxyomgeving.
34	Onverwachte uitzondering bij het controleren van proxy-instellingen.
35	Onverwachte uitzondering bij het controleren van de gebruikersproxy.
37	Onverwachte uitzondering bij het verzamelen van logboeken.
40	Onverwachte uitzondering bij het controleren en instellen van telemetrie.
41	Kan aangemelde gebruiker niet imiteren.
42	Onverwachte uitzondering bij een poging om aangemelde gebruiker te imiteren.
43	Onverwachte uitzondering bij een poging om aangemelde gebruiker te imiteren.
44	Fout bij het uitvoeren van de CheckDiagTrack-service.
45	DiagTrack.dll niet gevonden.
50	DiagTrack-service wordt niet uitgevoerd.
51	Onverwachte uitzondering bij het uitvoeren van Census.exe.
52	Kan Census.exe niet vinden.
54	De MSA-service (Microsoft Account Sign In Assistant) is uitgeschakeld.
55	Kan geen nieuw registerpad maken voor SetDeviceNameOptIn.
56	Kan de eigenschap voor SetDeviceNameOptIn niet maken op het registerpad.
57	Kan de waarde voor SetDeviceNameOptIn niet bijwerken.
58	Onverwachte uitzondering in SetDeviceNameOptIn.
59	Kan de eigenschap LastPersistedEventTimeOrFirstBoot niet verwijderen bij het registerpad bij het opschonen van OneSettings.
60	Kan de registersleutel niet verwijderen bij het opschonen van OneSettings.
61	Onverwachte uitzondering bij het opschonen van OneSettings.
62	De registersleutel AllowTelemetry is niet het juiste type REG_DWORD.
63	AllowTelemetry is niet ingesteld op de juiste waarde en kan niet worden ingesteld door het script.
64	AllowTelemetry is niet het juiste type REG_DWORD.
66	Kan de UTC-connectiviteit en recente uploads niet controleren.
67	Onverwachte fout bij het verifiëren van UTC CSP.
99	Het apparaat is niet Windows 10 of Windows 11.
100	Het apparaat moet lid zijn van Microsoft Entra of hybride microsoft Entra-gekoppeld om rapporten van Windows Update voor Bedrijven te kunnen gebruiken.
101	Controleren of Microsoft Entra join is mislukt met onverwachte uitzondering.
102	DisableOneSettingsDownloads-beleid mag niet zijn ingeschakeld. Schakel dit beleid uit.

De andere uitvoer- en diagnostische gegevens analyseren

Met deze bestanden worden gegevens vastgelegd die door het script uit het register worden geëxporteerd.

RegAppCompatFlags.txt

Dit bestand registreert informatie over appraiser (ook wel Device Appraiser of Microsoft Compatibility Appraiser genoemd). Appraiser is het Windows-onderdeel dat overeenkomt met de compatibiliteitsupdates. Hiermee worden de apps en stuurprogramma's op het apparaat beoordeeld op compatibiliteit met de nieuwste versie van Windows. Appraiser is afhankelijk van de volgende bestanden:

%windir%\System32\appraiser.dll. De bestandsversie moet 10.0.17763 of hoger zijn.
%windir%\System32\CompatTelRunner.exe. Als het bestand niet bestaat, controleert u of alle compatibiliteitsupdates op het apparaat zijn geïnstalleerd.

RegDataCollection.txt

Dit bestand registreert de DataCollection-instellingen. Deze gegevens vertegenwoordigen de huidige telemetrieconfiguratie van het apparaat, volgens het toegepaste beleid.

U kunt deze gegevens gebruiken om te controleren of de juiste waarden worden toegepast om diagnostische gegevens naar Microsoft te verzenden. Deze gegevens lijken op het volgende fragment:

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\DataCollection]
"AllowDeviceNameInTelemetry"=dword:00000001
"AllowUpdateComplianceProcessing"=dword:00000010
"AllowCommercialDataPipeline"=dword:00000001

RegPoliciesDataCollection.txt

Dit bestand registreert instellingen op apparaat- en gebruikersniveau voor het beheren van diagnostische gegevens. De configuratiegegevens op apparaatniveau lijken op het volgende fragment:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\DataCollection]
"AllowTelemetry"=dword:00000003
"MaxTelemetryAllowed"=dword:00000003

De AllowTelemetry vermelding bepaalt het type (indien van toepassing) diagnostische gegevens dat moet worden verzonden. De vermelding heeft de volgende toegestane waarden:

0 – Beveiliging (deze waarde wordt alleen ondersteund in Enterprise-, Education- en Server-edities van Windows.)
1 – Basistelemetrie (vereist)
2 – Verbeterde telemetrie
3 – Volledige telemetrie

De configuratiegegevens op gebruikersniveau lijken op het volgende fragment:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\DataCollection\Users]

RegSQM.txt

Deze informatie gaat voornamelijk over Windows 7-apparaten. Als u in latere Windows-versies werkt, kunt u deze informatie gebruiken als een terugval-id voor het apparaat.

RegDiagTrack.txt

Dit bestand registreert alle registerinstellingen voor de service Connected User Experiences and Telemetry (DiagTrack) (UTC). Alle vermeldingen die deze instellingen opslaan, bevinden zich onder de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Diagnostics\DiagTrack\ subsleutel. In het volgende fragment ziet u een dergelijk rapport:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Diagnostics\DiagTrack]
"TimeStampInterval"=dword:00000001
"Capabilities"=hex:c6,f6,43,15,00,00,00,00
"mspflags"=hex(b):11,00,00,00,00,00,00,00
"DiagTrackAuthorization"=dword:00000f9f
"LaunchCount"=hex(b):03,00,00,00,00,00,00,00
"DiagTrackStatus"=dword:00000003
"LastFreeNetworkLossTime"=hex(b):00,00,00,00,00,00,00,00
"LastConnectivityHeartBeatTime"=hex(b):00,00,00,00,00,00,00,00
"LastConnectivityState"=dword:00000002
"ConnectivityNoNetworkTime"=dword:00000001
"ConnectivityRestrictedNetworkTime"=dword:00000000
"LastPersistedEventTime"=hex(b):40,e5,64,27,cb,8a,d9,01
"LatencyDataLastUploadTime"=hex(b):00,00,00,00,00,00,00,00
"TriggerCount"=hex(b):00,04,00,00,00,00,00,00
"HttpRequestCount"=hex(b):07,00,00,00,00,00,00,00
"TriggerLatency"="0.088490"
"HttpRequestLatency"="0.077600"
"LastSuccessfulUploadTime"=hex(b):7a,96,6c,2b,cb,8a,d9,01
"LastSuccessfulRealtimeUploadTime"=hex(b):7a,96,6c,2b,cb,8a,d9,01
"LastSuccessfulNormalUploadTime"=hex(b):55,2a,aa,a7,ca,8a,d9,01

Het hulpprogramma DCode gebruiken om hexadecimale waarden te converteren naar datum-tijdnotatie

Zoals wordt weergegeven in het vorige fragment, gebruiken veel van deze vermeldingen de hexadecimale indeling big-endian. Als u ze wilt converteren naar UTC-datums en -tijden, gebruikt u een hulpprogramma zoals DCode. Dit hulpprogramma is beschikbaar als gratis download.

Het hulpprogramma DCode gebruikt invoerwaarden met een iets andere indeling dan de indeling die het bestand gebruikt. U moet de volgorde van de segmenten omkeren en vervolgens alle niet-numerieke tekens verwijderen. Bekijk bijvoorbeeld de volgende waarde uit het fragment:

hex(b):55,2a,aa,a7,ca,8a,d9,01

Als u deze waarde wilt converteren, opent u DCode, selecteert u Format en selecteert u vervolgens Hexadecimaal (Big Endian). Voer in Waarde het volgende in:

01d98acaa7aa2a55

Selecteer vervolgens Decoderen. De lijst met resultaten bevat een Windows FileTime-vermelding (UTC) met de waarde 2023-05-20 03:24:58.5114197 Z.