Setup.exe Bootstrapper サンプルの操作

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

Setup.exe Bootstrapper サンプルを使用するために、Setup.exe が実行する操作をどのように実装しているかについて理解する必要はありません。Setup.exe が特定の操作をどのように実行するかについての詳細は、アプリケーションと共に .NET Framework をインストールするカスタムセットアッププログラムを作成する開発者向けに提供されています。

Setup.exe Bootstrapper のサンプルは、自動的に次の操作を実行します。

.NET Framework がインストールされているかどうかの確認
Dotnetfx.exe のサイレントインストールの実行
インストール中の一般的なエラーコードの処理
アプリケーションの MSI セットアップの呼び出しおよびアプリケーションのインストール完了前の再起動の禁止

.NET Framework がインストールされているかどうかの確認

Setup.exe Bootstrapper サンプルでは、.NET Framework がインストールされているかどうかを確認するセットアッププログラムをラップするために使用するコードを示します。このコードは、.NET Framework の指定されたバージョン番号が次のレジストリキーに存在するかどうかを確認します。

HKLM\SOFTWARE\Microsoft\.NETFramework\policy\v1.0

確認するバージョン番号は Dotnetfx.exe から取得されます。このコードは、レジストリキー内のビルド番号と、アプリケーションでホストされる .NET Framework のビルド番号を比較します。上記の場所のレジストリキーに一致するビルド番号がない場合、Setup.exe はアプリケーションによってホストされる .NET Framework のバージョンをインストールします。

Setup.exe で .NET Framework のビルド番号と言語バージョンを確認する場合は、確認する言語のカルチャ名を Settings.ini ファイルで指定する必要があります。カルチャ名を指定しない場合、Setup.exe は既定で英語バージョンを確認します。カルチャ名の指定方法については、「アプリケーションによる Setup.exe Bootstrapper サンプルの使用」トピックを参照してください。

Dotnetfx.exe のサイレントインストールの実行

Setup.exe では、次のコマンドを使用して、Dotnetfx.exe のサイレントインストールを実行します。

dotnetfx.exe /q:a /c:"install /l /q"

サイレントインストールでは、すべてのユーザーインターフェイスと、Dotnetfx.exe や Dotnetfx.exe に含まれている Install.exe から返されるエラーメッセージが表示されません。サイレントインストールの /q:a オプションおよび /q オプションを指定することによって、ユーザーによるインストール作業を標準化できます。/l オプションを指定すると、%temp% ディレクトリにセットアップログファイル Netfx.log が作成され、すべてのエラーが記録されます。

インストール中の一般的なエラーコードの処理

Setup.exe Bootstrapper サンプルで処理される一般的なエラーを、次の表に示します。

エラー	既定のエラーメッセージ
3010	Setup requires a reboot.Would you like to reboot now? 再起動が必要です。
8192	Setup requires a reboot.Would you like to reboot now? Windows インストーラをインストールした後で、コンピュータを再起動する必要があります。
4101	Another instance of setup is already running. セットアップの別のインスタンスが実行されている場合、そのインスタンスが続行され、現在のインストールは続行できません。
4097	You do not have the permissions necessary to install this application.Please contact your administrator. Windows NT では、インストールやアンインストールには管理者権限が必要です。
1633	Your computer is not configured properly to run this application.Please contact support. 無効なプラットフォームです。
上記以外のすべてのエラー	Setup has encountered errors.Installation cannot proceed. セットアップ中に致命的なエラーが発生しました。Dotnetfx.exe のインストールを続行できません。

アプリケーションの MSI セットアップの呼び出しおよびアプリケーションのインストール完了前の再起動の禁止

ホストアプリケーションの MSI セットアップ myapp.msi を呼び出すコマンドを次に示します。REBOOT=ReallySuppress オプションは、myapp のインストールが完了するまでコンピュータの再起動を禁止します。

msiexec /i myapp.msi REBOOT=ReallySuppress

Setup.exe Bootstrapper サンプルでは、ホストアプリケーション myapp によって生成されたエラーコードをチェックする必要はありません。なぜなら、このインストールはサイレントインストールではなく、すべてのエラーは Windows インストーラのユーザーインターフェイスでユーザーに表示されるからです。