次の方法で共有

OA 3.0 ツール: コマンドラインと構成ファイルの構文

OA 3.0 ツールは、製造現場でコンピューターの一意の識別子を組み立て、レポートし、返すことをサポートするコマンドライン ツールです。 OA 3.0 ツールは、次の 2 つの方法で実行できます。

  • 完全に組み立てられたクライアント コンピューターで監査モードを使用する。 監査モードでの OA 3.0 ツールの実行の詳細については、Windows ADK の「監査モードの概要」を参照してください。

  • 完全に組み立てられたクライアント コンピューターで OOBE モードを使用する。 最初のプロンプトが OOBE に表示されたら、Shift + F10 キーを押して管理者コマンド プロンプトを開き、OA 3.0 ツールを実行してから、マシンをシャットダウンします。 エンド ユーザーの OOBE エクスペリエンスは、監査モードで OA ツールを実行することと一致している必要があり、標準から逸脱したものであってはなりません。

オプション 説明
/Assemble 製造現場のデータベースから完了の状態のプロダクト キーを取得し、特定のコンピューターの OA3.bin ファイルと OA3.xml ファイルをアセンブルします。 アセンブリの後、OEM が提供するファームウェア インジェクション ツールで、OA3 ファイルをコンピューターのファームウェアに挿入できます。

例:

OA3Tool.exe /Assemble /Configfile=C:\OA3\OA3.cfg
/Report 特定のコンピューターのハードウェア ハッシュ値を作成し、その値をプロダクト キー ID に関連付けてから、OA3.xml ファイルを製造現場のレポート サーバーに送信します。 このコマンドライン オプションは、通常、プロダクト キーを新しいコンピューターに挿入した後、製造現場で使用されます。

重要

/report コマンドライン オプションを内部ワイヤレス ネットワーク アダプターと一緒に使用する場合は、オペレーティング システム全体を実行する必要があります。 Windows PE は使用できません。 さらに、サーバーに接続せずに /report オプションを実行すると、結果のレポートは、構成ファイルで指定されている OA3.xml ファイルと同じ場所に保存されます。 次回コンピューターが接続されているときに /report オプションを実行すると、レポート ファイルが製造現場のレポート サーバーに送信されます。

例:

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

マシンのファームウェアにプロダクト キーがない場合は、/report /NoKeyCheck を実行して、オフライン検証用のハードウェア ハッシュを生成できます。 ただし、ファームウェアにプロダクト キーがないと、CBR の送信は失敗します。

例:

OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /NoKeyCheck
/Return 調整のために既存のプロダクト キーを返します。 たとえば、以前に挿入されたハードウェアの関連付けを同じコンピューターの新しい関連付けに置き換える場合は、このオプションを使用できます。 このコマンドライン オプションは、通常、コンピューター ビルド レポートが生成された後に使用されます。 MDOS ではサポートされていません。

例:

OA3Tool.exe /Return /Configfile=C:\OA30\OA3.cfg
/LogTrace=<OA3_log_file> OA 3.0 ハードウェア ハッシュ生成診断トレース データを <OA3_log_file> で指定されたファイルに記録します。 パスは、OA3Tool.exe が書き込むために有効である必要があります。 パートナーが OA 3.0 CBR レポートとハードウェア ハッシュ許容値をテストする場合は、このスイッチを使用することを強くお勧めします。

例:

OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /LogTrace=C:\OA30\OA3.log
/CheckEdition 挿入されたプロダクト キーと、エディションが一致する対象のオペレーティング システムとの間のクロス チェックを実行します。 2 つのモードを利用できます。
  1. Windows PE でのオフライン チェック。 /ImageDrive=<image_drive_letter> を使用して、イメージを適用するドライブ文字を指定する必要があります。

    Windows PE でこのスイッチを使用する前に、最新バージョンの DISM.exe と、最新の Windows ADK の DISM フォルダー全体 (約 7 〜 9 MB) のすべてのファイルを、Windows 10 OA3Tool.exe が存在するのと同じフォルダーにコピーする必要があります。
  2. 完全なオペレーティング システムをオンラインで確認します。 この場合、/online モードを指定する必要があります。 ドライブ文字情報は必要ありません。 このスイッチは、ターゲット オペレーティング システムが Windows 10 クライアントである場合にのみ使用できます。
/Configfile=<configfile_location> キー プロバイダー サーバーの場所を含む構成ファイルの場所と名前を指定します。これには、ログ ファイル、エラー コード、およびメッセージのファイル パスの場所、プロダクト キーをバイナリ形式と XML 形式にアセンブルするために必要な一時ディレクトリの場所が含まれます。
/DecodeHwHash ハードウェア ハッシュを xml の人間が読める形式にデコードするために使用されます。 /DecodeHwHash は、文字列 (たとえば、データベースに保存されているか、電子メールで送信される場合) または /Report ステージで生成された完全な XML ファイルへのファイル パスのいずれかを受け入れます。

