TRANSFORMS プロパティ

TRANSFORMS プロパティは、パッケージをインストールするときにインストーラーが適用する変換の一覧です。 インストーラーは、プロパティで指定されているのと同じ順序で変換を適用します。 変換は、ファイル名または完全なパスで指定できます。 複数の変換を指定するには、各ファイル名または完全なパスをセミコロン (;) で区切ります。 たとえば、3 つの変換をパッケージに適用するには、TRANSFORMS にファイル名の一覧または完全なパスの一覧を設定します。

TRANSFORMS=transform1.mst;transform2.mst;transform3.mst
TRANSFORMS=\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst;\\server3\share3\path3\transform3.mst

ファイル名の前にコロン (:) を付けることで、変換ファイルを、スタンドアロン ファイルとして使うのではなく、.msi ファイルのストレージに埋め込むことを指定できます。 たとえば、次に示す例では、transform1.mst と transform2.mst は .msi ファイル内に埋め込まれており、transform3.mst はスタンドアロン ファイルです。

TRANSFORMS=:transform1.mst;:transform2.mst;transform3.mst

インストーラーによるパッケージのすべてのインストール、アドバタイズ、オンデマンド インストール、またはメンテナンス インストールにおいて、TRANSFORMS で指定された変換の一覧が必要です。 TransformsSecure ポリシー、TRANSFORMS プロパティ、および TRANSFORMS 文字列の最初の文字は、スタンドアロン変換ファイルのソースの回復性を処理する方法をインストーラーに通知します。 Windows インストーラーは、TransformsAtSource ポリシーまたは TRANSFORMSATSOURCE の設定を、TransformsSecure ポリシーや TRANSFORMSSECURE と同じように扱います。 .msi ファイルに埋め込まれた変換はキャッシュされず、常にパッケージから取得されることに注意してください。

同じ TRANSFORMS 一覧でファイル名とパスを同時に使うことはできません。 セキュリティ保護された変換とプロファイル変換を同じ一覧で同時に指定することはできません。 パッケージに埋め込まれた変換を、他の変換と共に一覧に含めることができます。

@transform1.mst;:transform2.mst 
|\\server\share\path\transform1.mst;:transform2.mst

変換の一覧の区切り記号はセミコロン文字なので、変換のファイル名またはパスではセミコロンを使えないことに注意してください。

解説

TransformsSecure ポリシーまたは TRANSFORMSSECURE プロパティが Windows インストーラーで設定されている場合、コマンド ラインを使って TRANSFORMS を設定するときに、@ または | 記号を渡す必要はありません。 一覧がソースにあるファイル名だけ、または完全なパスだけで構成されている場合、インストーラーは Secure-At-Source または Secure-Full-Path を想定します。 2 種類の変換ソースを混在させることはできません。

初回とメンテナンスのインストール時にインストーラーが適用する検索順序が、セキュリティ保護されていない変換の場合は異なることに注意してください。 詳しくは、「セキュリティで保護されていない変換」をご覧ください。

必要条件

関連項目

プロパティ

データベース変換

マージと変換

ソースの回復性