パッケージを解釈して製品をインストールする実行可能プログラムが Msiexec.exe。 Msiexec では、 システム エラー コードに対応するエラー レベルも戻り値に設定されることに注意してください。 コマンド ライン オプションでは、大文字と小文字が区別されません。
次の表のコマンド ライン オプションは、Windows インストーラー 3.0 以前のバージョンで使用できます。 標準インストーラー Command-Line オプションは、Windows インストーラー 3.0 以降でも使用できます。
| Option | パラメーター | Meaning |
|---|---|---|
| /私 | パッケージ|ProductCode | 製品をインストールまたは構成します。 |
| /f | [p|o|e|d|c|a|u|m|s|v] パッケージ|ProductCode | 製品を修復します。 このオプションは、コマンド ラインに入力されたプロパティ値を無視します。 このオプションの既定の引数リストは "omus" です。 このオプションは、 REINSTALLMODE プロパティと同じ引数リストを共有します。 p - ファイルが見つからない場合にのみ再インストールします。 o - ファイルが見つからないか、古いバージョンがインストールされている場合に再インストールします。 e - ファイルが見つからないか、同等以上のバージョンがインストールされている場合に再インストールします。 d - ファイルが見つからないか、別のバージョンがインストールされている場合に再インストールします。 c - ファイルがないか、格納されているチェックサムが計算値と一致しない場合に再インストールします。 ファイル テーブルの [属性] 列に msidbFileAttributesChecksum がある ファイル のみを修復します。 a - すべてのファイルを強制的に再インストールします。 u - 必要なすべてのユーザー固有のレジストリ エントリを書き換える。 m - 必要なすべてのコンピューター固有のレジストリ エントリを書き換える。 s - 既存のすべてのショートカットを上書きします。 v - ソースから実行し、ローカル パッケージを再キャッシュします。 アプリケーションまたは機能を最初にインストールする場合は、 v 再インストールオプションを使用しないでください。 |
| /ある | パッケージ |
管理インストール オプション。 ネットワークに製品をインストールします。 |
| /x | パッケージ|ProductCode | 製品をアンインストールします。 |
| /j | [u|m]Packageor [u|m]Package/tTransform List または [u|m]Package/gLanguageID |
製品をアドバタイズします。 このオプションは、コマンド ラインに入力されたプロパティ値を無視します。 u - 現在のユーザーにアドバタイズします。 m - コンピューターのすべてのユーザーにアドバタイズします。 g - 言語識別子。 t - アドバタイズされたパッケージに変換を適用します。 |
| /L | [i|w|e|a|r|u|c|m|o|p|v|x|+|!|*] Logfile | ログ情報を、指定された既存のパスにあるログ ファイルに書き込みます。 ログ ファイルの場所へのパスは既に存在している必要があります。 インストーラーは、ログ ファイルのディレクトリ構造を作成しません。 フラグは、ログに記録する情報を示します。 フラグが指定されていない場合、既定値は 'iwearmo'です。 i - ステータス メッセージ。 w - 致命的でない警告。 e - すべてのエラー メッセージ。 a - アクションの起動。 r - アクション固有のレコード。 u - ユーザー要求。 c - 初期 UI パラメーター。 m - メモリ不足または致命的な終了情報。 o - ディスク領域不足メッセージ。 p - ターミナルのプロパティ。 v - 詳細出力。 x - 追加のデバッグ情報。 Windows インストーラー 2.0: サポートされていません。 x オプションは、Windows インストーラー バージョン 3.0.3790.2180 以降で使用できます。 + - 既存のファイルに追加します。 ! - 各行をログにフラッシュします。 "*" - ワイルドカードを使用して、v オプションと x オプションを除くすべての情報をログに記録します。 v オプションと x オプションを含めるには、"/l*vx" を指定します。
Note: |
| /m |
filename
Note: |
SMS 状態 .mif ファイルを生成します。 インストール (-i)、remove (-x)、管理インストール (-a)、または再インストール (-f) オプションと共に使用する必要があります。 ISMIF32.DLLは SMS の一部としてインストールされ、パス上にある必要があります。 ステータス mif ファイルのフィールドには、次の情報が入力されます。 製造元 - 作成者 製品 - リビジョン番号 バージョン - サブジェクト ロケール - テンプレート シリアル番号 - 設定されていません インストール - ISMIF32.DLLで "DateTime" に設定 InstallStatus - "Success" または "Failed" 説明 - 次の順序でエラー メッセージ: 1) インストーラーによって生成されたエラー メッセージ。 2) インストールを開始できなかった場合、またはユーザーが終了できない場合は、Msi.dll からのリソース。 3)システムエラーメッセージファイル。 4) フォーマットされたメッセージ: "インストーラーエラー %i", ここで、%i は、Msi.dllからエラーが返されます. |
| /p | PatchPackage[;patchPackage2 ] | パッチを適用します。 インストールされている管理イメージにパッチを適用するには、次のオプションを組み合わせる必要があります。 /p <PatchPackage>[;patchPackage2 ] /a \<Package> |
| /q | n|b|r|f |
ユーザー インターフェイス レベルを設定します。 q、qn - UI なし qb - 基本的な UI。 qb! [ キャンセル ] ボタンを非表示にします。 qr - インストールの最後にモーダル ダイアログ ボックスが表示されない 縮小された UI 。 qf - 完全な UI と、最後に作成されたすべての FatalError、 UserExit、または Exit モーダル ダイアログ ボックス。 qn+ - 最後に表示されるモーダル ダイアログ ボックスを除き、UI はありません。 qb+ - モーダル ダイアログ ボックスが最後に表示される 基本的な UI 。 ユーザーがインストールをキャンセルした場合、モーダル ボックスは表示されません。 qb+! を使用する または qb!+ をクリックして [キャンセル ] ボタンを非表示にします。 qb- - モーダル ダイアログ ボックスのない 基本的な UI 。 /qb+- はサポートされている UI レベルではないことに注意してください。 qb-! または qb!- をクリックすると、[キャンセル ] ボタンが非表示にされます。 次の点に注意してください。 オプションは Windows インストーラー 2.0 で使用でき、基本的な UI でのみ機能します。 完全な UI では無効です。 |
| /? または /h | Windows インストーラーの著作権情報を表示します。 |
|
| /y | module | コマンド ラインで渡されたモジュールを自己登録するために、システム関数 DllRegisterServer を呼び出します。 DLL への完全なパスを指定します。 たとえば、現在のフォルダーにMY_FILE.DLLする場合は、次のコマンドを使用できます。 msiexec /y .\MY_FILE.DLL このオプションは、.msi ファイルのレジストリ テーブルを使用して追加できないレジストリ情報にのみ使用されます。 |
| /z | module | システム関数 DllUnRegisterServer を呼び出して、コマンド ラインで渡されたモジュールの登録を解除します。 DLL への完全なパスを指定します。 たとえば、現在のフォルダーにMY_FILE.DLLする場合は、次のコマンドを使用できます。 msiexec /z .\MY_FILE.DLL このオプションは、.msi ファイルのレジストリ テーブルを使用して削除できないレジストリ情報にのみ使用されます。 |
| /c | 製品の新しいインスタンスをアドバタイズします。 /t と組み合わせて使用する必要があります。 Windows Server 2003 および Windows XP Service Pack 1 (SP1) に付属する Windows インストーラー バージョン以降で使用できます。 |
|
| /n | ProductCode | 製品の特定のインスタンスを指定します。 製品コードを変更する変換を通じて、複数のインスタンス サポートを使用してインストールされたインスタンスを識別するために使用されます。 Windows Server 2003 および Windows XP SP1 に付属する Windows インストーラー バージョン以降で使用できます。 |
オプション /i、/x、/f[p|o|e|d|c|a|u|m|s|v]、/j[u|m]、/a、/p、/y、/z は一緒に使用しないでください。 この規則の 1 つの例外は、 管理インストール にパッチを適用するには 、/p と /a の両方を使用する必要があるということです。 オプション /t、/c、および /g は/j でのみ使用してください。 オプション /l および /q は、/i、/x、/f[p|o|e|d|c|a|u|m|s|v]、/j[u|m]、/a、/p と共に使用できます。 /n オプションは、/i、/f、/x、/p と共に使用できます。
A:\Example.msiから製品をインストールするには、次のように製品をインストールします。
msiexec /i A:\Example.msi
コマンド ラインを使用して変更できるのは パブリック プロパティ のみです。 コマンド ライン上のすべてのプロパティ名は大文字と解釈されますが、値では大文字と小文字が区別されます。 コマンド ラインで MyProperty を入力すると、インストーラーはプロパティ テーブルの MyProperty の値ではなく 、MYPROPERTY の値をオーバーライドします。 詳細については、「 プロパティについて」を参照してください。
PROPERTY を VALUE に設定した製品をインストールするには、コマンド ラインで次の構文を使用します。 このプロパティは、オプションとその引数の間を除き、任意の場所に配置できます。
正しい構文:
msiexec /i A:\Example.msi PROPERTY=VALUE
構文が正しくありません。
msiexec /i PROPERTY=VALUE A:\Example.msi
リテラル文字列であるプロパティ値は、引用符で囲む必要があります。 文字列内のマークの間に空白を含めます。
msiexec /i A:\Example.msi PROPERTY="Embedded White Space"
コマンド ラインを使用してパブリック プロパティをクリアするには、その値を空の文字列に設定します。
msiexec /i A:\Example.msi PROPERTY=""
リテラル引用符で区切られたテキストのセクションの場合は、セクションを 2 番目の引用符で囲みます。
msiexec /i A:\Example.msi PROPERTY="Embedded ""Quotes"" 空白
次の例は、複雑なコマンド ラインを示しています。
msiexec /i testdb.msi INSTALLLEVEL=3 /l* msi.log COMPANYNAME="Acme ""Widgets"" および ""Gizmos."""
次の例は、提供情報オプションを示しています。 スイッチでは大文字と小文字が区別されないことに注意してください。
msiexec /JM msisample.msi /T transform.mst /LIME logfile.txt
次の例は、アドバタイズする製品の新しいインスタンスをインストールする方法を示しています。 この製品は、複数のインスタンス変換をサポートするために作成されています。
msiexec /JM msisample.msi /T :instance1.mst;customization.mst /c /LIME logfile.txt
次の例は、複数のインスタンス変換を使用してインストールされた製品のインスタンスにパッチを適用する方法を示しています。
msiexec /p msipatch.msp;msipatch2.msp /n {00000001-0002-0000-0000-624474736554} /qb
特定の製品にパッチを適用する場合、コマンド ラインで /i オプションと /p オプションを一緒に指定することはできません。 この場合、次のように製品にパッチを適用できます。
msiexec /i A:\Example.msi PATCH=msipatch.msp;msipatch2.msp /qb
/p オプションが使用されている場合、 PATCH プロパティをコマンド ラインで設定することはできません。 /p オプションを使用するときに PATCH プロパティが設定されている場合、 PATCH プロパティの値は無視され、上書きされます。
次の例は、製品をアンインストールする方法を示しています。
msiexec /x msisample.msi