Freigeben über


OA 3.0-Tool: Befehlszeilen- und Konfigurationsdateisyntax

Das OA 3.0-Tool ist ein Befehlszeilentool, das das Zusammenstellen, Melden und Zurückgeben eines eindeutigen Bezeichners für Computer in Fabriken unterstützt. Sie können das OA 3.0-Tool auf zwei Arten ausführen:

  • Durch Verwenden des Überwachungsmodus auf dem vollständig zusammengesetzten Clientcomputer. Weitere Informationen zum Ausführen des OA 3.0-Tools im Überwachungsmodus finden Sie unter Übersicht über den Überwachungsmodus im Windows ADK.

  • Durch Verwenden des OOBE-Modus auf dem vollständig zusammengesetzten Clientcomputer. Wenn die erste Eingabeaufforderung in OOBE angezeigt wird, drücken Sie UMSCHALT+F10, um eine Administratorbefehlsaufforderung zu öffnen, das OA 3.0-Tool auszuführen und dann den Computer herunterzufahren. Die OOBE-Benutzeroberfläche für Endbenutzer*innen muss mit dem Ausführen des OA-Tools im Überwachungsmodus übereinstimmen und darf nicht vom Standard abweichen.

Option Beschreibung
/Assemble Ruft einen Produktschlüssel mit dem Status „Erfüllt“ aus der Fabrikdatenbank ab und stellt dann die Dateien „OA3.bin“ und „OA3.xml“ für einen bestimmten Computer zusammen. Nach der Assembly kann das durch den OEM bereitgestellte Firmware-Injektionstool die Datei „OA3.bin“ in die Firmware des Computers einfügen.

Beispiel:

OA3Tool.exe /Assemble /Configfile=C:\OA3\OA3.cfg
/Report Erstellt den Hardwarehashwert für einen bestimmten Computer, verknüpft den Wert mit der Product Key-ID und sendet dann die Datei „OA3.xml“ an den Berichtsserver der Fabrik. Diese Befehlszeilenoption wird in der Regel in der Fabrik verwendet, nachdem der Product Key in den neuen Computer eingefügt wurde.

Wichtig

Wenn Sie die Befehlszeilenoption /report zusammen mit einem internen, drahtlosen Netzwerkadapter verwenden, müssen Sie das vollständige Betriebssystem ausführen. Windows PE kann nicht verwendet werden. Wenn Sie die Option /report außerdem ohne Serververbindung ausführen, wird der resultierende Bericht an demselben Speicherort wie die Datei „OA3.xml“ gespeichert, die Ihre Konfigurationsdatei angibt. Die Berichtsdatei wird das nächste Mal an den Berichtsserver der Fabrik gesendet, wenn Sie die Option /report ausführen und der Computer verbunden ist.

Beispiel:

OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg

Wenn der Computer keinen Product Key in der Firmware aufweist, können Sie „/report /NoKeyCheck“ ausführen, um einen Hardwarehash für die Offlineüberprüfung zu generieren. Bei der CBR-Übermittlung tritt jedoch ein Fehler auf, wenn ein Product Key in der Firmware fehlt.

Beispiel:

OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /NoKeyCheck
/Return Gibt einen vorhandenen Product Key für die Abstimmung zurück. Beispielsweise können Sie diese Option verwenden, wenn Sie eine zuvor eingefügte Hardwarezuordnung durch eine neue Zuordnung für denselben Computer ersetzen. Diese Befehlszeilenoption wird in der Regel verwendet, nachdem der Computerbuildbericht generiert wurde. Sie wird in MDOS nicht unterstützt.

Beispiel:

OA3Tool.exe /Return /Configfile=C:\OA30\OA3.cfg
/LogTrace=<OA3_log_file> Protokolliert Diagnosenachverfolgungsdaten für die OA 3.0-Hardwarehashgenerierung in einer Datei, die in <OA3_log_file> angegeben ist. Der Pfad muss gültig sein, damit „OA3Tool.exe“ darauf schreiben kann. Partnern wird empfohlen, dies beim Testen der OA 3.0-CBR-Berichterstellung und Hardwarehashtoleranz zu verwenden.

Beispiel:

OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /LogTrace=C:\OA30\OA3.log
/CheckEdition Führt eine Kreuzüberprüfung für eine Editionsübereinstimmung zwischen dem eingefügten Product Key und dem Zielbetriebssystem aus. Zwei Modi sind möglich:
  1. Offlineüberprüfung in Windows PE. Sie müssen /ImageDrive=<image_drive_letter> verwenden, um den Laufwerkbuchstaben anzugeben, auf den das Image angewendet wird.

    Stellen Sie vor Verwenden dieser Option in Windows PE sicher, dass die aktuelle Version von „DISM.exe“ und alle Dateien aus dem gesamten DISM-Ordner (ca. 7 bis 9 MB) aus dem neuesten Windows ADK in denselben Ordner kopiert werden müssen, in dem sich „Windows 10 OA3Tool.exe“ befindet.
  2. Onlineüberprüfung im vollständigen Betriebssystem. In diesem Fall sollte der /online-Modus angegeben werden. Es werden keine Laufwerkbuchstaben-Informationen benötigt. Diese Option ist nur verfügbar, wenn es sich beim Zielbetriebssystem um einen Windows 10-Client handelt.
