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 por seu 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 a uma lista de nomes de arquivo ou a 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 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 são inseridos 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 a cada instalação, anúncio, instalação sob demanda ou instalação de manutenção do pacote. A política de política TransformsSecure, a propriedade TRANSFORMS e o primeiro caractere da cadeia de caracteres TRANSFORMS informa ao instalador como lidar com a resiliência de origem dos arquivos de transformação autônomos. O Windows Installer trata a configuração de política TransformsAtSource ou TRANSFORMSATSOURCE o mesmo que a política TransformsSecure e TRANSFORMSSECURE. Observe que as transformações inseridas no arquivo .msi não são armazenadas em cache e são sempre obtidas do pacote.
| Propriedade TRANSFORMS | Transformações Seguras | Cache e resiliência |
|---|---|---|
@[lista de nomes de arquivo] Exemplo:@transform1.mst;transform2.mst; transform3.mst |
Nenhum efeito. | 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 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 para um arquivo .msi. Consulte de Resiliência de Origem. |
[lista de caminhos] Exemplo:\|\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst |
Nenhum efeito. | Full-Path transforma. 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 |
transformsSecure policy ou TRANSFORMSSECURE definido como 1 OR de política TransformsAtSource ou TRANSFORMSATSOURCE definido como 1. |
Se TRANSFORMS for uma lista de nomes de arquivo, o instalador os tratará como transformaçõesAt-Source. Se TRANSFORMS for uma lista de caminhos completos, o instalador os tratará como transformações deFull-Path seguro. |
| [lista de nomes de arquivo] O primeiro caractere não é @ ou |. Exemplo: transform1.mst;transform2.mst;transform3.mst |
de política transformsSecure e TRANSFORMSSECURE não estão definidos AND de política TransformsAtSource e TRANSFORMSATSOURCE não estão definidos. |
transformações não simultâneas. 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 percorra entre computadores enquanto mantém 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 para um arquivo .msi. Consulte de Resiliência de Origem. |
| [lista de caminhos] O primeiro caractere não é @ ou |. Exemplo: \\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst |
de política TransformsAtSource e TRANSFORMSSECURE não estão definidos AND de política TransformsAtSource e TRANSFORMSSECURE não estão definidos.. |
transformações não simultâneas. 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 percorra entre computadores enquanto mantém 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 para um arquivo .msi. Consulte de Resiliência de Origem. |
Não é possível usar nomes de arquivo e caminhos juntos na mesma lista de TRANSFORMS. Não é possível 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, ponto-e-vírgula não deve ser usado em um nome de arquivo ou caminho de transformação.
Observações
Nos casos em que a política TransformsSecure ou a propriedade TRANSFORMSSECURE foi definida com o Windows Installer, não é necessário passar o @ ou | símbolo ao definir TRANSFORMS usando a linha de comando. O instalador pressupõeAt-SourceFull-Path seguro ou seguro se a lista consiste inteiramente em nomes de arquivo localizados na origem ou consiste inteiramente em caminhos completos. Você ainda não pode misturar os dois tipos de fontes de transformação.
Observe que o instalador usa uma ordem de pesquisa diferente para transformações sem segurança aplicadas durante instalações de manutenção e primeira vez. Para obter mais informações, consulte transformações não simultâneas.
Requisitos
| Requisito | 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 Windows Installer Run-Time Requirements para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer. |
Consulte também