テスト用にファクトリ OS イメージにパッチを適用する
テストをより高速にするために、ドライバー、カスタマイズ パッケージ、テスト コンテンツをテスト イメージに直接追加できます。これにより、これらのいずれかの種類のパッケージをテストするたびにイメージを再生成する必要がなくなります。
前提条件
- OEMInput ファイル内の
ReleaseType=Test
を使用してビルドされたテスト イメージ。 - 1 個以上:
- CPU アーキテクチャの種類がターゲット テスト イメージと一致しているユニバーサル Windows ドライバー
- テスト資料を含むテスト コンテンツ フォルダー
- カスタマイズ パッケージ
使用方法
ImageApp.exe [OutputFile] /Patch [/Drivers:[List_of_INF_Files]] [/Customizations:[List_of_OEM_Customization_Cab]] [/TestContent:[Folder_Containing_Test_Collateral]] [/CPUType:x]
OutputFile: 変更するイメージへのパス。
/Patch: [OutputFile] に追加のカスタマイズを追加します。
/CPUType:x: 変更されるイメージの CPU アーキテクチャの種類。 値: {arm|arm64|x86|amd64}
このコマンドには、次のオプションのうち 1 つ以上が必要です。
- /Drivers:[Folder_containing_driver_files]: ドライバーまたはドライバーを含んでいるディレクトリへのパス。 複数のドライバー ファイルやディレクトリをセミコロンで区切って追加できます。 コンテンツのインストールを再帰的に試みます。
- /Customizations:[Folder_containing_Customization_Cabs]: [OutputFile] に追加する OEM カスタマイズ cab ファイルの、セミコロンで区切られたリスト
- /TestContent:[Folder_containing_test_collateral]: ユーザー データ パーティション内の TestContent フォルダーの下にある、イメージに追加する署名済みのテスト資料を含んでいるフォルダーのリスト
例:
ImageApp.exe image.ffu /Patch /Customizations:C:\workspace\Contoso_Customization\ /TestContent:c:\workspace\TestContent /CPUType:amd64
Note
ルート フォルダー内にあるイメージに対してこのコマンドを実行することはできません。 このコマンドは、ルート フォルダーではないクリーンなフォルダー内にあるイメージに対して実行します。
トラブルシューティング
エラー コード 0x800700ea
FFU イメージにドライバーを追加しようとしたときにエラーコード 0x800700ea
が表示された場合は、一部の VHDX ファイルがまだマウントされている可能性があります。 テクニシャン PC 上で [ディスクの管理] を使用して、操作対象のイメージに関連するすべてのマウントされた VHDX のマウントを解除してから、やり直してください。
エラー 0x800700ea
が表示されているサンプル ログ:
{2/24/2020 4:56:43 PM} Imaging: FFU file '\\?\C:\FFU\ImageApp\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.ffu' loaded.
{2/24/2020 4:56:48 PM} Error: GetVolumeFromPartitionName: Waiting for DATA with store ID 0x0 failed with error code 0x800700ea.
{2/24/2020 4:56:48 PM} Error: [00:00:00] 'Failed call to GetPartitionPath for the ‘????’ partition': HRESULT_FROM_WIN32(234)
{2/24/2020 4:56:48 PM} Error: Imaging!UpdateImage: Failed to Initialize UpdateDLL::UpdateMain with error code: -2147024662 (0x800700EA)