Partilhar via

Inicialização de download da Internet

  • Artigo

Com o Windows Installer, um executável de inicialização configurável (Setup.exe) e uma ferramenta de configuração (Msistuff.exe) estão incluídos nos componentes do SDK do Windows para desenvolvedores do Windows Installer. Usando o Msistuff.exe para configurar os recursos no Setup.exe, os desenvolvedores podem criar facilmente uma instalação da Web de um pacote do Windows Installer.

A versão mínima do instalador exigida pelo executável de inicialização é Windows Installer versão 2.0. Os aplicativos podem obter a versão do instalador usando DllGetVersion. Para obter mais informações, consulte Determinando a versão do Windows Installer

O executável de inicialização fornecido com o SDK do Windows Installer faz o seguinte:

  • Chama WinVerifyTrust para verificar a assinatura digital do arquivo .msi. O Windows Installer versão 2.0 e versões posteriores fornecem um Pacote de Interface de Assunto (SIP) para habilitar a assinatura de pacotes do Windows Installer.
  • Se necessário, atualiza a versão do Windows Installer na máquina.

Os seguintes recursos do Setup.exe podem ser exibidos ou configurados usando Msistuff.exe.

ID de Recurso Descrição
ISETUPPROPNAME_BASEURL O local do URL base do Setup.exe. Se nenhum valor for especificado, o local de Setup.exe padrão será mídia removível. Somente instalações baseadas em URL estão sujeitas a uma verificação com WinVerifyTrust. A barra final no URL é opcional. Esse recurso é opcional.
ISETUPPROPNAME_DATABASE O nome do arquivo .msi. Este é um caminho relativo até o arquivo .msi especificado em relação ao local do programa Setup.exe. Esse recurso será necessário se o ISETUPPROPNAME_PATCH do recurso não for especificado. ISETUPPROPNAME_DATABASE e ISETUPPROPNAME_PATCH não podem ser especificados. Apenas um dos dois pode ser especificado.
ISETUPPROPNAME_OPERATION O tipo de operação a ser executada. Os valores possíveis são INSTALL, MINPATCH, MAJPATCH e INSTALLUPD. O valor INSTALL equivale à primeira instalação do pacote. O valor MINPATCH indica que o patch especificado na propriedade PATCH é um patch de atualização pequena ou secundária. O valor MAJPATCH indica que o patch especificado na propriedade PATCH é um patch de atualização principal. INSTALLUPD indica que a instalação pode ser uma primeira instalação ou uma atualização. O uso de INSTALLUPD tem a verificação de inicialização para a presença do produto. Se o produto estiver presente, o sinalizador do pacote de novo armazenamento em cache será definido e uma reinstalação será executada; caso contrário, uma instalação regular será executada. INSTALLUPD só deve ser usado para pacotes de atualização pequena e secundária em que o código do produto não está mudando. Em uma atualização principal, REINSTALL não é necessário porque o código do produto é alterado, basicamente criando um produto novo. A criação da tabela de atualização, além das ações FindRelatedProducts, MigrateFeatureStates e RemoveExistingProducts, manipula a atualização do produto original. Assim, a opção INSTALL é suficiente. Se esse recurso estiver ausente, a operação INSTALL será assumida se a propriedade ISETUPPROPNAME_DATABASE for criada. Caso contrário, MINPATCH será assumido se a propriedade ISETUPPROPNAME_PATCH for criada. Este é um valor opcional.
ISETUPPROPNAME_PRODUCTNAME O nome do produto. Este é o nome usado no texto do banner na interface do usuário baixada. Esse recurso é opcional. Se omitido, o nome padrão será "o produto".
ISETUPPROPNAME_MINIMUM_MSI A versão mínima do Windows Installer necessária. Se a versão mínima do Windows Installer não estiver instalada no computador, o Instmsi.exe apropriado será chamado para atualizar o Windows Installer. O valor dessa propriedade tem o mesmo formato que o valor PID_PAGECOUNT. Para mais informações, consulte a propriedade Resumo de Contagem de Páginas. Esse valor deve ser de pelo menos 200, o valor que identifica o Windows Installer versão 2.0. Este recurso é obrigatório.
ISETUPPROPNAME_INSTLOCATION O local do URL base dos executáveis de atualização do Windows Installer. Esse recurso pode ser omitido. Se esse valor for omitido, o local padrão dos executáveis de atualização será o local de Setup.exe.
ISETUPPROPNAME_INSTMSIA O nome da versão ANSI do executável de atualização do Windows Installer. Esse é um caminho relativo para a versão ANSI do Instmsi.exe em relação ao local especificado pelo ISETUPPROPNAME_INSTLOCATION. Este recurso é obrigatório.
ISETUPPROPNAME_INSTMSIW O nome da versão Unicode do executável de atualização do Windows Installer. Esse é um caminho relativo para a versão Unicode do Instmsi.exe em relação ao local especificado pelo ISETUPPROPNAME_INSTLOCATION. Este recurso é obrigatório.
ISETUPPROPNAME_PATCH O nome do arquivo .msp. Este é um caminho relativo até o arquivo .msp especificado em relação ao local do programa Setup.exe. Esse recurso será necessário se o ISETUPPROPNAME_DATABASE do recurso não for especificado. ISETUPPROPNAME_DATABASE e ISETUPPROPNAME_PATCH não podem ser especificados. Apenas um dos dois pode ser especificado.
ISETUPPROPNAME_PROPERTIES As cadeias de caracteres PROPERTY=VALUE. Esses são os pares PROPERTY=VALUE a serem incluídos na linha de comando. Essa opção é opcional.

 