/Configfile=<configfile_location> Gibt den Speicherort und den Namen der Konfigurationsdatei an, die den Speicherort des Schlüsselanbieterservers und der Dateipfade für Protokolldateien, Fehlercodes und Nachrichten sowie den Speicherort der temporären Verzeichnisse enthält, die zum Assemblieren des Product Keys im Binär- und XML-Format erforderlich sind
/DecodeHwHash Wird zum Decodieren des Hardwarehash in ein lesbares XML-Format verwendet. Der „/DecodeHwHash“ akzeptiert entweder eine Zeichenfolge (z. B. wenn er in einer Datenbank gespeichert oder in E-Mail gesendet wird) oder einen Dateipfad zur vollständigen XML-Datei, die in der „/Report“-Phase generiert wurde.

Beispiel:

OA3Tool /decodeHwhash=<Hardware Hash string>
/Validate Führt einen Überprüfungsphase durch, um sicherzustellen, dass die MSDM-Tabelle vorhanden ist, die MSDM-Tabellenüberschrift alle erforderlichen Felder enthält und die MSDM-Tabelleneinträge vorhanden sind und den richtigen Formaten entsprechen

Beispiel:

OA3Tool.exe /Validate
/ValidateSMBIOS Die Werte „TotalPhysicalRAM“ und „PrimaryDiskTypeCapacity“ werden aus den SMBIOS-Strukturen des Geräts abgerufen. Die OEMs sind dafür verantwortlich, diese Strukturen ordnungsgemäß zu initialisieren. Um zu überprüfen, ob diese Strukturen ordnungsgemäß initialisiert wurden, verfügt OA3Tool RS3 oder höher über eine neue Option „/ValidateSMBIOS“, die die SMBIOS-Tabellen durchläuft und sicherstellt, dass sie in Bezug auf diese beiden Attribute ordnungsgemäß initialisiert wurden. Zwei Modi sind möglich:
  1. Onlineüberprüfung im vollständigen Betriebssystem. Sie müssen /ValidateSMBIOS ohne den Parameter verwenden.
  2. Offlineüberprüfung in der SMBIOS-Tabelle. Der Inhalt dieser Tabelle kann mithilfe der Ausgabedatei /Logtrace des Befehls /report erfasst werden. Das Attribut „SMBIOSRawData“ enthält den Inhalt der SMBIOS-Tabelle. Dieser Wert muss dann an die Option /ValidSMBIOS übergeben werden, um die Korrektheit des Inhalts zu überprüfen.

Beispiel:
  1. OA3Tool.exe /Logtrace=trace.txt /Report /ConfigFile=<OA3 Config file>
  2. Extrahieren Sie aus „trace.txt“ den „SMBIOSRawData“-Attributwert.
  3. OA3Toool.exe /ValidateSMBIOS = <SMBIOSRawData value>
/ValidateHwHash Wird verwendet, um das Base64-codierte Hardwarehashelement mit den vordefinierten Qualitätskriterien für kritische und wichtige Felder zu überprüfen. Kritische Felder werden benötigt, damit Autopilot-Features funktionieren, während wichtige Felder zum Berechnen der Lizenzgebühr verwendet werden.

Diese Funktion ist nur in der Version 18950 oder höher des OA 3.0-Tools verfügbar.

Die Option /ValidateHwHash akzeptiert entweder eine Zeichenfolge (z. B. wenn sie in einer Datenbank gespeichert oder in E-Mail gesendet wird) oder einen Dateipfad zur vollständigen XML-Datei, die in der „/Report“-Phase generiert wurde.

Beispiel:

OA3Tool.exe /ValidateHwhash=<Hardware Hash string>|<report_file.xml>

Die kritischen Felder lauten:
DiskSerialNumber
TpmVersion
EkPubHash
MacAddress
ProductKeyId
SmbiosSystemFamily
SmbiosSystemManufacturer
SmbiosSystemProductName
SmbiosSystemSerialNumber
SmbiosUuid

Die wichtigen Felder lauten:
ChassisTypes
DigitizerSupportID
DiskType
DisplayResolution
DisplaySize
InternalDiskCount
OsBuild
OsCpuArchitecture
OSType
ProcessorCores
ProcessorModel
TotalDiskCapacity
TotalPhysicalRAM

Hinweis

Die Option /ValidateHwash überprüft alle Felder des decodierten Hardwarehashs auf Fehler, Leerzeichen oder Nullwerte. Weitere zu überprüfende Felder befinden sich in der folgenden Tabelle.

Feld Output
Betriebssystemtyp Die Ausgabe sollte „FullOS“ lauten. Wenn das Feld leer ist oder „WinPE“ lautet, wurde beim Erstellen des Hardwarehashs kein vollständiger Start des Betriebssystems verwendet.
TotalPhysicalRAM Die Ausgabe sollte den RAM auf dem Gerät darstellen (z. B. 4, 8, 16, etc.). Wenn das Feld leer oder „0“ ist, 65535, wurde der RAM nicht ordnungsgemäß erfasst.
PrimaryDiskTotalCapacity Die Ausgabe sollte den primären Speicher im Gerät darstellen (z. B. 128, 256, 1024, etc.).
DisplayResolution und PhysicalDisplaySize Die Ausgabe sollte die interne Anzeigeauflösung und physische Größe darstellen. Wenn das Feld „0“ entspricht, muss das Gerät beispielsweise einen externen Monitor aufweisen, wie z. B. bei einem Desktop-PC.
SMBIOS-Felder Die Ausgabe sollte keine Daten enthalten, leer sein oder eine Standardzeichenfolge enthalten, z. B. „To be filled by O.E.M“.
MacAddress Die Ausgabe sollte keine Daten enthalten, leer sein, 00:00:00:00:00:00 oder FF:FF:FF:FF:FF:FF darstellen.
ChassisTypes Die Ausgabe sollte der Regel in der SMBIOS-Referenzspezifikation folgen.