Partilhar via


Internet Download Bootstrapping

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 no Windows SDK Components for Windows Installer Developers. Usando Msistuff.exe para configurar os recursos no Setup.exe, os desenvolvedores podem facilmente criar uma instalação na Web de um pacote do Windows Installer.

A versão mínima do instalador exigida pelo executável de inicialização é 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 bootstrap 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 fornece um SIP (Subject Interface Package) para habilitar a assinatura de pacotes do Windows Installer.
  • Se necessário, atualiza a versão do Windows Installer no computador.

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

ID do recurso Descrição
ISETUPPROPNAME_BASEURL A localização do URL base do Setup.exe. Se nenhum valor for especificado, o local do Setup.exe terá como padrão a mídia removível. Somente instalações baseadas em URL estão sujeitas a uma verificação com WinVerifyTrust. A barra final nos URLs é opcional. Este recurso é opcional.
ISETUPPROPNAME_DATABASE O nome do ficheiro .msi. Este é um caminho relativo para o arquivo .msi especificado em relação ao local do programa Setup.exe. Este recurso é necessário se o recurso ISETUPPROPNAME_PATCH não for especificado. ISETUPPROPNAME_DATABASE e ISETUPPROPNAME_PATCH não podem ser especificados ao mesmo tempo. 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 pequeno ou menor. 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 inclui a verificação de bootstrap para a presença do produto. Se o produto estiver presente, o sinalizador do pacote de recache será definido e uma reinstalação será executada; caso contrário, uma instalação regular é executada. Observe que INSTALLUPD só deve ser usado para pacotes de atualização pequenos e menores em que o código do produto não está mudando. Em uma grande atualização, REINSTALL não é necessário porque o código do produto muda, em essência, criando um novo produto. A criação da tabela Upgrade, 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. Este recurso é opcional. Caso seja omitido, o nome define-se por padrão como "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, a Instmsi.exe apropriada será chamada para atualizar o Windows Installer. O valor dessa propriedade tem o mesmo formato que o valor PID_PAGECOUNT. Para obter mais informações, consulte a propriedade Resumo da contagem de páginas. Esse valor deve ser pelo menos 200, o valor que identifica o Windows Installer versão 2.0. Este recurso é necessário.
ISETUPPROPNAME_INSTLOCATION O local da URL base dos executáveis de atualização do Windows Installer. Este 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. Este é um caminho relativo para a versão ANSI do Instmsi.exe relativo ao local especificado pelo ISETUPPROPNAME_INSTLOCATION. Este recurso é necessário.
ISETUPPROPNAME_INSTMSIW O nome da versão Unicode do executável de atualização do Windows Installer. Este é um caminho relativo para a versão Unicode de Instmsi.exe em relação à localização especificada por ISETUPPROPNAME_INSTLOCATION. Este recurso é necessário.
ISETUPPROPNAME_PATCH O nome do arquivo .msp. Este é um caminho relativo para o arquivo .msp especificado em relação ao local do programa Setup.exe. Este recurso é necessário se a propriedade ISETUPPROPNAME_DATABASE não for especificada. 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. Estes são os pares PROPERTY=VALUE a serem incluídos na linha de comando. Esta opção é opcional.

 

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

Localização real do pacote Valores de recursos
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 = .. /Produtos1/product1.msi
e:\product1.msi Omitir ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = product1.msi
e:\setup\product1.msi (The currently running location of Setup.exe é e:\setup.exe.)
Omitir ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = Configuração\product1.msi

 

Setup.exe parâmetros de linha de comando

A tabela a seguir lista as opções de comando que podem ser usadas com o Setup.exe fornecido com o Windows SDK Components for Windows Installer Developers. Quando invocado sem opções 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 de cada vez.

Opção Utilização 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. Esta opção de linha de comando não é suportada se o recurso ISETUPPROPNAME_PATCH estiver configurado.
/a setup.exe /a<caminho completo para uma instalação administrativa existente> Se a propriedade ISETUPPROPNAME_PATCH estiver configurada em Setup.exe, essa opção poderá ser usada para corrigir uma instalação administrativa existente do produto. Esta opção de linha de comando não é suportada se o recurso ISETUPPROPNAME_DATABASE estiver configurado.
/v setup.exe /v<caminho completo para um arquivo> Verifica a assinatura no arquivo usando WinVerifyTrust. Nenhuma interface do usuário é exibida quando essa opção é usada. Neste caso, o resultado da verificação de confiança é o valor de retorno obtido a partir da execução de Setup.exe.
/?   Exibe uma caixa de diálogo de ajuda indicando os argumentos válidos. Nota: 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.