Partilhar via


Opções de Linha de Comando

O programa executável que interpreta pacotes e instala produtos é Msiexec.exe. Note 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 comandos são insensíveis a maiúsculas e maiúsculas.

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

Opção Parâmetros Meaning
/Eu Pacote|Código de Produto Instala ou configura um produto.
/f [p|o|e|d|c|a|u|m|s|v] Pacote|Código de Produto Repara um produto. Esta opção ignora quaisquer valores de propriedade introduzidos na linha de comandos. A lista de argumentos padrão para esta opção é 'omus'. Esta opção partilha a mesma lista de argumentos que a propriedade REINSTALLMODE .
p - Reinstala apenas se o ficheiro estiver em falta.
o - Reinstala se o ficheiro estiver em falta ou se estiver instalada uma versão mais antiga.
e - Reinstala se o ficheiro estiver em falta ou se estiver instalada uma versão igual ou mais antiga.
d - Reinstala se o ficheiro estiver em falta ou se estiver instalada uma versão diferente.
c - Reinstala se o ficheiro estiver em falta ou se a soma de verificação armazenada não corresponder ao valor calculado. Apenas repara ficheiros que tenham msidbFileAttributesChecksum na coluna Attributes da tabela de ficheiros .
a - Força a reinstalação de todos os ficheiros.
u - Reescreve todas as entradas de registo específicas de utilizador necessárias.
m - Reescreve todas as entradas de registo específicas de computador necessárias.
s - Sobrescrive todos os atalhos existentes.
v - Executa a partir da fonte e volta a cachear o pacote local. Não use a opção de reinstalação do V na primeira instalação de uma aplicação ou funcionalidade.
/um Pacote Opção de instalação administrativa . Instala um produto na rede.
/x Pacote|Código de Produto Desinstala um produto.
/j [u|m]Empacotador
[u|m]Lista de Transformadas de Pacotes/t
ou
[u|m]Package/gLanguageID
Anuncia um produto. Esta opção ignora quaisquer valores de propriedade introduzidos na linha de comandos.
u - Anuncia ao utilizador atual.
m - Anuncia a todos os utilizadores da máquina.
g - Identificador de língua.
t - Aplica transformação ao pacote anunciado.
/L [i|w|e|a|r|u|c|m|o|p|v|x|+|!|*] Ficheiro de registo Escreve informações de registo num ficheiro de registo no caminho existente especificado. O caminho para a localização do ficheiro de registo já deve existir. O instalador não cria a estrutura de diretórios para o ficheiro de registo. As bandeiras indicam qual a informação a registar. Se não forem especificadas bandeiras, o padrão é 'iwearmo.'
i - Mensagens de estado.
E - Avisos não fatais.
e - Todas as mensagens de erro.
a - Início das ações.
r - Registos específicos de ação.
u - Pedidos dos utilizadores.
c - Parâmetros iniciais da interface.
m - Informação de saída fora de memória ou fatal.
o - Mensagens fora do espaço do disco.
p - Propriedades terminais.
v - Saída verbosa.
x - Informação extra de depuração. Instalador Windows 2.0: Não suportado. A opção x está disponível com o Windows Installer versão 3.0.3790.2180 e posteriores.

+ - Anexar ao ficheiro existente.
! - Lavar cada linha até ao tronco.
"*" - Coringa, regista toda a informação exceto as opções v e x. Para incluir as opções v e x, especifique "/l*vx".

Note:
Para mais informações sobre todos os métodos disponíveis para definir o modo de registo, consulte Logar Normal na secção de Registo do Instalador do Windows


/m filename

Note:
O comprimento do nome do ficheiro não deve ser superior a oito caracteres.


