トレーニング
モジュール
Windows パッケージ マネージャー ツールの詳細を確認する - Training
Windows パッケージ マネージャーを使い、コンピューターへのソフトウェアのインストールとメンテナンスを効率化します。 フロントエンドのコンポーネントとコマンド、Windows パッケージ マネージャー リポジトリ、リポジトリへの貢献方法について説明します。
コマンドライン オプション
パッケージを解釈して製品をインストールする実行可能プログラムは Msiexec.exe です。 Msiexec では、システム エラー コードに対応するエラー レベルが戻り値に設定されることにも注意してください。 コマンドライン オプションでは、大文字と小文字は区別されません。
次の表のコマンド ライン オプションは、Windows インストーラー 3.0 以前のバージョンで使用できます。 Windows インストーラー 3.0 以降では、標準インストーラーのコマンド ライン オプションも使用できます。
| オプション | パラメーター | 説明 |
|---|---|---|
| /I | Package|ProductCode | 製品をインストールまたは構成します。 |
| /f | [p|o|e|d|c|a|u|m|s|v] Package|ProductCode | 製品を修復します。 このオプションでは、コマンド ラインに入力されたプロパティ値が無視されます。 このオプションの既定の引数リストは 'omus' です。 このオプションでは、 REINSTALLMODE プロパティと同じ引数リストが共有されます。 p - ファイルが見つからない場合にのみ再インストールします。 o - ファイルが見つからないか、古いバージョンがインストールされている場合にのみ再インストールします。 e - ファイルが見つからないか、同じまたは古いバージョンがインストールされている場合にのみ再インストールします。 d - ファイルが見つからないか、別のバージョンがインストールされている場合にのみ再インストールします。 c - ファイルが見つからない場合、または格納されているチェックサムが計算値と一致しない場合に再インストールします。 File テーブルの Attributes 列に msidbFileAttributesChecksum が存在するファイルのみを修復します。 a - すべてのファイルを強制的に再インストールします。 u - 必要なすべてのユーザー固有のレジストリ エントリを書き換えます。 m - 必要なすべてのコンピューター固有のレジストリ エントリを書き換えます。 s - 既存のすべてのショートカットを上書きします。 v - ソースから実行され、ローカル パッケージが再キャッシュされます。 アプリケーションまたは機能の最初のインストールでは、v の再インストール オプションを使用しないでください。 |
| /a | パッケージ |
管理インストール オプション。 ネットワークに製品をインストールします。 |
| /x | Package|ProductCode | 製品をアンインストールします。 |
| /j | [u|m]Packageor [u|m]Package/tTransform List or [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" と指定します。
注: |
| /m |
ファイル名
注: |
SMS 状態の .mif ファイルを生成します。 インストール (-i)、削除 (-x)、管理インストール (-a)、または再インストール (-f) オプションのいずれかで使用する必要があります。 ISMIF32.DLL は SMS の一部としてインストールされ、パス上にある必要があります。 状態 mif ファイルのフィールドには、次の情報が入力されます。 Manufacturer - Author (作成者) Product - Revision Number (リビジョン番号) Version - Subject (サブジェクト) Locale - Template (テンプレート) Serial Number - 未設定 Installation - ISMIF32.DLLによって "DateTime" に設定される InstallStatus - "Success" または "Failed" Description - 次の順序のエラー メッセージ: 1) インストーラーによって生成されたエラー メッセージ。 2) インストールを開始できなかったかユーザーが終了した場合は、 Msi.dll からのリソース。 3) システム エラー メッセージ ファイル。 4) 書式設定されたメッセージ: "インストーラー エラー %i"、ここで %i は Msi.dll から返されるエラー。 |
| /p | PatchPackage[;patchPackage2 ] | パッチを適用します。 インストールされている管理イメージにパッチを適用するには、次のオプションを組み合わせる必要があります。 /p <PatchPackage>[;p atchPackage2 ] /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 と入力すると、インストーラーでは Property テーブルの 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=""
リテラル引用符で分割された複数のテキストのセクションの場合は、セクションを別の引用符のペアで囲みます。
msiexec /i A:\Example.msi PROPERTY="Embedded ""Quotes"" White Space"
次の例は、複雑なコマンド ラインを示しています。
msiexec /i testdb.msi INSTALLLEVEL=3 /l* msi.log COMPANYNAME="Acme ""Widgets"" and ""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 プロパティの値は無視され上書きされます。