Compartilhar via


Opções de Command-Line

O programa executável que interpreta pacotes e instala produtos é Msiexec.exe. Observe que o 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 não 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 Command-Line do Instalador Padrão também estão disponíveis a partir do Windows Installer 3.0.

Opção Parâmetros Meaning
/Eu Pacote|ProductCode Instala ou configura um produto.
/f [p|o|e|d|c|a|u|m|s|v] Pacote|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. Só repara arquivos que têm msidbFileAttributesChecksum na coluna Atributos da tabela Arquivo .
a – Força que todos os arquivos sejam reinstalados.
u - Reescreve todas as entradas de registro específicas do usuário necessárias.
m – Reescreve todas as entradas de registro específicas do computador necessárias.
s - Substitui todos os atalhos existentes.
v – Executa de 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.
/um Pacote Opção de instalação administrativa . Instala um produto na rede.
/x Pacote|ProductCode Desinstala um produto.
/j [u|m]Empacotador
[u|m]Lista de transformações de pacote/t
ou
[u|m]LanguageID de pacote/g
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 a 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 logfile no caminho existente especificado. O caminho para o local do logfile já deve existir. O instalador não cria a estrutura de diretório para o logfile. 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 fora do espaço em disco.
p – Propriedades do terminal.
v – Saída detalhada.
x – Informações extras de depuração. Windows Installer 2.0: Não há suporte. A opção x está disponível com o Windows Installer versão 3.0.3790.2180 e posterior.

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

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


/m filename

Note:
O comprimento do nome do arquivo não deve ter mais de oito caracteres.


Gera um arquivo .mif de status de SMS. Deve 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 deve estar no caminho.
Os campos do arquivo mif de status são preenchidos com as seguintes informações:
Fabricante – Autor
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) Recurso de Msi.dll se a instalação não pôde ser iniciada ou o usuário sair. 3) Arquivo de mensagem de erro do sistema. 4) Mensagem formatada: "%ide erro do instalador", em que %i é um erro retornado de Msi.dll.
/p PatchPackage[; patchPackage2 ] Aplica um patch. Para aplicar um patch a uma imagem administrativa instalada, você deve combinar as seguintes opções:
/p <PatchPackage>[; patchPackage2 ] / a \<Package>
/q n|b|r|f Define o nível da interface do usuário.
q , qn - Nenhuma interface do usuário
qb – interface do usuário básica. Use o 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 qualquer caixa de diálogo fatalError, UserExit ou Exit no final.
qn+ – Nenhuma interface do usuário, exceto 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. 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 de sistema DllRegisterServer para registrar automaticamente os 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 de 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. Deve ser usado em conjunto com /t. Disponível a partir da versão do Windows Installer que é enviada com o Windows Server 2003 e o Windows XP com o Service Pack 1 (SP1).
/n ProductCode Especifica uma instância específica 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 do A:\Example.msi, instale o produto da seguinte maneira:

msiexec /i A:\Example.msi

Somente as propriedades públicas podem ser modificadas usando a linha de comando. Todos os nomes de propriedade na linha de comando são interpretados como maiúsculas, mas o valor mantém a confidencialidade 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 Propriedade. Para obter mais informações, consulte Sobre propriedades.

Para instalar um produto com PROPERTY definido como VALOR, 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="Espaço em branco inserido"

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"" e ""Gizmos""

O exemplo a seguir mostra as opções de anúncio. Observe que as opções 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. Este 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 em conjunto em uma linha de comando. Nesse caso, você pode aplicar patches a um produto da seguinte 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.

O exemplo a seguir mostra como desinstalar um produto.

msiexec /x msisample.msi