Gera um ficheiro .mif de estado SMS. Deve ser usado com as opções de instalação (-i), remoção (-x), instalação administrativa (-a) ou reinstalação (-f). O ISMIF32.DLL é instalado como parte do SMS e deve estar no percurso.
Os campos do ficheiro status mif são preenchidos com a seguinte informação:
Fabricante - Autor
Produto - Número de Revisão
Versão - Sujeito
Local - Modelo
Número de Série - não definido
Instalação - definida por ISMIF32.DLL para "DateTime"
InstallStatus - "Sucesso" ou "Falhado"
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 pudesse começar ou a saída do utilizador. 3) Ficheiro de mensagem de erro do sistema. 4) Mensagem formatada: "Error do instalador %i", onde %i erro é devolvido de Msi.dll.
/p PatchPackage[; patchPackage2 ] Aplica um patch. Para aplicar um patch a uma imagem administrativa instalada, deve combinar as seguintes opções:
/p <PatchPackage>[; patchPackage2 ] /a \<Package>
/q n|b|r|f Define o nível da interface do utilizador.
q , qn - Sem UI
qb - Interface básica. Usa o QB! para esconder o botão Cancelar .
qr - Interface reduzida sem caixa de diálogo modal exibida no final da instalação.
qf - Interface completa e quaisquer caixas de diálogo modais FatalError, UserExit ou Exit criadas no final.
qn+ - Sem interface, exceto por uma caixa de diálogo modal exibida no final.
qb+ - Interface básica com uma caixa de diálogo modal exibida no final. A caixa modal não é exibida se o utilizador cancelar a instalação. Usa o QB+! ou qb!+ para esconder o botão Cancelar .
qb- - Interface básica sem caixas de diálogo modais. Por favor, note que /qb+- não é um nível de interface suportado. Usa o QB-! ou qb!- para esconder o botão Cancelar .
Note que o ! a opção está disponível com o Windows Installer 2.0 e funciona apenas com interface básica. Não é válido com a interface completa.
/? ou /h Mostra informações de direitos de autor para o Windows Installer.
/y módulo Chama a função do sistema DllRegisterServer para auto-registar módulos passados na linha de comandos. Especifique o caminho completo para a DLL. Por exemplo, para MY_FILE.DLL na pasta atual podes usar:
msiexec /y .\MY_FILE.DLL
Esta opção é usada apenas para informações do registo que não podem ser adicionadas usando as tabelas do registo do ficheiro .msi.
/z módulo Chama a função do sistema DllUnRegisterServer para desregistar módulos passados na linha de comandos. Especifique o caminho completo para a DLL. Por exemplo, para MY_FILE.DLL na pasta atual podes usar:
msiexec /z .\MY_FILE.DLL
Esta opção é usada apenas para informações do registo que não podem ser removidas usando as tabelas do registo do ficheiro .msi.
/c Anuncia uma nova instância do produto. Deve ser usado em conjunto com /t. Disponível a partir da versão Windows Installer, que vem com o Windows Server 2003 e o Windows XP com o Service Pack 1 (SP1).
/n Código de Produto Especifica uma instância particular do produto. Usado para identificar uma instância instalada usando o suporte a múltiplas instâncias através de transformações de alteração de código de produto. Disponível a partir da versão Windows Installer incluída com Windows Server 2003 e 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 em conjunto. A única exceção a esta regra é que corrigir uma instalação administrativa requer usar tanto /p como /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 a partir de A:\Example.msi, instale-o da seguinte forma:

msiexec /i A:\Example.msi

Apenas propriedades públicas podem ser modificadas usando a linha de comandos. Todos os nomes de propriedades na linha de comandos são interpretados como maiúsculas, mas o valor mantém a sensibilidade maiúscula. Se introduzires MyProperty numa linha de comandos, o instalador sobrepõe o valor de MYPROPERTY e não o valor de MyProperty na tabela Property. Para mais informações, consulte Sobre Propriedades.

Para instalar um produto com PROPERTY definida para VALUE, utilize a seguinte sintaxe na linha de comandos. Pode colocar a propriedade em qualquer lugar, exceto entre uma opção e o seu argumento.

Sintaxe correta:

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

Sintaxe incorreta:

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

Os valores de propriedades que são cadeias literais devem ser incluídos entre aspas. Inclua quaisquer espaços em branco no fio entre as marcas.

msiexec /i A:\Example.msi PROPERTY="Espaço em Branco Incorporado"

Para limpar uma propriedade pública usando a linha de comandos, defina o seu valor para uma cadeia vazia.

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

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

msiexec /i A:\Example.msi PROPERTY="Embedded ""Quotes"" Espaço em Branco"

O exemplo seguinte mostra uma linha de comandos complicada.

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

O exemplo seguinte mostra opções de publicidade. Note que os interruptores não são sensíveis a maiúsculas e minúsculas.

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

O exemplo seguinte mostra-lhe como instalar uma nova instância de um produto a ser anunciado. Este produto foi desenvolvido para suportar múltiplas transformações de instância.

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

O exemplo seguinte mostra como corrigir uma instância de um produto instalado usando múltiplas transformações de instância.

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

Quando aplicas patches a um produto específico, as opções /i e /p não podem ser especificadas em conjunto numa linha de comandos. Neste caso, pode aplicar patches a um produto da seguinte forma.

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

A propriedade PATCH não pode ser definida numa linha de comandos quando é usada a opção /p. Se a propriedade PATCH for definida quando a opção /p é usada, o valor da propriedade PATCH é ignorado e sobrescrevido.

O exemplo seguinte mostra-lhe como desinstalar um produto.

msiexec /x msisample.msi