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 Installer 會將 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 未設定 AND 未設定 TransformsAtSource 原則 和 TRANSFORMSATSOURCE 。 |
不安全的轉換。 轉換的來源必須位於封裝的來源根目錄。 安裝或公告個別使用者的套件時,安裝程式會將轉換儲存在使用者設定檔中。 這可讓使用者在電腦之間漫遊,同時維護其自訂專案。 針對每部電腦安裝,轉換會儲存在 %windir%\Installer 資料夾中。 如果轉換的本機複本變得無法使用,安裝程式會搜尋來源以還原快取。 方法與搜尋.msi檔案的來源清單相同。 請參閱 來源復原。 |
[路徑清單]第一個字元不是 @ 或 |。 範例: \\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst |
TransformsAtSource 原則 和 TRANSFORMSSECURE 未設定 AND 未設定 TransformsAtSource 原則 和 TRANSFORMSSECURE 。 |
不安全的轉換。 安裝或公告個別使用者的套件時,安裝程式會將轉換儲存在使用者設定檔中。 這可讓使用者在電腦之間漫遊,同時維護其自訂專案。 針對每部電腦安裝,轉換會儲存在 %windir%\Installer 資料夾中。 如果轉換的本機複本無法使用,安裝程式會搜尋來源以還原快取。 方法與搜尋.msi檔案的來源清單相同。 請參閱 來源復原。 |
您無法在同一個 TRANSFORMS 清單中同時使用檔案名和路徑。 您無法在同一個清單中同時指定安全且設定檔轉換。 您可以將內嵌在套件中的轉換包含在具有其他轉換的清單中。
@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 Installer。 如需 Windows Installer 版本所需的最低 Windows Service Pack 相關資訊,請參閱 Windows Installer Run-Time需求 。 |
另請參閱