次の方法で共有

検証 OS イメージ ビルダーを使用した検証 OS のカスタマイズ

ドライバー パッケージと検証 OS カスタマイズ パッケージを追加して、検証 OS が起動し、シナリオに合わせてアプリをサポートできるようにします。 カスタマイズ パッケージを使用して、ドキュメントの後半で説明するいくつかのオンデマンド機能のサポートを追加できます。

検証 OS には受信トレイ ドライバーが付属していないため、イメージを PC に適用する前に必ずドライバーを追加する必要があります。

全体的なプロセス

検証 OS イメージ ビルダーを使用して検証 OS イメージを作成する全体的なプロセスは次のとおりです。

  1. 検証 OS ISO ファイルを技術者 PC ファイルシステム上の特定の場所にマウントします。

  2. 技術者 PC (x64 または arm64) のネイティブ アーキテクチャに基づいて適切な ValidationOSImageBuilder.exe を開始します。

  3. 検証 OS ImageBuilder の手順に従います

    1. [省略可能] 生成された検証 OS イメージの場所を選択します。

    2. [省略可能] マウントされた検証 OS イメージにドライバーを追加します。

    3. [省略可能] 1 つ以上の必要なオンデマンド機能を追加します。

    4. [省略可能] 検証 OS イメージでレジストリ キーを設定またはオーバーライドする。

    5. [省略可能] 検証 OS イメージにカスタム バイナリ/アプリケーションを含める。

    6. [省略可能] 生成された検証 OS イメージと一致する SDK への参照を含む Visual Studio ソリューションを作成します。

検証 OS イメージ ビルダーの概要

検証 OS イメージ ビルダーは、特定のシナリオに合わせてカスタム検証 OS イメージを簡単に生成できる GUI ツールです。 これにより、次の操作を追加できます。

  • オーディオ、Bluetooth、カメラ、マルチメディア、USB などのオプション パッケージ。
  • 特定のハードウェアのドライバー
  • 検証 OS イメージに含めるその他のソフトウェア アプリケーション
  • 起動時に検証 OS イメージで有効にするレジストリ キー
  • OS の起動時に実行するスタートアップ コマンド

また、生成される特定の検証 OS イメージに使用できる SDK を生成することもできます。

使用可能な省略可能な featuire パッケージの一覧については、次を参照してください。 機能パッケージ

検証 OS イメージ ビルダーの使用

検証 OS ISO パッケージからの検証 OS イメージ ビルダーの基本的なフローに関する詳しい使用方法ガイドを次に示します。

  1. 検証 OS ISO パッケージをマウントし、ISO がマウントされたドライブ<ISO_ROOT>:<ISO_ROOT>:\ImageBuilderフォルダーに移動します。

  2. ValidationOSImageBuilder.exe 実行して検証 OS イメージ ビルダーを起動し、管理者特権でプログラムを実行するように求められたプロンプトを受け入れます。

  3. [はじめに] をクリックして、[機能] 画面に移動します

  4. [機能] 画面で、検証 OS イメージに追加する機能を選択し、[次へ] をクリックして [ドライバー] 画面に移動します (上記のセクションで使用可能な機能の一覧を参照してください)。

  5. オプションの [ドライバー] 画面で、デバイスのドライバーが配置されているフォルダーを選択します

  6. この画面では、必要に応じて次のコンポーネントを画像に追加することもできます。

    1. オプションのソフトウェア フォルダー: これにより、検証 OS イメージに含まれるオプションの.EXE ファイルを含むフォルダーを含めることができます

    2. レジストリ ファイル: これにより、.起動時に検証 OS イメージに含まれるレジストリ エントリを含む REG ファイル

      ドライバー開発者:
      ドライバー証明書は、 .reg ファイルとして検証 OS に追加できます。 特定の証明書に対してこの .reg ファイルを生成するスクリプトが用意されています。このファイルは、検証 OS イメージ ビルダー アプリでアップロードできます。

      「 検証 OS の証明書をレジストリ ファイルに変換する」を参照してください。

    3. スタートアップ コマンド: これにより、起動時に実行される検証 OS イメージに.EXE ファイルを追加できます。

  7. [次へ] をクリックして出力画面に移動します。

  8. 出力画面では、

    1. 出力 WIM ファイルとその他のコンポーネントが生成されるフォルダーを選択します (既定値は C:\ValidationOS)

    2. 検証 OS イメージ (WIM) が USB ドライブまたはハード ドライブ (既定では USB) から起動するかどうかを指定します

    3. 検証 OS イメージ ビルダーで、生成されたカスタム検証 OS イメージに関連付けられている SDK を生成するかどうかを選択します

    4. 最近使用した検証 OS イメージ ビルダーの設定をテンプレート ファイルに保存して、今後使用できるようにします

  9. [次へ] をクリックして、[確認と完了] 画面に移動します。この画面には、最後に選択したすべての機能、ドライバー、出力設定が表示されます。

  10. [作成] をクリックして検証 OS イメージを生成します。

  11. 検証 OS イメージが生成されると、新しく生成された ValidationOS.wim が表示される出力フォルダーに移動するオプションが表示されます。

