Installer.ApplyPatch メソッド
パッチを受け取る対象としてパッチ パッケージによって一覧表示されている各製品について、Installer オブジェクトの ApplyPatch メソッドでインストールを呼び出し、PATCH プロパティをパッチ パッケージのパスに設定します。
構文
Installer.ApplyPatch(
PatchPackage,
InstallPackage,
InstallType,
CommandLine
)
パラメーター
-
PatchPackage
-
パッチ パッケージへのパスを指定します。
-
InstallPackage
-
"InstallType" が msiInstallTypeNetworkImage に設定されている場合、"InstallPackage" はパッチを適用する製品へのパスを指定します。 InstallType が msiInstallTypeDefault に設定され、InstallPackage が 0 に設定されている場合、インストーラーではパッチ パッケージに記載されているすべての対象製品にパッチを適用します。
InstallType が msiInstallTypeSingleInstance の場合、インストーラーでは InstallPackage で指定された製品にパッチを適用します。 この場合、パッチ パッケージに一覧表示されている他の対象製品は無視され、InstallPackage パラメーターには、パッチを適用するインスタンスの製品コードを表す null で終わる文字列が含まれています。 この種類のインストールには、Windows Server 2003 以降または Windows インストーラー XP SP1 以降に付属している Windows インストーラーのバージョンが必要です。
-
InstallType
-
このパラメーターでは、パッチを適用するインストールの種類を指定します。 InstallPackage を省略した場合、InstallType パラメーターは無視されます。
値 説明 - msiInstallTypeNetworkImage
管理インストールを指定します。 この場合、InstallPackage はパッケージ パスに設定する必要があります。 msiInstallTypeNetworkImage の値 1 は、管理インストールを指定します。 - msiInstallTypeDefault
パッチを適用する製品をシステムで検索します。 この場合、InstallPackage は 空の文字列である必要があります。 - msiInstallSingleInstance
InstallPackage で指定された製品にパッチを適用します。 InstallPackage は、パッチを適用するインスタンスの製品コードです。 この種類のインストールには、Windows Server 2003 以降または Windows インストーラー XP SP1 以降に付属している Windows インストーラーのバージョンが必要です。 詳細については、「製品とパッチの複数のインスタンスをインストールする」を参照してください。 -
CommandLine
-
コマンド ラインで設定するプロパティ設定を指定します。 「解説」を参照してください。
戻り値
このメソッドは値を返しません。
解説
変換、ソース、パッチのリスト区切り記号はセミコロンであるため、この文字はファイル名やパスには使用しないでください。
小規模な更新プログラムまたはマイナー アップグレードのパッチを適用する場合は、REINSTALL プロパティが必要です。 このプロパティがないと、パッチはシステムに登録されますが、ファイルを更新することはできません。
Windows インストーラー 2.0:小さな更新プログラムまたはマイナー アップグレードのパッチを適用する場合は、コマンド ラインで REINSTALL プロパティを設定する必要があります。 REINSTALL プロパティと REINSTALLMODE プロパティを自動的に設定するためのカスタム アクションの種類 51 を使用しないパッチの場合、REINSTALL プロパティは CommandLine パラメーターを使用して明示的に設定する必要があります。 REINSTALL プロパティを設定して、パッチの影響を受ける機能を一覧表示するか、実際の既定の設定である "REINSTALL=ALL" を使用します。 REINSTALLMODE プロパティの既定値は "omus" です。
Windows インストーラー 3.0 以降: Windows インストーラー バージョン 3.0 以降では、REINSTALL プロパティはインストーラーによって構成され、コマンド ラインで設定する必要はありません。
必要条件
要件 | 値 |
---|---|
バージョン |
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 インストーラー 3.0 以降。 |
[DLL] |
|
IID |
IID_IInstaller が 000C1090-0000-0000-C000-000000000046 として定義されている |
こちらもご覧ください