Quando executa o programa de configuração, pode utilizar as opções da linha de comandos para alterar alguns dos parâmetros que o programa de configuração utiliza para instalar a aplicação, como as definições de visualização e os valores predefinidos para as propriedades de configuração.
O programa de configuração e o Windows Installer utilizam propriedades para controlar o processo de instalação de aplicações. Os valores predefinidos para as propriedades de configuração são definidos no pacote do Windows Installer (ficheiro MSI). Pode especificar novos valores de propriedades na linha de comandos ou no ficheiro de definições de configuração (Setup.ini).
Nota Na maior parte dos casos, as opções da linha de comandos substituem as personalizações duplicadas no ficheiro de definições de configuração (Setup.ini) ou num ficheiro de transformação (ficheiro MST). As opções e as propriedades da linha de comandos não são suportadas por todos os ficheiros MSI.
Crie um ponto de instalação administrativa para o pacote especificado (MSI file). O pacote tem de estar na mesma pasta que o Setup.exe e ambos têm de estar na raiz do ponto de instalação administrativa.
Exemplos:
/a Meu.msi
/a "subpasta1\Meu.msi"
Force a reparação de uma aplicação associada ao pacote especificado (ficheiro MSI). O pacote tem de estar na mesma pasta que o Setup.exe e ambos têm de estar na raiz do ponto de instalação administrativa. Como alternativa, pode especificar o código do produto para o pacote em que o código do produto pode ser copiado da secção [Product] do ficheiro de definições de configuração.
Nota Tem de especificar o mesmo pacote que foi utilizado originalmente para instalar a aplicação.
Os valores válidos para as <i>opções</i> incluem o seguinte
| a | Força a reinstalação de todos os ficheiros independentemente da soma de verificação ou versão. |
| c | Reinstala o ficheiro caso não exista ou caso esteja danificado. |
| d | Reinstala o ficheiro caso não exista ou caso seja de uma versão diferente. |
| e | Reinstala o ficheiro caso não exista ou caso seja de uma versão igual ou anterior. |
| m | Reescreve todas as entradas de registo HKEY_LOCAL_MACHINE necessárias. |
| o | Reinstala o ficheiro caso não exista ou caso seja de uma versão anterior. |
| p | Reinstala apenas o ficheiro caso não exista. |
| s | Reinstala todos os atalhos e substitui os atalhos existentes. |
| u | Reescreve todas as entradas de registo HKEY_CURRENT_USER necessárias. |
| v | Obtém o pacote da origem e volta a colocá-lo em cache no computador local. |
O comando Detectar e reparar numa aplicação executa a mesma função que /focums. A execução do programa de configuração e a selecção do comando para reinstalar executam a mesma função que /fecums. Quando instala, o Windows Installer guarda o ficheiro MSI no computador local. Quando utiliza a opção /fvm para forçar uma nova colocação em cache e reinstalação, o Windows Installer obtém o ficheiro MSI da origem e volta a colocá-lo em cache no computador local. Pode utilizar a opção /fvm para actualizar os computadores cliente depois de ter corrigido um ponto de instalação administrativa.
Importante Se um utilizador aplicar correcções de cliente (binárias) a um computador, não pode utilizar /f para voltar a colocar em cache e reinstalar nesse computador a partir de um ponto de instalação administrativa actualizado. Neste caso, os utilizadores têm de desinstalar e reinstalar a partir da imagem administrativa actualizada.
Exemplo:
/fpiwae Meu.msi
/fvm {12345678-1234-1234-1234-123456789123}
Instale as aplicações utilizando o pacote especificado. O pacote tem de estar na mesma pasta que o Setup.exe.
Nota Por predefinição, o Setup.exe faz com que o Windows Installer execute a mesma função que /i.
Exemplos:
/i Meu.msi
/i "subpasta1\Meu.msi"
Anuncie a aplicação no computador e instale na primeira utilização; tem de especificar uma opção para anunciar a aplicação ao computador ou ao utilizador. Só pode utilizar /j quando estiver a executar o programa de configuração a partir de um ponto de instalação administrativa ou uma imagem do CD na rede. Se não for especificado nenhum pacote, o programa de configuração utiliza o pacote especificado no Setup.ini. Para aplicar uma transformação à aplicação anunciada, utilize a opção /t e especifique um ficheiro MST.
Os valores válidos para a opção incluem o seguinte:
| m | Anuncia a todos os utilizadores no computador. |
| u | Anuncia ao utilizador actual. |
Nota Além de /t, pode utilizar as três opções da linha de comandos que se seguem quando utilizar /j para anunciar a aplicação: /l, /q e /settings.
Exemplo:
/jm Meu.msi /t Personalizar.mst
Crie um registo de acções de instalação para o programa de configuração e um ficheiro de registo para cada tarefa do Windows Installer. A opção /l substitui as predefinições especificadas na secção [Logging] do Setup.ini.
Os valores para a opção incluem o seguinte e capturam os dados correspondentes:
| a | Notificação de início de acção |
| c | Parâmetros de UI iniciais |
| e | Mensagens de erro |
| i | Mensagens só informativas |
| m | Mensagens de memória esgotada |
| o | Mensagens de espaço insuficiente no disco |
| p | Lista da tabela de propriedades sob a forma propriedade=valor |
| r | Registo de dados de acção; contém informações específicas da acção |
| u | Mensagens de pedido do utilizador |
| v | Verboso que inclui mensagens de depuração |
| w | Mensagens de aviso |
| * | Activa todas as opções de registo, excepto v |
| + | Acrescenta ao ficheiro de registo existente |
Ficheiroderegisto significa o nome e o caminho do ficheiro de registo a criar. Quando inclui (*) no nome do ficheiro de registo, o programa de configuração cria um nome de ficheiro exclusivo para cada instância do programa de configuração.
Exemplo:
/lv* "%temp%\MyApp Setup(*).txt"
Esta linha de comandos cria os seguintes ficheiros de registo:
Não reinicie o computador nem apresente uma caixa de diálogo de reinício no fim da instalação. A opção /noreboot define a propriedade REBOOT do Windows Installer como ReallySuppress para cada pacote incluído na instalação, excepto o último.
Aplique uma actualização administrativa (ficheiro MSP) a uma instalação de cliente. Também pode utilizar /p para aplicar uma actualização a uma instalação administrativa incluindo a opção /a e o nome e caminho do ficheiro MSI no ponto de instalação administrativa. Para aplicar a correcção em modo silencioso, inclua /qb na linha de comandos para gerar um ficheiro de registo, inclua /l.
Exemplos:
msiexec /p [ficheiromsp] /qb /l[opções]
msiexec /p [ficheiromsp] /a [ficheiromsi] /qb /l[opções]
Defina o nível de apresentação da interface do utilizador do programa de configuração.
Os valores válidos para as opções incluem o seguinte:
| b | Apresenta apenas os indicadores de progresso simples e as mensagens de erro (básico). |
| f | Apresenta todas as caixas de diálogo e mensagens; equivalente à omissão da opção /q (completo). |
| n | Não apresenta a interface do utilizador; equivalente a especificar /q sem opções (nenhum). |
| r | Apresenta todos os indicadores de progresso e mensagens de erro mas não recolhe informações do utilizador (reduzido). |
| - | Suprime todas as caixas de diálogo modais; utilizado apenas com b. |
| + | Adiciona a mensagem de conclusão à opção n ou b. |
Nota A mensagem de conclusão só é apresentada quando o programa de configuração não tem de reiniciar o computador após a instalação.
Especifique um ficheiro de definições de configuração personalizado para Setup.exe a utilizar em vez do Setup.ini. O ficheiro de definições tem de estar na mesma pasta que o Setup.exe ou o caminho tem de ser incluído na linha de comandos.
Exemplo:
/settings MyApp.ini
Remova a aplicação associada ao pacote especificado. O pacote tem de estar na mesma pasta que o Setup.exe e ambos têm de estar na raiz do ponto de instalação administrativa.
Nota Tem de especificar o mesmo pacote que foi utilizado originalmente para instalar a aplicação.
Exemplo:
/x Meu.msi
Especifique um valor de propriedade na linha de comandos. Se o valor contiver espaços, coloque-o entre aspas ("). Para especificar dois ou mais pares propriedade-valor, separe-os com espaços.
| ALLUSERS=[cadeia] |
Instala a aplicação para todos os utilizadores do computador ou para apenas o utilizador actual. Por predefinição, o Windows Installer instala para todos os utilizadores do computador. Se definir ALLUSERS como um valor nulo (""), está a substituir este comportamento predefinido e instala por utilizador. 1 = Instala para todos os utilizadores do computador; requer privilégios administrativos. 2 = Instala para todos os utilizadores do computador. "" = Instala apenas para o utilizador que está a executar o programa de configuração. ALLUSER="" |
|
CDCACHE=[cadeia] |
Especifica o nível de colocação em cache. Auto = cache baseada no espaço disponível em disco 1 = cache do que é instalado apenas 2 = cache de toda a origem 0 = cache desactivada CDCACHE=auto |
|
COMPANYNAME=[cadeia] |
Especifica um nome de organização. COMPANYNAME=Minha Empresa |
|
INSTALLLOCATION=[cadeia] |
Especifica a localização de instalação. INSTALLLOCATION=C:\Programas\MyApp |
|
LOCALCACHEDRIVE=[cadeia] |
Especifica a unidade onde os ficheiros de instalação serão colocados em cache. LOCALCACHEDRIVE=C |
|
PIDKEY=[cadeia] |
Introduza uma chave de licença de volume com 25 caracteres na linha de comandos do programa de configuração ou no ficheiro de definições de configuração. Quando definir a propriedade PIDKEY, os utilizadores não precisam de introduzir uma chave de produto durante a instalação. PIDKEY=123467890123456789012345 |
|
TRANSFORMS=[cadeia] |
Especifica uma transformação a aplicar à instalação. TRANSFORMS=\\servidor\partilha\myApp\Personalizar.mst |
|
USERNAME=[cadeia] |
Especifica um nome de utilizador predefinido. USERNAME=Daniel Dias |