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 do arquivo ou pelo 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á incorporado em um armazenamento do arquivo .msi, em vez de como 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 incorporados dentro do arquivo .msi e que transform3.mst é um arquivo autônomo.
TRANSFORMS=:transform1.mst;:transform2.mst;transform3.mst
O instalador requer 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 de 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 política TransformsAtSource ou TRANSFORMSATSOURCE mesma forma que a política TransformsSecure e TRANSFORMSSECURE. Observe que as transformações incorporadas no arquivo .msi não são armazenadas em cache e são sempre obtidas do pacote.
| Propriedade TRANSFORMS | Transforma-se Seguro | Cache e resiliência |
|---|---|---|
@[lista de nomes de arquivos] Exemplo:@transform1.mst;transform2.mst; transform3.mst |
Sem efeito. | Secure-At-Source transforma. 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 onde 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 fonte para restaurar o cache. O método é o mesmo que pesquisar um arquivo .msi na lista de fontes. Consulte Resiliência da fonte. |
[lista de caminhos] Exemplo:\|\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst |
Sem efeito. | Secure-Full-Path transforma. A origem de cada transformação deve estar no caminho completo passado para TRANSFORMS. A fonte de 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 onde 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 arquivos] O primeiro caractere não é @ ou |. Exemplo: transform1.mst;transform2.mst;transform3.mst |
política TransformsSecure ou TRANSFORMSSECURE definido como 1 OU política TransformsAtSource ou TRANSFORMSATSOURCE definido como 1. |
Se TRANSFORMS for uma lista de nomes de arquivos, o instalador os trata como Secure-At-Source transforma. Se TRANSFORMS for uma lista de caminhos completos, o instalador os tratará como Secure-Full-Path transforma. |
| [lista de nomes de arquivos] O primeiro caractere não é @ ou |. Exemplo: transform1.mst;transform2.mst;transform3.mst |
de política TransformsSecure e TRANSFORMSSECURE não estão definidos E da política TransformsAtSource e TRANSFORMSATSOURCE não estão definidos. |
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 faça roaming entre computadores enquanto mantém suas personalizações. Para uma instalação por máquina, a transformação é salva na pasta %windir%\Installer. Se a cópia local da transformação ficar indisponível, o instalador procurará uma fonte para restaurar o cache. O método é o mesmo que pesquisar um arquivo .msi na lista de fontes. Consulte Resiliência da fonte. |
| [lista de caminhos] O primeiro caractere não é @ ou |. Exemplo: \\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst |
da política TransformsAtSource e TRANSFORMSSECURE não estão definidos E da política TransformsAtSource e TRANSFORMSSECURE não estão definidos. |
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 faça roaming entre computadores enquanto mantém suas personalizações. Para uma instalação por máquina, a transformação é salva na pasta %windir%\Installer. Se a cópia local da transformação ficar indisponível, o instalador procurará uma fonte para restaurar o cache. O método é o mesmo que pesquisar um arquivo .msi na lista de fontes. Consulte Resiliência da fonte. |
Não é possível usar nomes de arquivos e caminhos juntos na mesma lista TRANSFORMS. Não é possível especificar transformações seguras e de perfil juntas na mesma lista. Você pode incluir transformações incorporadas 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, ponto-e-vírgula não deve ser usado em um nome de arquivo ou caminho de transformação.
Comentários
Nos casos em que a política TransformsSecure ou a propriedadeTRANSFORMSSECURE foi definida com o Windows Installer, não é necessário passar o @ ou | ao definir TRANSFORMA usando a linha de comando. O instalador assume Secure-At-Source ou Secure-Full-Path se a lista consistir inteiramente de nomes de arquivos localizados na origem ou consistir inteiramente de caminhos completos. Ainda não é possível misturar os dois tipos de fontes 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, consulte Transformações não seguras.
Requerimentos
| Exigência | Valor |
|---|---|
| Versão |
Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer no Windows Server 2003 ou Windows XP. Consulte o Requisitos do Windows Installer Run-Time para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer. |
Ver também