Propriedade TRANSFORMS

A propriedade TRANSFORMS é uma lista das transformações que o instalador aplica ao instalar o pacote. O instalador aplica as transformações na mesma ordem em que estão listadas na propriedade. As transformações podem ser especificadas pelo nome de arquivo ou caminho completo. Para especificar várias transformações, separe cada nome de arquivo ou caminho completo com um ponto e vírgula (;). Por exemplo, para aplicar três transformações a um pacote, defina TRANSFORMS para uma lista de nomes de arquivo ou para uma lista de caminhos completos.

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

Você pode indicar que um arquivo de transformação está inserido em um armazenamento do arquivo .msi, em vez de ser um arquivo autônomo, prefixando o nome do arquivo com dois-pontos (:). Por exemplo, o exemplo a seguir indica que transform1.mst e transform2.mst estão inseridos no arquivo .msi e que transform3.mst é um arquivo autônomo.

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

O instalador exige as transformações listadas em TRANSFORMS em cada instalação, anúncio, instalação sob demanda ou instalação de manutenção do pacote. A política TransformsSecure, a propriedade TRANSFORMS e o primeiro caractere da cadeia de caracteres TRANSFORMS informam ao instalador como lidar com a resiliência de origem de arquivos de transformação autônomos. O Windows Installer trata a configuração da política transformsAtSource ou TRANSFORMSATSOURCE da mesma forma que trata a política TransformsSecure e TRANSFORMSSECURE. Observe que as transformações inseridas no arquivo .msi não são armazenadas em cache e sempre são obtidas a partir do pacote.

Propriedade TRANSFORMS	Transformações seguras	Armazenamento em cache e resiliência
@[lista de nomes de arquivo] Exemplo: @transform1.mst;transform2.mst; transform3.mst	Nenhum efeito.	Transformações de origem segura. A origem das transformações deve estar na raiz da origem do pacote. Quando o pacote é instalado ou anunciado, o instalador salva as transformações no computador do usuário em um cache em que o usuário não tem acesso de gravação. Se a cópia local da transformação ficar indisponível, o instalador procurará uma origem para restaurar o cache. O método é o mesmo que pesquisar na lista de origem um arquivo .msi. Confira Resiliência de origem.
[lista de caminhos] Exemplo: \|\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst	Nenhum efeito.	Transformações de caminho completo seguro. A origem de cada transformação deve estar no caminho completo passado para TRANSFORMS. A origem da transformação não precisa estar localizada na origem do pacote. Quando o pacote é instalado ou anunciado, o instalador salva as transformações no computador do usuário em um cache em que o usuário não tem acesso de gravação. Se a cópia local da transformação ficar indisponível, o instalador só poderá restaurar o cache da origem no caminho especificado.
[lista de nomes de arquivo] O primeiro caractere não é @ ou |. Exemplo: transform1.mst;transform2.mst;transform3.mst	A Política TransformsSecure ou TRANSFORMSSECURE definida como 1 OU Política TransformsAtSource ou TRANSFORMSATSOURCE definida como 1.	Se TRANSFORMS for uma lista de nomes de arquivo, o instalador os tratará como Transformações de origem segura. Se TRANSFORMS for uma lista de caminhos completos, o instalador os tratará como Transformações de caminho completo seguro.
[lista de nomes de arquivo] O primeiro caractere não é @ ou |. Exemplo: transform1.mst;transform2.mst;transform3.mst	A Política TransformsSecure e TRANSFORMSSECURE não são definidas E A Política TransformsAtSource e TRANSFORMSATSOURCE não são definidas.	Transformações não seguras. A origem das transformações deve estar na raiz da origem do pacote. Quando o pacote é instalado ou anunciado por usuário, o instalador salva as transformações no perfil do usuário. Isso permite que um usuário use perfil móvel entre computadores enquanto mantém as suas personalizações. Para uma instalação por computador, a transformação é salva na pasta %windir%\Installer. Se a cópia local da transformação ficar indisponível, o instalador procurará uma origem para restaurar o cache. O método é o mesmo que pesquisar na lista de origem um arquivo .msi. Confira Resiliência de origem.
[lista de caminhos] O primeiro caractere não é @ ou |. Exemplo: \\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst	A Política TransformsAtSource e TRANSFORMSSECURE não são definidas E A Política TransformsAtSource e TRANSFORMSSECURE não são definidas.	Transformações não seguras. Quando o pacote é instalado ou anunciado por usuário, o instalador salva as transformações no perfil do usuário. Isso permite que um usuário use perfil móvel entre computadores enquanto mantém as suas personalizações. Para uma instalação por computador, a transformação é salva na pasta %windir%\Installer. Se a cópia local da transformação ficar indisponível, o instalador procurará uma origem para restaurar o cache. O método é o mesmo que pesquisar na lista de origem um arquivo .msi. Confira Resiliência de origem.

 

Você não pode usar nomes de arquivo e caminhos na mesma lista TRANSFORMS. Você não pode especificar transformações seguras e de perfil na mesma lista. Você pode incluir transformações inseridas no pacote em uma lista com outras transformações.

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

Observe que, como o delimitador de lista para transformações é o caractere ponto e vírgula, os ponto-e-vírgulas não devem ser usados em um nome de arquivo ou caminho de transformação.

Comentários

Nos casos em que a política TransformsSecure ou a propriedade TRANSFORMSSECURE foi definida com o Windows Installer, não é necessário passar o símbolo de @ ou | ao definir TRANSFORMS usando a linha de comando. O instalador considera a origem segura ou o caminho completo seguro se a lista for composta inteiramente de nomes de arquivo localizados na origem ou inteiramente de caminhos completos. Você ainda não pode misturar os dois tipos de origens de transformação.

Observe que o instalador usa uma ordem de pesquisa diferente para transformações não seguras aplicadas durante a primeira vez e instalações de manutenção. Para obter mais informações, confira Transformações não seguras.

Requisitos

Requisito

Valor

Versão

Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.

Confira também

Propriedades

Transformações de banco de dados

Mesclagens e transformações

Resiliência de origem