Outil OA 3.0 : syntaxe de fichier de ligne de commande et de fichier de configuration

L’outil OA 3.0 est un outil de ligne de commande qui prend en charge l’assemblage, la création de rapports et le retour d’un identificateur unique pour les ordinateurs de l’usine. Vous pouvez exécuter l’outil OA 3.0 de deux manières :

• En utilisant le mode audit sur l’ordinateur client entièrement assemblé. Pour plus d’informations sur l’exécution de l’outil OA 3.0 en mode audit, consultez Vue d’ensemble du mode audit dans Windows ADK.

• En utilisant le mode OOBE sur l’ordinateur client entièrement assemblé. Lorsque la première invite apparaît dans l’OOBE, appuyez sur Maj + F10 pour ouvrir une invite de commandes d’administration, exécutez l’outil OA3.0, puis arrêtez la machine. L’expérience OOBE de l’utilisateur final doit être cohérente avec l’exécution de l’outil OA en mode audit et ne pas dévier de la norme.

Option	Description
/Assemble	Récupère une clé de produit dont l’état est Rempli à partir de la base de données au niveau usine, puis assemble le fichier OA3.bin et le fichier OA3.xml pour un ordinateur spécifique. Après l’assemblage, l’outil d’injection de microprogramme fourni par le fabricant d'ordinateurs (OEM) peut injecter le fichier OA3.bin dans le microprogramme de l’ordinateur. Exemple : OA3Tool.exe /Assemble /Configfile=C:\OA3\OA3.cfg
/Report	Crée la valeur de hachage matérielle pour un ordinateur spécifique, associe la valeur à l’ID de clé de produit, puis envoie le fichier OA3.xml au serveur de rapports sur l’usine. Cette option de ligne de commande est généralement utilisée en usine après l’injection de la clé de produit dans le nouvel ordinateur. Important Lorsque vous utilisez l’option de ligne de commande /report avec une carte réseau sans fil interne, vous devez exécuter le système d’exploitation complet. Vous ne pouvez pas utiliser l’environnement de préinstallation Windows (Windows PE). En outre, si vous exécutez l’option /report sans connexion au serveur, le rapport résultant est enregistré au même emplacement que le fichier OA3.xml spécifié par votre fichier de configuration. Le fichier de rapport est envoyé au serveur de rapports situé au niveau usine la prochaine fois que vous exécutez l’option /report lorsque l’ordinateur est connecté. Exemple : OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg Si la machine n’a pas de clé de produit dans le microprogramme, vous pouvez exécuter /report /NoKeyCheck pour générer un hachage matériel pour la validation hors connexion. Toutefois, la soumission CBR échoue s’il manque une clé de produit dans le microprogramme. Exemple : OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /NoKeyCheck
/Return	Retourne une clé de produit existante pour le rapprochement. Par exemple, vous pouvez utiliser cette option si vous remplacez une association matérielle précédemment injectée par une nouvelle association pour le même ordinateur. Cette option de ligne de commande est généralement utilisée après la génération du rapport de build de l’ordinateur. Elle n’est pas prise en charge dans le cadre de MDOS. Exemple : OA3Tool.exe /Return /Configfile=C:\OA30\OA3.cfg
/LogTrace=<OA3_log_file>	Consigne les données de suivi de diagnostic de génération de hachage matériel OA 3.0 dans un fichier spécifié dans <OA3_log_file>. Le chemin d’accès doit être valide pour que OA3Tool.exe écrive dedans. Nous recommandons vivement aux partenaires d’utiliser ce commutateur lors du test des rapports CBR OA 3.0 et de la tolérance de hachage matériel. Exemple : OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /LogTrace=C:\OA30\OA3.log
/CheckEdition	Effectue une vérification entre la clé de produit injectée et le système d’exploitation cible pour la correspondance d’édition. Deux modes sont possibles : Archivage hors connexion dans l’environnement de préinstallation Windows (Windows PE). Vous devez utiliser /ImageDrive=<image_drive_letter> pour spécifier la lettre de lecteur dans laquelle l’image est appliquée. Avant d’utiliser ce commutateur dans Windows PE, assurez-vous que la dernière version de DISM.exe et tous les fichiers du dossier DISM entier (d’environ 7 à 9 Mo) du dernier Windows ADK doivent être copiés dans le dossier où réside le OA3Tool.exe Windows 10. Vérification en ligne dans le système d’exploitation complet. Dans ce cas, le mode /online doit être spécifié. Aucune information de lettre de lecteur n’est requise. Ce commutateur n’est disponible que si le système d’exploitation cible est client Windows 10.
/Configfile=<configfile_location>	Spécifie l’emplacement et le nom du fichier de configuration, qui contient l’emplacement du serveur du fournisseur de clés, les emplacements des chemins d’accès aux fichiers journaux, les codes d’erreur et messages, et l’emplacement des répertoires temporaires requis pour assembler la clé de produit dans des formats binaires et XML.
/DecodeHwHash	Utilisé pour décoder le hachage matériel dans un format xml lisible par l’homme. /DecodeHwHash accepte une chaîne (par exemple, si elle est stockée dans une base de données ou envoyée par e-mail) ou un chemin d’accès au fichier XML complet généré à l’étape /Report. Exemple : OA3Tool /decodeHwhash=<Hardware Hash string>
/Validate	Effectue une passe de validation pour s’assurer que la table MSDM existe, que l’en-tête de table MSDM inclut tous les champs obligatoires, que les entrées de table MSDM existent et sont conformes aux formats appropriés. Exemple : OA3Tool.exe /Validate
/ValidateSMBIOS	Les valeurs TotalPhysicalRAM et PrimaryDiskTypeCapacity sont obtenues à partir des structures SMBIOS de l’appareil. Il incombe aux fabricants d'ordinateurs OEM d’initialiser correctement ces structures. Pour vérifier que ces structures sont correctement initialisées, OA3Tool RS3 ou versions ultérieures disposent d’une nouvelle option, /ValidateSMBIOS, qui itère sur les tables SMBIOS et garantit qu’elles sont correctement initialisées par rapport à ces deux attributs. Deux modes sont possibles : Vérification en ligne dans le système d’exploitation complet. Vous devez utiliser /ValidateSMBIOS sans le paramètre. Vérification hors connexion dans la table SMBIOS. Le contenu de cette table peut être collecté à l’aide du fichier de sortie /Logtrace de la commande /report. Il existe un attribut (SMBIOSRawData) qui contient le contenu de la table SMBIOS. Cette valeur doit ensuite être passée à l’option /ValidateSMBIOS pour vérifier que le contenu est correct. Exemple : OA3Tool.exe /Logtrace=trace.txt /Report /ConfigFile=<OA3 Config file> À partir trace.txt, extrayez la valeur de l’attribut SMBIOSRawData OA3Toool.exe /ValidateSMBIOS = <SMBIOSRawData value>
/ValidateHwHash	Permet de valider l’élément de hachage matériel encodé en base64 avec les critères de qualité prédéfinis pour les champs critiques et importants. Les champs critiques sont nécessaires pour que la fonctionnalité Autopilot fonctionne, tandis que les champs importants sont utilisés pour calculer les frais de redevance de licence. Cette fonction n’est disponible que dans la version 18950 ou ultérieure de l’outil OA 3.0. L’option /ValidateHwHash accepte une chaîne (si elle est stockée dans une base de données ou envoyée par e-mail, par exemple) ou un chemin d’accès au fichier XML complet généré à l’étape /Report. Exemple : OA3Tool.exe /ValidateHwhash=<Hardware Hash string>|<report_file.xml> Les champs critiques sont les suivants : DiskSerialNumber TpmVersion EkPubHash MacAddress ProductKeyId SmbiosSystemFamily SmbiosSystemManufacturer SmbiosSystemProductName SmbiosSystemSerialNumber SmbiosUuid Les champs importants sont les suivants : ChassisTypes DigitizerSupportID DiskType DisplayResolution DisplaySize InternalDiskCount OsBuild OsCpuArchitecture OSType ProcessorCores ProcessorModel TotalDiskCapacity TotalPhysicalRAM

