コマンドライン オプション

  • [アーティクル]

パッケージを解釈して製品をインストールする実行可能プログラムはMsiexec.exe。 Msiexec では、 システム エラー コードに対応するエラー レベルも戻り値に設定されることに注意してください。 コマンド ライン オプションでは、大文字と小文字が区別されません。

次の表のコマンド ライン オプションは、Windows Installer 3.0 以前のバージョンで使用できます。 標準インストーラー Command-Line オプションは、Windows Installer 3.0 以降でも使用できます。

オプション パラメーター 意味
/I パッケージ|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 再インストールオプションを使用しないでください。
/a Package 管理インストール オプション。 ネットワークに製品をインストールします。
/x パッケージ|Productcode 製品をアンインストールします。
/j [u|m]Packageor
[u|m]Package/tTransform リスト
or
[u|m]Package/gLanguageID
 製品をアドバタイズします。 このオプションは、コマンド ラインに入力されたプロパティ値を無視します。
u - 現在のユーザーにアドバタイズします。
m - コンピューターのすべてのユーザーにアドバタイズします。
g - 言語識別子。
t - アドバタイズされたパッケージに変換を適用します。
/L [i|w|e|a|r|u|c|m|o|v|v|x|+|!|*] ログ ファイル ログ情報を、指定された既存のパスにあるログ ファイルに書き込みます。 ログ ファイルの場所へのパスが既に存在している必要があります。 インストーラーでは、ログ ファイルのディレクトリ構造は作成されません。 フラグは、ログに記録する情報を示します。 フラグが指定されていない場合、既定値は '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" を指定します。
[!注]
ログモードの設定に使用できるすべてのメソッドの詳細については、「Windowsインストーラーログ」セクションの「通常のログ記録」を参照してください。
/m ファイル名
[!注]
ファイル名の長さは 8 文字以内にする必要があります。

携帯ショートメール状態の .mif ファイルを生成します。 インストール (-i)、remove (-x)、管理インストール (-a)、または再インストール (-f) オプションと共に使用する必要があります。 ISMIF32.DLLは携帯ショートメールの一部としてインストールされ、パス上に存在する必要があります。
状態 mif ファイルのフィールドには、次の情報が入力されます。
製造元 - 作成者
製品 - リビジョン番号
バージョン - サブジェクト
ロケール - テンプレート
シリアル番号 - 設定されていません
インストール - ISMIF32.DLLによって "DateTime" に設定されます
InstallStatus - "Success" または "Failed"
説明 - 次の順序でエラー メッセージ: 1) インストーラーによって生成されたエラー メッセージ。 2) インストールを開始できなかった場合、またはユーザーが終了できない場合は、Msi.dllからのリソース。 3)システムエラーメッセージファイル。 4) フォーマットされたメッセージ: "インストーラー エラー %i", ここで%iはエラーがMsi.dllから返されます.
/p PatchPackage[;p atchPackage2 ] パッチを適用します。 インストールされている管理イメージにパッチを適用するには、次のオプションを組み合わせる必要があります。
/p <PatchPackage>[;p atchPackage2 ] /a \ 		製品の新しいインスタンスをアドバタイズします。 /t と組み合わせて使用する必要があります。 Windows Server 2003 および Service Pack 1 (SP1) を使用Windows XP に付属するWindows インストーラー バージョンから入手できます。
/n ProductCode 製品の特定のインスタンスを指定します。 製品コード変更変換を介して複数のインスタンス サポートを使用してインストールされたインスタンスを識別するために使用されます。 Windows Server 2003 に付属する Windows インストーラー バージョンと SP1 Windows XP 以降で使用できます。

オプション /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 プロパティの値は無視され、上書きされます。