Compartilhar via


Opções de Linha de Comando

O programa executável que interpreta pacotes e instala produtos é Msiexec.exe. Observe que Msiexec também define um nível de erro no retorno que corresponde aos códigos de erro do sistema. As opções de linha de comando diferenciam maiúsculas de minúsculas.

As opções de linha de comando na tabela a seguir estão disponíveis com o Windows Installer 3.0 e versões anteriores. As Opções de linha de comando do Instalador Padrão também estão disponíveis a partir do Windows Installer 3.0.

Opção Parâmetros Significado
/I Package|ProductCode Instala ou configura um produto.
/f [p|o|e|d|c|a|u|m|s|v] Package|Productcode Repara um produto. Essa opção ignora todos os valores de propriedade inseridos na linha de comando. A lista de argumentos padrão para essa opção é 'omus'. Essa opção compartilha a mesma lista de argumentos que a propriedade REINSTALLMODE.
p – Reinstala somente se o arquivo estiver ausente.
o – Reinstala se o arquivo estiver ausente ou se uma versão mais antiga estiver instalada.
e – Reinstala se o arquivo estiver ausente ou se uma versão igual ou mais antiga estiver instalada.
d – Reinstala se o arquivo estiver ausente ou se uma versão diferente estiver instalada.
c – Reinstala se o arquivo estiver ausente ou a soma de verificação armazenada não corresponder ao valor calculado. Repara apenas arquivos que têm msidbFileAttributesChecksum na coluna Attributes da tabela File.
a – Força a reinstalação de todos os arquivos.
u – Reescreve todas as entradas de registro específicas do usuário obrigatórias.
m – Reescreve todas as entradas de registro específicas do computador obrigatórias.
s – Substitui todos os atalhos existentes.
v – Executa da origem e armazena novamente em cache o pacote local. Não use a opção de reinstalação v para a primeira instalação de um aplicativo ou recurso.
/a Pacote Opção Instalação administrativa. Instala um produto na rede.
/x Package|ProductCode Desinstala um produto.
/j [u|m]Packageor
[u|m]Package/tTransform List
or
[u|m]Package/gLanguageID
Anuncia um produto. Essa opção ignora todos os valores de propriedade inseridos na linha de comando.
u – Anuncia para o usuário atual.
m – Anuncia a todos os usuários do computador.
g – Identificador de idioma.
t – Aplica transformação ao pacote anunciado.
/L [i|w|e|a|r|u|c|m|o|p|v|x|+|!| *] Logfile Grava informações de log em um arquivo de log no caminho existente especificado. O caminho para o local do arquivo de log já deve existir. O instalador não cria a estrutura de diretório para o arquivo de log. Os sinalizadores indicam quais informações registrar. Se nenhum sinalizador for especificado, o padrão será 'iwearmo'.
i – Mensagens de status.
w - Avisos não fatais.
e – Todas as mensagens de erro.
a – Inicialização de ações.
r – Registros específicos da ação.
u – Solicitações do usuário.
c – Parâmetros iniciais da interface do usuário.
m – Informações de saída insuficientes ou fatais.
o – Mensagens de espaço insuficiente em disco.
p – Propriedades do terminal.
/v – Saída detalhada.
x – Informações extras de depuração. Windows Installer 2.0: sem suporte. A opção x está disponível com o Windows Installer versão 3.0.3790.2180 e posterior.

+ – Acrescentar ao arquivo existente.
! - Libera cada linha para o log.
"*" – Curinga, registra todas as informações, exceto as opções v e x. Para incluir as opções v e x, especifique "/l*vx".

Observação:
Para obter mais informações sobre todos os métodos disponíveis para definir o modo de registro em log, confira Registro em log normal na seção Log do Windows Installer


/m filename

Observação:
O tamanho do nome do arquivo não pode ter mais de oito caracteres.