Remarque

L’option /ValidateHwash recherche les erreurs, les valeurs vides ou null dans l’un des champs du hachage matériel décodé. Les champs supplémentaires à vérifier se trouvent dans le tableau suivant.

Champ	Sortie
Type de système d’exploitation	La sortie doit être « FullOS ». Si le champ est vide ou représente « WinPE », un démarrage complet du système d’exploitation n’a pas été utilisé lors de la création du hachage matériel.
RAM physique totale	La sortie doit représenter la RAM dans l’appareil. (par exemple, 4, 8, 16, etc.). Si le champ est vide ou « 0 », 65535, la RAM n’a pas été capturée correctement.
Capacité totale du disque principal	La sortie doit représenter le disque principal de l’appareil. (par exemple, 128, 256, 1024, etc.)
Résolution d’affichage et taille d’affichage physique	La sortie doit représenter la résolution d’affichage interne et la taille physique. Si le champ est « 0 », l’appareil doit disposer d’un moniteur externe, par exemple, comme avec un bureau.
Champs SMBIOS	La sortie doit contenir des données, ne doit pas être vide ou contenir une chaîne par défaut, comme « À remplir par O.E.M »
MacAddress	La sortie doit représenter des données, ne doit pas être vide, 00:00:00:00:00:00 ou FF:FF:FF:FF:FF
ChassisTypes	La sortie doit suivre la règle dans la spécification de référence SMBIOS.