注

ValidationOS-2.wim は GenImageOutput フォルダーにも生成されます。 これは、ドライバー画面で選択したブートの種類に関連するパーティションのみを含む最適化されたイメージです

検証 OS イメージ ビルダーのコマンド ラインの使用

検証 OS イメージ ビルダー GUI で使用できるすべての機能は、検証 OS イメージ ビルダーのコマンド ラインからも使用できます。 Validation OS Image Builder コマンド ine を使用するには、ISO がマウントされたドライブ<ISO_ROOT>:フォルダー<ISO_ROOT>:\IBCLI移動します。

検証 OS Image Builder コマンド ライン ユーティリティは、 ValidationOSImageBuilderCLI.exeと呼ばれます。

使用できるコマンド ライン オプションの一覧を次に示します。

-l, --list List all features included in the ISO

-i, --info <info> Get the description of a specific feature

-rp, --resolve <resolve> List all packages included by a set of features

-f, --features <features> Specify features to include

-d, --drivers <drivers> Specify the driver folder path

-s, --software <software> Specify the software folder path

-r, --registry <registry> Specify the registry file path

-sc, --startup-command <startup-command> Specify the startup command file path

-o, --output <output> Specify the output folder path

-sdk, --generate-sdk Generate SDK solution

-st, --save-template Save settings to a template

-g, --generate-image Trigger image generation

-api, --generate-api Generate API Surface from features

-lt, --load-template <load-template> Load a template file

-bt, --boottype <boottype> Specify the boot type (USB/InternalDisk).
        Default is USB

--version Show version information

-?, -h, --help Show help and usage information

コマンド ライン オプションを使用する方法の例は、実行時に表示されます。 ValidationOSImageBuilderCLI -h

生成された SDK の使用

生成された SDK を使用するには、コンピューターに Microsoft Visual Studio がインストールされている必要があります。

エクスプローラーで、sdk という名前のフォルダーが表示される出力フォルダー (通常は C:\ValdationOS<Date-Time of image creation>) に移動します。 このフォルダー内に .sln ファイルが表示されます。 このファイルをダブルクリックして Visual Studio で開きます。

Visual Studio の ソリューション エクスプローラー ビューに、 .cpp ファイルが表示されます。 このファイルは、自分のコードで編集することも、独自のコード ファイルをこのプロジェクトに追加することもできます。 プロジェクトが参照する Nuget パッケージを表示するには、[ソリューション エクスプローラー] ビューで [参照] を右クリックし、[Nuget パッケージの管理] を選択します。

ソリューションをビルドするには、メイン メニューから [ビルド ] を選択し、[ ソリューションのビルド ] を選択します。これにより、カスタム検証 OS イメージのこのコードから .exe ファイルが生成されます。

apisurface.xml での APIValidator の使用

ValidationOS.wim イメージと共に、Image Builder は api フォルダーに apisurface.xml ファイルも生成します。 このファイルには、カスタム ValidationOS.wim イメージでサポートされているすべての API 関数の参照リストが含まれています。

APIValidator.exe と呼ばれるツールを任意の .exe ファイルと共に使用し、この apisurface.xml ファイルを入力として使用して、.exe ファイルとカスタム ValidationOS.wim イメージの間に非互換性があるかどうかを判断できます。

APIValidator.exeをインストールするには、ファイル <ISO_ROOT>:\SDK\ValidationOS_System_Kit-APIValidator_Usage.txtの手順を参照してください。 まず WDK をインストールする必要があります。 インストールすると、API サーフェス ファイルに対して .exe ファイルを分析する一般的なコマンドは次のようになります。

Apivalidator.exe -BinaryPath:"<Path to .exe file>" -SupportedApiXmlFiles:"<Path to apisurface.xml file>"

出力には、エラーの一覧 (存在する場合) と互換性のない依存関係の詳細が表示されます。

検証 OS Image Builder SDK のサンプル

検証 OS イメージ ビルダーで提供されているさまざまな機能を利用するコード サンプルは、ここで確認できます。 https://github.com/microsoft/validation-OS