Propriedades e opções de linha de comando de instalação

Ao executar a instalação, você pode usar as opções de linha de comando para alterar alguns parâmetros utilizados para instalar o aplicativo, como configurações de exibição e valores padrão para as propriedades da instalação.

O Programa de Instalação e o Windows Installer usam propriedades para controlar o processo de instalação dos aplicativos. Os valores padrão para as propriedades da instalação são definidos no pacote do Windows Installer (arquivo MSI). É possível especificar novos valores de propriedade na linha de comando ou no arquivo de configurações da instalação (Setup.ini).

Observação   Na maioria dos casos, as opções de linha de comando substituem personalizações duplicadas no arquivo de configurações da instalação (Setup.ini) ou em uma transformação (arquivo MST). Nem todos os arquivos MSI aceitam as propriedades e as opções de linha de comando.

 

/a

/f

/i

/j

/l

/noreboot

/p

/q

/settings

/x

property=value

/?

 

/a [arquivomsi]

Cria um ponto de instalação administrativa para o pacote especificado (arquivo MSI). O pacote deve estar na mesma pasta que o arquivo Setup.exe e ambos devem estar na raiz do ponto de instalação administrativa.

Exemplos:

/a My.msi

/a "subfolder1\My.msi"

/f [opções][arquivomsi]

Força o reparo de um aplicativo associado a um pacote especificado (arquivo MSI). O pacote deve estar na mesma pasta que o arquivo Setup.exe e ambos devem estar na raiz do ponto de instalação administrativa. Você também pode especificar o código do produto para o pacote em que ele pode ser copiado, na seção [Produto] do arquivo de configurações da instalação.

Observação   Você deve especificar o mesmo pacote usado originalmente na instalação do aplicativo.

Os valores válidos para as <i>opções</i> são:

a Força a reinstalação de todos os arquivos, independentemente da soma de verificação ou da versão.
c Reinstala um arquivo se ele não for encontrado ou se estiver corrompido.
d Reinstala um arquivo se ele não for encontrado ou se existir uma outra versão.
e Reinstala um arquivo se ele não for encontrado ou se existir uma versão igual ou anterior.
m Regrava todas as entradas de registro HKEY_LOCAL_MACHINE necessárias.
o Reinstala um arquivo se ele não for encontrado ou se existir uma versão anterior.
p Reinstala um arquivo apenas se ele não for encontrado.
s Reinstala todos os atalhos e substitui os atalhos existentes.
u Regrava todas as entradas de registro HKEY_CURRENT_USER necessárias.
v Recupera o pacote original, armazenando-o novamente em cache no computador local.

O comando Detectar e Reparar realiza em um aplicativo a mesma função que a opção /focums. Executar o Programa de Instalação e selecionar Reinstalar realiza a mesma função que a opção /fecums. Em uma instalação, o Windows Installer salva o arquivo MSI no computador local. O uso da opção /fvm para forçar um novo armazenamento em cache e uma reinstalação, faz com que o Windows Installer recupere o arquivo MSI original, armazenando-o novamente em cache no computador local. Você pode utilizar a opção /fvm para atualizar computadores clientes após corrigir um ponto de instalação administrativa.

Importante Se um usuário aplicar patches de cliente (binário) a um computador, você não poderá usar a opção /f para reinstalar e armazenar novamente aplicativos em cache nesse computador a partir de um ponto de instalação administrativa atualizado. Nesse caso, os usuários devem desinstalar e reinstalar aplicativos a partir da imagem administrativa atualizada.

Exemplo:

/fpiwae My.msi

/fvm {12345678-1234-1234-1234-123456789123}

/i [arquivomsi]

Instala aplicativos usando o pacote especificado. O pacote deve estar na mesma pasta que o arquivo Setup.exe.

Observação Por padrão, o arquivo Setup.exe faz com que o Windows Installer realize a mesma função que a opção /i.

Exemplos:

/i My.msi

/i "subfolder1\My.msi"

/j [opção] [arquivomsi] [/t arquivomsi]

Anuncia um aplicativo no computador, instalando-o na primeira utilização; especifique uma opção para anunciar o aplicativo ao computador ou ao usuário. Você só poderá usar a opção /j quando executar o Programa de Instalação a partir de um ponto de instalação administrativa ou de uma imagem do CD na rede. Se nenhum pacote for especificado, o Programa de Instalação usará o pacote especificado no arquivo Setup.ini. Para aplicar uma transformação ao aplicativo anunciado, use a opção /t e especifique um arquivo MST.

Os valores válidos para essa opção são:

m Anuncia a todos os usuários do computador.
u Anuncia ao usuário atual.

Observação   Além da opção /t, você pode utilizar as opções de linha de comando /l, /q, e /settings quando usar a opção /j para anunciar o aplicativo.

Exemplo:

/jm My.msi /t Custom.mst

/l [opções] arquivo de log

Cria um log de ações de instalação para o Programa de Instalação e um arquivo de log para cada tarefa do Windows Installer. A opção /l substitui as configurações especificadas na seção [Log] do arquivo Setup.ini.

Os valores para essa opção e a captura de dados correspondente são:

a Início da notificação da ação
c Parâmetros de IU iniciais
e Mensagens de erro
i Mensagens somente informação
m Mensagens de memória insuficiente
o Mensagens de espaço em disco insuficiente
p Lista de tabelas de propriedades no formulário property=value
r Registro de dados da ação (contém informações específicas da ação)
u Mensagens de solicitação do usuário
v Modo detalhado com mensagens de depuração
w Mensagens de aviso
* Ativa todas as opções de log, exceto v
+ Acrescenta dados a um arquivo de log existente

Arquivo de log significa o nome e o caminho do arquivo de log a ser criado. Quando você adiciona (*) ao nome do arquivo de log, o Programa de Instalação cria um nome de arquivo exclusivo para cada instância da instalação.

Exemplo:

/lv* "%temp%\MyApp Setup(*).txt"

Essa linha de comando cria os seguintes arquivos de log:

/noreboot

Não reinicia o computador ou exibe uma caixa de diálogo de reinicialização ao final da instalação. A opção /noreboot define a propriedade REBOOT do Windows Installer como ReallySuppress para cada pacote incluído na instalação, exceto o último.

/p [arquivomsp]

Aplica uma atualização administrativa (arquivo MSP) a uma instalação cliente. Você também pode usar a opção /p para aplicar uma atualização a uma instalação administrativa, incluindo a opção /a, o nome e o caminho do arquivo MSI no ponto de instalação administrativa. Para aplicar a correção sigilosamente, inclua a opção /qb na linha de comando para gerar um arquivo de log e a opção /l.

Exemplos:

msiexec /p [arquivomsp] /qb /l[opções]

msiexec /p [arquivomsp] /a [arquivomsi] /qb /l[opções]

/q [opção]

Define o nível de exibição da interface do usuário da instalação.

Os valores válidos para as opções são:

b Exibe apenas indicadores de progresso simples e mensagens de erro (básico).
f Exibe caixas de diálogo e mensagens; equivale a omitir a opção /q (completo).
n Não exibe interface do usuário; equivale a não especificar uma opção para /q (nenhum).
r Exibe todos os indicadores de progresso e mensagens de erro, mas não coleta informações de usuário (reduzido).
- Suprime todas as caixas de diálogo restritas (usado apenas com a opção b).
+ Adiciona uma mensagem de conclusão à opção n ou b.

Observação   A mensagem de conclusão é exibida apenas quando a instalação não exige que o computador seja reiniciado.

/settings arquivo

Especifica um arquivo de configurações da instalação personalizado para o arquivo Setup.exe usar no lugar do arquivo Setup.ini. O arquivo de configurações deve estar na mesma pasta que o Setup.exe, ou o caminho deve estar na linha de comando.

Exemplo:

/settings MyApp.ini

/x [arquivomsi]

Remove o aplicativo associado ao pacote especificado. O pacote deve estar na mesma pasta que o arquivo Setup.exe e ambos devem estar na raiz do ponto de instalação administrativa.

Observação  Você deve especificar o mesmo pacote usado originalmente na instalação do aplicativo.

Exemplo:

/x My.msi

property=value

Especifica um valor de propriedade na linha de comando. Se o valor tiver espaços, escreva-o entre aspas ("). Para especificar dois ou mais pares de valor de propriedade, separe-os com espaços.

ALLUSERS=[seqüência de caracteres]

Instala o aplicativo para todos os usuários do computador ou apenas para o usuário atual. Por padrão, o Windows Installer instala o aplicativo para todos os usuários do computador. Se um valor nulo ("") for definido para ALLUSERS, esse comportamento padrão é substituído e a instalação é feita por usuário.

1 = Instala o aplicativo para todos os usuários do computador (exige privilégios administrativos).

2 = Instala o aplicativo para todos os usuários do computador.

"" = Instala o aplicativo apenas para o usuário que executar o Programa de Instalação.

ALLUSER=""

CDCACHE=[seqüência de caracteres]

Especifica o nível de armazenamento em cache.

Auto = cache com base no espaço em disco disponível

1 = armazena em cache apenas o que foi instalado

2 = armazena toda a fonte em cache

0 = cache desabilitado

CDCACHE=auto

COMPANYNAME=[seqüência de caracteres]

Especifica o nome de uma empresa.

COMPANYNAME=My Business

INSTALLLOCATION=[seqüência de caracteres]

Especifica o local da instalação.

INSTALLLOCATION=C:\Program Files\MyApp

LOCALCACHEDRIVE=[seqüência de caracteres]

Especifica a unidade em que os arquivos de instalação serão armazenados em cache.

LOCALCACHEDRIVE=C

PIDKEY=[seqüência de caracteres]

Insere uma chave de licença com 25 caracteres no arquivo de linha de comando de instalação ou no arquivo de configurações de instalação. Quando você define a propriedade PIDKEY, os usuários não são solicitados a inserir a chave do produto durante sua instalação.

PIDKEY=123467890123456789012345

TRANSFORMS=[seqüência de caracteres]

Especifica uma transformação a ser aplicada à instalação.

TRANSFORMS=\\server\share\myApp\Custom.mst

USERNAME=[seqüência de caracteres]

Especifica um nome de usuário padrão.

USERNAME=Carina Terra