例:

OA3Tool /decodeHwhash=<Hardware Hash string>
/Validate 検証パスを実行して、MSDM テーブルが存在すること、MSDM テーブル ヘッダーにすべての必須フィールドが含まれていること、および MSDM テーブル エントリが存在し、正しい形式に準拠していることを確認します。

例:

OA3Tool.exe /Validate
/ValidateSMBIOS TotalPhysicalRAM と PrimaryDiskTypeCapacity の値は、デバイスの SMBIOS 構造から取得されます。 これらの構造を適切に初期化するのは OEM の役割です。 これらの構造が適切に初期化されていることを検証するために、OA3Tool RS3 以降のバージョンには新しいオプション /ValidateSMBIOS があり、SMBIOS テーブルを反復処理して、これら 2 つの属性に関して正しく初期化されていることを確認します。 2 つのモードを利用できます。
  1. 完全なオペレーティング システムをオンラインで確認します。 パラメーターなしで /ValidateSMBIOS を使用する必要があります。
  2. SMBIOS テーブルでのオフライン チェック。 このテーブルの内容は、/report コマンドからの /Logtrace 出力ファイルを使用して収集できます。 SMBIOS テーブルの内容を含む属性 (SMBIOSRawData) があります。 次に、この値を /ValidateSMBIOS オプションに渡して、内容が実際に正しいことを検証する必要があります。

例:
  1. OA3Tool.exe /Logtrace=trace.txt /Report /ConfigFile=<OA3 Config file>
  2. trace.txt から、SMBIOSRawData 属性値を抽出する
  3. OA3Toool.exe /ValidateSMBIOS = <SMBIOSRawData value>
/ValidateHwHash 重大なフィールドおよび重要なフィールドの事前定義された品質基準を使用して、base64 でエンコードされたハードウェア ハッシュ要素を検証するために使用されます。 Autopilot 機能が機能するには重大なフィールドが必要ですが、重要なフィールドはロイヤリティ ライセンス料の計算に使用されます。

この機能は、18950 以降の OA 3.0 ツール バージョンでのみ使用できます。

/ValidateHwHash オプションは、文字列 (たとえば、データベースに保存されているか、電子メールで送信される場合) または /Report ステージで生成された完全な XML ファイルへのファイル パスのいずれかを受け入れます。

例:

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

重大なフィールドは次のとおりです。
DiskSerialNumber
TpmVersion
EkPubHash
MacAddress
ProductKeyId
SmbiosSystemFamily
SmbiosSystemManufacturer
SmbiosSystemProductName
SmbiosSystemSerialNumber
SmbiosUuid

重要なフィールドは次のとおりです。
ChassisTypes
DigitizerSupportID
DiskType
DisplayResolution
DisplaySize
InternalDiskCount
OsBuild
OsCpuArchitecture
OSType
ProcessorCores
ProcessorModel
TotalDiskCapacity
TotalPhysicalRAM

Note

/ValidateHwash オプションは、デコードされたハードウェア ハッシュのフィールドのエラー、ブランク、または null 値をチェックします。 次の表に、確認する追加のフィールドを示します。

フィールド 出力
OS の種類 出力は ''FullOS'' である必要があります。 フィールドが空であるか、''WinPE'' を表している場合、ハードウェア ハッシュの作成時に OS のフル ブートが使用されませんでした。
物理 RAM の合計 出力は、デバイスの RAM を表す必要があります。 (つまり、4、8、16 など)。 フィールドが空であるか、''0''、65535 の場合、RAM は正しくキャプチャされませんでした。
プライマリ ディスクの合計容量 出力は、デバイス内のプライマリ ディスクを表す必要があります。 (つまり、128、256、1024 など)。
ディスプレイ解像度と物理的なディスプレイ サイズ 出力は、内部のディスプレイ解像度と物理サイズを表す必要があります。 フィールドが ''0'' の場合、デバイスには、たとえば、デスクトップの場合と同様に、外部モニターが必要です。
SMBIOS フィールド 出力には、データが含まれていないか、空白であるか、または ''To be filled by O.E.M'' のような既定の文字列が含まれている必要があります
MacAddress 出力は、データなし、空白、00:00:00:00:00:00 または FF:FF:FF:FF:FF:FF を表すことはできません
ChassisTypes 出力は、SMBIOS リファレンス仕様の規則に従っている必要があります。