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 |
影響しません。 | Secure-At-Source 変換。 変換のソースは、パッケージのソースのルートにある必要があります。 パッケージがインストールまたはアドバタイズされるとき、インストーラーは変換を、ユーザーのコンピューター上の、ユーザーが書き込みアクセス権を持っていないキャッシュに保存します。 変換のローカル コピーが使用できなくなった場合、インストーラーはソースを検索してキャッシュを復元します。 方法は、ソース リストで .msi ファイルを検索する場合と同じです。 「ソースの回復性」を参照してください。 |
[<パスの一覧>] 例：\|\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst |
影響しません。 | Secure-Full-Path 変換。 各変換のソースは、TRANSFORMS に渡される完全なパスに存在する必要があります。 変換ソースをパッケージのソースに置く必要はありません。 パッケージがインストールまたはアドバタイズされるとき、インストーラーは変換を、ユーザーのコンピューター上の、ユーザーが書き込みアクセス権を持っていないキャッシュに保存します。 変換のローカル コピーが使用できなくなった場合、インストーラーは指定されたパスにあるソースからのみキャッシュを復元できます。 |
| [<ファイル名の一覧>] 最初の文字が @ または | ではない。 例: transform1.mst;transform2.mst;transform3.mst |
TransformsSecure ポリシーまたは TRANSFORMSSECURE が 1 に設定されている、または TransformsAtSource ポリシーまたは TRANSFORMSATSOURCE が 1 に設定されている。 |
TRANSFORMS がファイル名の一覧である場合、インストーラーはそれらを Secure-At-Source 変換として扱います。 TRANSFORMS が完全なパスの一覧である場合、インストーラーはそれらを Secure-Full-Path 変換として扱います。 |
| [<ファイル名の一覧>] 最初の文字が @ または | ではない。 例: transform1.mst;transform2.mst;transform3.mst |
TransformsSecure ポリシーと TRANSFORMSSECURE が設定されていない、かつ 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 種類の変換ソースを混在させることはできません。
初回とメンテナンスのインストール時にインストーラーが適用する検索順序が、セキュリティ保護されていない変換の場合は異なることに注意してください。 詳しくは、「セキュリティで保護されていない変換」をご覧ください。
必要条件
| 要件 | 値 |
|---|---|
| バージョン |
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 インストーラーの実行時の要件に関する記事を参照してください。 |
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示