Por exemplo, os seguintes valores de ISETUPPROPNAME_BASEURL e ISETUPPROPNAME_DATABASE seriam usados para os seguintes locais de pacote hipotéticos.

Localização real do pacote Valores de Recurso
https://www.blueyonderairlines.com/Products/Product1/product1.msi ISETUPPROPNAME_BASEURL = https://www.blueyonderairlines.com/Products/Product1 ISETUPPROPNAME_DATABASE = product1.msi
https://www.blueyonderairlines.com/Products/Product1/product1.msi ISETUPPROPNAME_BASEURL = https://www.blueyonderairlines.com/Products/Product1 ISETUPPROPNAME_DATABASE = ../Products1/product1.msi
e:\product1.msi Omita ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = product1.msi
e:\setup\product1.msi (O local atualmente em execução de Setup.exe é e:\setup.exe.)
 Omita ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = Setup\product1.msi

 

Parâmetros de linha de comando para Setup.exe

A tabela a seguir lista as opções de comando que podem ser usadas com o Setup.exe fornecido com os componentes do SDK do Windows para desenvolvedores do Windows Installer. Quando invocado sem nenhuma opção de linha de comando, Setup.exe assume como padrão o comportamento especificado por meio dos recursos configurados. As opções de linha de comando são mutuamente exclusivas — apenas uma delas pode ser usada por vez.

Opção Uso Significado
/a setup.exe /a Inicia uma instalação administrativa. Se a propriedade ISETUPPROPNAME_DATABASE estiver configurada em Setup.exe, essa opção poderá ser usada para executar uma instalação administrativa do produto. Essa opção de linha de comando não terá suporte se o recurso ISETUPPROPNAME_PATCH estiver configurado.
/a setup.exe /a <caminho completo até uma instalação administrativa existente> Se a propriedade ISETUPPROPNAME_PATCH estiver configurada em Setup.exe, essa opção poderá ser usada para aplicar patch em uma instalação administrativa existente do produto. Essa opção de linha de comando não terá suporte se o recurso ISETUPPROPNAME_DATABASE estiver configurado.
/v setup.exe /v <caminho completo até um arquivo> Verifica a assinatura no arquivo usando WinVerifyTrust. Nenhuma interface do usuário é exibida quando essa opção é usada. Nesse caso, o resultado da verificação de confiança é o valor de retorno obtido da execução de Setup.exe.
/?   Exibe uma caixa de diálogo de ajuda indicando os argumentos válidos. Observação: a caixa de diálogo de ajuda também é exibida se argumentos inválidos forem fornecidos.

 

Para obter mais informações, consulte Um exemplo de instalação do Windows Installer baseado em URL.