RemoveExistingProducts アクション

RemoveExistingProducts アクションは、アップグレード テーブル の ActionProperty 列に一覧表示されている製品コードを通過し、同時実行インストールを呼び出して順番に製品を削除します。 インストーラーは、同時実行インストールごとに、ProductCode プロパティを製品コードに設定し、REMOVE プロパティを Upgrade テーブルの [削除] フィールドの値に設定します。 [削除] フィールドが空白の場合、その値の既定値は ALL になり、インストーラーによって製品全体が削除されます。

インストーラーは、初めて製品をインストールするときにのみ RemoveExistingProducts アクションを実行します。 メンテナンスインストール またはアンインストール中はアクションは実行されません。

シーケンスの制限

RemoveExistingProducts アクションは、次のいずれかの場所にあるアクション シーケンスでスケジュールする必要があります。

• InstallValidate アクション と InstallInitialize アクション。 この場合、インストーラーは、新しいアプリケーションをインストールする前に古いアプリケーションを完全に削除します。 再利用されたすべてのファイルを再コピーする必要があるため、これはアクションの非効率的な配置です。
• InstallInitialize アクション 後、実行スクリプトを生成するアクションの前に実行します。
• InstallExecute アクション、または InstallExecuteAgain アクションと InstallFinalize アクションの間。 通常、最後の 3 つのアクションは、InstallExecute、RemoveExistingProducts、および InstallFinalize の直後にスケジュールされます。 この場合、更新されたファイルが最初にインストールされ、古いファイルが削除されます。 ただし、古いアプリケーションの削除が失敗した場合、インストーラーは古いアプリケーションの削除と新しいアプリケーションのインストールの両方をロールバックします。
• InstallFinalize アクションの後。 これは、アクションの最も効率的な配置です。 この場合、インストーラーは古いアプリケーションを削除する前にファイルを更新します。 更新中のファイルのみがインストールされます。 古いアプリケーションの削除が失敗した場合、インストーラーは古いアプリケーションのアンインストールのみをロールバックします。

ActionData メッセージ

備考

Windows インストーラーは、このアクションの実行時に UPGRADINGPRODUCTCODE プロパティを設定します。