Gera um arquivo .mif de status de SMS. Precisa ser usado com as opções instalar (-i), remover (-x), instalação administrativa (-a) ou reinstalar (-f). O ISMIF32.DLL é instalado como parte do SMS e precisa estar no caminho.
Os campos do arquivo mif de status são preenchidos com as seguintes informações:
Fabricante – Criador
Produto – Número de Revisão
Versão – Assunto
Localidade – Modelo
Número de Série – não definido
Instalação – definida por ISMIF32.DLL como "DateTime"
InstallStatus – "Êxito" ou "Falha"
Descrição – Mensagens de erro na seguinte ordem: 1) Mensagens de erro geradas pelo instalador. 2) O recurso de Msi.dll se a instalação não pôde ser iniciada ou o usuário saiu. 3) Arquivo de mensagem de erro do sistema. 4) Mensagem formatada: "Erro do instalador %i", em que %i é o erro retornado de Msi.dll.
/p PatchPackage[;patchPackage2 ] Aplica um patch. Para aplicar um patch a uma imagem administrativa instalada, você precisa combinar as seguintes opções:
/p <PatchPackage>[;p atchPackage2 ] /a \<Package>
/q n|b|r|f Define o nível da interface do usuário.
q , qn - Sem interface do usuário
qb – interface do usuário básica. Use qb! para ocultar o botão Cancelar.
qr – interface do usuário reduzida sem caixa de diálogo modal exibida no final da instalação.
qf – interface do usuário completa e quaisquer caixas de diálogo FatalError, UserExit ou Exit modal criadas no final.
qn+ - Nenhuma interface do usuário, exceto para uma caixa de diálogo modal exibida no final.
qb+ – interface do usuário básica com uma caixa de diálogo modal exibida no final. A caixa modal não será exibida se o usuário cancelar a instalação. Use qb+! ou qb!+ para ocultar o botão Cancelar.
qb- – Interface do usuário básica sem caixas de diálogo modais. Observe que /qb+- não é um nível de interface do usuário com suporte. Use qb-! ou qb!- para ocultar o botão Cancelar.
Observe que o ! A opção está disponível com o Windows Installer 2.0 e funciona apenas com a interface do usuário básica. Ele não é válido com a interface do usuário completa.
/? ou /h Exibe informações de direitos autorais para o Windows Installer.
/Y module Chama a função do sistema DllRegisterServer para auto-registrar módulos passados na linha de comando. Especifique o caminho completo para a DLL. Por exemplo, para MY_FILE.DLL na pasta atual, você pode usar:
msiexec /y .\MY_FILE.DLL
Essa opção é usada apenas para informações do Registro que não podem ser adicionadas usando as tabelas do Registro do arquivo .msi.
/Z module Chama a função do sistema DllUnRegisterServer para cancelar o registro de módulos passados na linha de comando. Especifique o caminho completo para a DLL. Por exemplo, para MY_FILE.DLL na pasta atual, você pode usar:
msiexec /z .\MY_FILE.DLL
Essa opção é usada apenas para informações do Registro que não podem ser removidas usando as tabelas do Registro do arquivo .msi.
/c Anuncia uma nova instância do produto. Precisa ser usado em conjunto com /t. Disponível a partir da versão do Windows Installer que é fornecida com o Windows Server 2003 e o Windows XP com o Service Pack 1 (SP1).
/n ProductCode Especifica determinada instância do produto. Usado para identificar uma instância instalada usando o suporte de várias instâncias por meio de transformações de alteração de código do produto. Disponível a partir da versão do Windows Installer fornecida com o Windows Server 2003 e o Windows XP com SP1.

As opções /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a, /p, /y e /z não devem ser usadas juntas. A única exceção a essa regra é que a aplicação de patch de uma instalação administrativa requer o uso de /p e /a. As opções /t, /c e /g só devem ser usadas com /j. As opções /l e /q podem ser usadas com /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a e /p. A opção /n pode ser usada com /i, /f, /x e /p.

Para instalar um produto de A:\Example.msi, instale o produto da seguinte maneira:

msiexec /i A:\Example.msi

Somente propriedades públicas podem ser modificadas usando a linha de comando. Todos os nomes de propriedade na linha de comando são interpretados como em maiúsculas, mas o valor mantém a diferenciação de maiúsculas e minúsculas. Se você inserir MyProperty em uma linha de comando, o instalador substituirá o valor de MYPROPERTY e não o valor de MyProperty na tabela Property. Para obter mais informações, confira Sobre propriedades.

Para instalar um produto com PROPERTY definido como VALUE, use a sintaxe a seguir na linha de comando. Você pode colocar a propriedade em qualquer lugar, exceto entre uma opção e seu argumento.

Sintaxe correta:

msiexec /i A:\Example.msi PROPERTY=VALUE

Sintaxe incorreta:

msiexec /i PROPERTY=VALUE A:\Example.msi

Os valores de propriedade que são cadeias de caracteres literais devem ser colocados entre aspas. Inclua espaços em branco na cadeia de caracteres entre as marcas.

msiexec /i A:\Example.msi PROPERTY="Embedded White Space"

Para limpar uma propriedade pública usando a linha de comando, defina seu valor como uma cadeia de caracteres vazia.

msiexec /i A:\Example.msi PROPERTY=""

Para seções de texto separadas por aspas literais, coloque a seção com um segundo par de aspas.

msiexec /i A:\Example.msi PROPERTY="Embedded ""Quotes"" White Space"

O exemplo a seguir mostra uma linha de comando complicada.

msiexec /i testdb.msi INSTALLLEVEL=3 /l* msi.log COMPANYNAME="Acme ""Widgets"" and ""Gizmos."""

O exemplo a seguir mostra opções de anúncio. Observe que os comutadores não diferenciam maiúsculas de minúsculas.

msiexec /JM msisample.msi /T transform.mst /LIME logfile.txt

O exemplo a seguir mostra como instalar uma nova instância de um produto a ser anunciado. Esse produto é criado para dar suporte a várias transformações de instância.

msiexec /JM msisample.msi /T :instance1.mst;customization.mst /c /LIME logfile.txt

O exemplo a seguir mostra como corrigir uma instância de um produto instalado usando várias transformações de instância.

msiexec /p msipatch.msp;msipatch2.msp /n {00000001-0002-0000-0000-624474736554} /qb

Quando você aplica patches a um produto específico, as opções /i e /p não podem ser especificadas juntas em uma linha de comando. Nesse caso, você pode aplicar patches a um produto desta maneira.

msiexec /i A:\Example.msi PATCH=msipatch.msp;msipatch2.msp /qb

A propriedade PATCH não pode ser definida em uma linha de comando, quando a opção /p é usada. Se a propriedade PATCH for definida quando a opção /p for usada, o valor da propriedade PATCH será ignorado e substituído.