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; transform3.mst |
無効。 | セキュリティで保護されたAt-Source は、変換します。 変換のソースは、パッケージのソースのルートにある必要があります。 パッケージがインストールまたはアドバタイズされると、インストーラーはユーザーのコンピューター上の変換を、ユーザーが書き込みアクセス権を持たないキャッシュに保存します。 変換のローカル コピーが使用できなくなった場合、インストーラーはソースを検索してキャッシュを復元します。 このメソッドは、ソース リストで .msi ファイルを検索する場合と同じです。 ソースの回復性 参照してください。 |
[パスの一覧]例:\|\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst |
無効。 | セキュリティで保護されたFull-Path は、変換します。 各変換のソースは、TRANSFORMSに渡される完全なパスにある必要があります。 変換ソースは、パッケージのソースに配置する必要はありません。 パッケージがインストールまたはアドバタイズされると、インストーラーはユーザーのコンピューター上の変換を、ユーザーが書き込みアクセス権を持たないキャッシュに保存します。 変換のローカル コピーが使用できなくなった場合、インストーラーは指定されたパスにあるソースからのみキャッシュを復元できます。 |
[ファイル名の一覧]最初の文字が @または |ではありません。 例: transform1.mst;transform2.mst;transform3.mst |
transformsSecure ポリシー を するか、TRANSFORMSSECUREを 1 OR に設定 TransformsAtSource ポリシー 、または TRANSFORMSATSOURCE1 に設定。 |
TRANSFORMS がファイル名の一覧である場合、インストーラーはそれらを Secure-At-Source 変換 扱います。
TRANSFORMS が完全なパスの一覧である場合、インストーラーはそれらを secure-Full-Path 変換 扱います。 |
[ファイル名の一覧]最初の文字が @または |ではありません。 例: transform1.mst;transform2.mst;transform3.mst |
TransformsSecure ポリシーの と TRANSFORMSSECUREが設定されていないAND TransformsAtSource ポリシーの と TRANSFORMSATSOURCEが設定されていません。 |
セキュリティで保護されていない変換 をします。 変換のソースは、パッケージのソースのルートにある必要があります。 パッケージがユーザーごとにインストールまたはアドバタイズされると、インストーラーによって変換がユーザーのプロファイルに保存されます。 これにより、ユーザーはカスタマイズを維持しながらコンピューター間をローミングできます。 マシンごとのインストールの場合、変換は %windir%\Installer フォルダーに保存されます。 変換のローカル コピーが使用できなくなった場合、インストーラーはキャッシュを復元するソースを検索します。 このメソッドは、ソース リストで .msi ファイルを検索する場合と同じです。 ソースの回復性 参照してください。 |
[パスの一覧]最初の文字が @または |ではありません。 例: \\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst |
TransformsAtSource ポリシー と TRANSFORMSSECUREが設定されていない TransformsAtSource ポリシーの と TRANSFORMSSECUREが設定されていません。. |
セキュリティで保護されていない変換 をします。 パッケージがユーザーごとにインストールまたはアドバタイズされると、インストーラーによって変換がユーザーのプロファイルに保存されます。 これにより、ユーザーはカスタマイズを維持しながらコンピューター間をローミングできます。 マシンごとのインストールの場合、変換は %windir%\Installer フォルダーに保存されます。 変換のローカル コピーが使用できなくなった場合、インストーラーはソースを検索してキャッシュを復元します。 このメソッドは、ソース リストで .msi ファイルを検索する場合と同じです。 ソースの回復性 参照してください。 |
同じ TRANSFORMS リスト内でファイル名とパスを一緒に使用することはできません。 セキュリティで保護された変換とプロファイル変換を同じリストにまとめて指定することはできません。 パッケージに埋め込まれた変換を、他の変換と共にリストに含めることができます。
@transform1.mst;:transform2.mst
|\\server\share\path\transform1.mst;:transform2.mst
変換のリスト区切り記号はセミコロン文字であるため、変換ファイル名またはパスではセミコロンを使用しないでください。
備考
TransformsSecure ポリシー または TRANSFORMSSECURE プロパティが Windows インストーラーで設定されている場合、@ または | を渡す必要はありません。コマンド ライン 使用して TRANSFORMS を設定する場合は 記号を使用します。 インストーラーは、リストがソースにあるファイル名で完全に構成されているか、完全なパスで構成されている場合は、Secure-At-Source または Secure-Full-Path を想定します。 2 種類の変換ソースを混在することはできません。
インストーラーでは、初回およびメンテナンスのインストール時に適用されるセキュリティで保護されていない変換に対して、異なる検索順序が使用されることに注意してください。 詳細については、「セキュリティで保護されていない変換を参照してください。
必要条件
関連項目