TRANSFORMS 属性

TRANSFORMS 属性是安装包时安装程序应用的转换列表。 安装程序按属性中列出的相同顺序应用转换。 转换可由其文件名或完整路径指定。 若要指定多个转换,请使用分号 (;) 分隔每个文件名或完整路径。 例如,若要将三个转换应用于包,请将 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 属性 转换安全 Caching和复原能力
@[文件名列表] 示例:
@transform1.mst;transform2.mst;transform3.mst
无效。 安全源转换。 转换的源必须位于包的源的根目录中。 安装或播发包时,安装程序会将转换保存在用户计算机上,该缓存中用户没有写入访问权限。 如果转换的本地副本变得不可用,安装程序会搜索源来还原缓存。 该方法与搜索.msi文件的源列表相同。 请参阅源复原。
[路径列表]例子:
\server\share\path\transform1.mst;\server2\share2\path2\transform2.mst 无效。 Secure-Full-Path 转换。 每个转换的源必须位于传递给 TRANSFORMS 的完整路径。 转换源不必位于包的源处。 安装或播发包时,安装程序会将转换保存在用户计算机上,该缓存中用户没有写入访问权限。 如果转换的本地副本变得不可用,安装程序只能从指定路径的源还原缓存。
[文件名列表]第一个字符不是 @ 或 .
示例:
transform1.mst;transform2.mst;transform3.mst
TransformsSecure 策略TRANSFORMSSECURE 设置为 1 OR
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文件的源列表相同。 请参阅源复原。

 

不能在同一 转换 列表中同时使用文件名和路径。 不能在同一列表中同时指定安全转换和配置文件转换。 可以将嵌入在包含其他转换的包中的转换包含在列表中。

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

请注意,由于转换的列表分隔符是分号字符,因此不能在转换文件名或路径中使用分号。

注解

如果使用 Windows Installer 设置 TransformsSecure 策略TRANSFORMSSECURE 属性,则使用命令行设置 TRANSFORMS 时,无需传递 @ 或|符号。 如果列表完全由位于源处的文件名组成,或者完全包含完整路径,则安装程序假定 Secure-At-Source 或 Secure-Full-Path。 你仍然不能混合这两种类型的转换源。

请注意,安装程序对首次应用不安全的转换使用不同的搜索顺序和维护安装。 有关详细信息,请参阅 不安全转换

要求

要求
版本
Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows 安装程序。 有关 Windows Installer 版本所需的最低Windows Service Pack 的信息,请参阅Windows安装程序Run-Time要求

请参阅

属性

数据库转换

合并和转换

源复原能力