Configuration d’appareils via le script de configuration des rapports Windows Update for Business
Le script de configuration des rapports Windows Update for Business est la méthode recommandée de configuration des appareils pour envoyer des données à Microsoft en vue de les utiliser avec les rapports Windows Update for Business. Le script configure les stratégies de stockage des clés de Registre, vérifie que les services requis sont en cours d’exécution, et bien plus encore. Ce script est un complément recommandé pour la configuration des stratégies requises documentées dans Configurer manuellement des appareils pour les rapports Windows Update for Business, car il peut fournir des commentaires sur la présence de problèmes de configuration en dehors des stratégies en cours de configuration.
À propos du script
Le script de configuration configure directement les clés de Registre. Les clés de Registre peuvent potentiellement être remplacées par des paramètres de stratégie tels que la stratégie de groupe ou GPM. La reconfiguration des appareils avec le script ne reconfigure pas les stratégies précédemment définies, à la fois dans le cas de la stratégie de groupe et de la gestion des appareils mobiles. S’il existe des conflits entre vos configurations de stratégie de groupe ou GPM et les configurations requises répertoriées dans Configuration manuelle des appareils pour les rapports Windows Update for Business, les données d’appareil risquent de ne pas apparaître correctement dans les rapports Windows Update for Business.
Vous pouvez télécharger le script à partir du Centre de téléchargement Microsoft.
Comment ce script est organisé
Les deux fichiers principaux de ce script sont ConfigScript.ps1 et RunConfig.bat. Vous configurez RunConfig.bat en fonction des instructions dans le .bat lui-même, qui s’exécutera ConfigScript.ps1 ensuite avec les paramètres entrés dans RunConfig.bat. Il existe deux façons d’utiliser le script : en mode pilote ou en mode déploiement .
Important
PsExec est utilisé pour exécuter le script dans le contexte système. Une fois l’appareil configuré, supprimez PsExec.exe de l’appareil.
Comment utiliser ce script
Modifiez le RunConfig.bat fichier pour configurer les variables suivantes, puis exécutez le fichier .bat modifié :
| Variable | Valeurs autorisées et description | Exemple |
|---|---|---|
| runMode |
Pilote (par défaut) : mode détaillé avec diagnostics et journalisation supplémentaires. Le mode pilote est idéal pour une exécution de test du script ou pour la résolution des problèmes. Déploiement : n’exécute pas de diagnostics supplémentaires ou n’ajoute pas de journalisation supplémentaire |
runMode=Pilot |
| logPath | Chemin d’accès où les journaux sont enregistrés. L’emplacement par défaut des journaux est .\UCLogs. |
logPath=C:\temp\logs |
| logMode |
0 : Connectez-vous à la console uniquement 1 (valeur par défaut) : journal dans le fichier et la console. 2 : Journaliser dans le fichier uniquement. |
logMode=2 |
| DeviceNameOptIn |
true (par défaut) : le nom de l’appareil est envoyé à Microsoft. false : le nom de l’appareil n’est pas envoyé à Microsoft. |
DeviceNameOptIn=true |
| ClientProxy |
Direct (par défaut) : aucun proxy n’est utilisé. La connexion aux points de terminaison est directe. Système : le proxy système, sans authentification, est utilisé. Ce type de proxy est généralement configuré avec netsh et peut être vérifié à l’aide netsh winhttp show proxyde .
Utilisateur : le proxy est configuré via Internet Explorer et peut nécessiter ou non l’authentification de l’utilisateur. Pour plus d’informations, consultez Comment le client Windows Update détermine le serveur proxy à utiliser pour se connecter au site web Windows Update |
ClientProxy=Direct |
| source | Utilisé par le fichier .bat et le script PowerShell pour localiser les dépendances. Il est recommandé de ne pas modifier cette valeur. | source=%~dp0 |
Erreurs de script
| Erreur | Description |
|---|---|
| 1 | Erreur inattendue |
| 12 | Échec de CheckVortexConnectivity, consultez la sortie du journal pour plus d’informations. |
| 12 | Échec inattendu lors de l’exécution de CheckVortexConnectivity. |
| 16 | Le redémarrage est en attente sur l’appareil. Redémarrez l’appareil, puis réexécutez le script. |
| 17 | Exception inattendue dans CheckRebootRequired. |
| 27 | Pas le compte système. |
| 30 | Impossible de désactiver le proxy d’authentification d’entreprise. Cette valeur de Registre doit être 0 pour que l’utc fonctionne dans un environnement proxy authentifié. |
| 34 | Exception inattendue lors de la tentative de vérification des paramètres du proxy. |
| 35 | Exception inattendue lors de la vérification du proxy utilisateur. |
| 37 | Exception inattendue lors de la collecte des journaux. |
| 40 | Exception inattendue lors de la vérification et de la définition des données de télémétrie. |
| 41 | Impossible d’emprunter l’identité de l’utilisateur connecté. |
| 42 | Exception inattendue lors de la tentative d’emprunt d’identité de l’utilisateur connecté. |
| 43 | Exception inattendue lors de la tentative d’emprunt d’identité de l’utilisateur connecté. |
| 44 | Erreur lors de l’exécution du service CheckDiagTrack. |
| 45 | DiagTrack.dll introuvable. |
| 50 | Le service DiagTrack n’est pas en cours d’exécution. |
| 51 | Exception inattendue lors de la tentative d’exécution Census.exe. |
| 52 | Impossible de trouver Census.exe. |
| 54 | Service MsA (Assistant Connexion de compte Microsoft) désactivé. |
| 55 | Échec de la création du chemin d’accès au Registre pour SetDeviceNameOptIn. |
| 56 | Échec de la création de la propriété pour SetDeviceNameOptIn au niveau du chemin d’accès du Registre. |
| 57 | Échec de la mise à jour de la valeur de SetDeviceNameOptIn. |
| 58 | Exception inattendue dans SetDeviceNameOptIn. |
| 59 | Échec de la suppression de la propriété LastPersistedEventTimeOrFirstBoot au niveau du chemin du Registre lors de la tentative de nettoyage de OneSettings. |
| 60 | Échec de la suppression de la clé de Registre lors de la tentative de nettoyage de OneSettings. |
| 61 | Exception inattendue lors de la tentative de nettoyage de OneSettings. |
| 62 | La clé de Registre AllowTelemetry n’est pas le type correct de REG_DWORD. |
| 63 | AllowTelemetry n’est pas défini sur la valeur appropriée et le script n’a pas pu la définir. |
| 64 | AllowTelemetry n’est pas le type correct de REG_DWORD. |
| 66 | Échec de la vérification de la connectivité UTC et des chargements récents. |
| 67 | Échec inattendu lors de la vérification du fournisseur de services de configuration UTC. |
| 99 | L’appareil n’est pas Windows 10 ou Windows 11. |
| 100 | L’appareil doit être joint à Microsoft Entra ou joint à Microsoft Entra hybride pour utiliser les rapports Windows Update for Business. |
| 101 | Échec de la jonction Microsoft Entra avec une exception inattendue. |
| 102 | La stratégie DisableOneSettingsDownloads ne doit pas être activée. Désactivez cette stratégie. |