REINSTALLMODE プロパティ
REINSTALLMODE プロパティは、実行する再インストールの種類を指定する文字が含まれている文字列です。 オプションは大文字と小文字が区別されず、順序には依存しません。 このプロパティは通常、常に REINSTALL プロパティと組み合わせて使用する必要があります。 ただし、このプロパティは再インストールだけでなく、インストール中にも使用できます。
注意
Windows インストーラーは、管理インストール中には REINSTALLMODE プロパティを無視します。
既定では、REINSTALLMODE は "omus" です。
コード | オプション |
---|---|
p | ファイルがない場合にのみ再インストールします。 |
o | ファイルがないか、または以前のバージョンである場合に再インストールします。 |
e | ファイルがないか、または同じバージョンか以前のバージョンである場合に再インストールします。 |
d | ファイルがないか、または別のバージョンが存在する場合に再インストールします。 |
c | チェックサム値を検証し、それらがないか、または破損している場合にファイルを再インストールします。 このフラグは、File テーブルの Attributes 列に msidbFileAttributesChecksum が存在するファイルのみを修復します。 |
a | チェックサムまたはバージョンには関係なく、すべてのファイルが強制的に再インストールされます。 |
u |
Registry テーブルのレジストリ エントリのうち、HKEY_CURRENT_USER または HKEY_USERS レジストリ ハイブに移動する必要なすべてのエントリを書き換えます。 |
m |
Registry テーブルのレジストリ エントリのうち、HKEY_LOCAL_MACHINE または HKEY_CLASSES_ROOT レジストリ ハイブに移動する必要なすべてのエントリを書き換えます。 マシンまたはユーザーの割り当てには関係なく、Class テーブル、Verb テーブル、PublishComponent テーブル、ProgID テーブル、MIME テーブル、Icon テーブル、Extension テーブル、AppID テーブルのすべての情報を書き換えます。 すべての修飾されたコンポーネントを再インストールします。アプリケーションを再インストールするとき、このオプションは RegisterTypeLibraries および InstallODBC アクションを実行します。 |
s | すべてのショートカットを再インストールし、すべてのアイコンを再キャッシュして、既存のショートカットとアイコンをすべて上書きします。 |
v | ソース パッケージから実行し、ローカル パッケージを再キャッシュする場合に使用します。 アプリケーションまたは機能の最初のインストールでは、v の再インストール オプション コードを使用しないでください。 |
REINSTALLMODE プロパティが定義されていても、同時に REINSTALL プロパティが定義されていない場合は、指定された "検出" モードが引き続き適用され、通常のインストールに対して "上書き" モードが指定されます。 REINSTALLMODE プロパティは、インストールに対して通常選択される機能にのみ影響を与えます。 REINSTALLMODE プロパティが存在していても、機能が再インストールされるわけではありません。 機能を再インストールするには、REINSTALL プロパティが存在する必要があります。
このプロパティのオプション コードは、コマンド ライン オプションの "/f" に対応します。 コマンド ライン オプションには、"pecms" という既定値があります。
注意
検証して修復されるのは、チェックサム情報が含まれているファイルだけです。 REINSTALLMODE_FILEVERIFY フラグ (上記の c コード) は、File テーブルの Attributes 列に msidbFileAttributesChecksum が存在するファイルのみを修復します。
要件 | 値 |
---|---|
バージョン |
Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー。 Windows インストーラーのバージョン別に必須となる最小 Windows サービス パックに関する詳細については、Windows インストーラーの実行時の要件に関する記事を参照してください。 |