<commands>Elemento (ClickOnce Bootstrapper)

The Commands elemento implementa testes descritos por elementos sob a InstallChecks elemento e qual pacote declara o ClickOnce bootstrapper deve instalar se o teste falhar.

<Commands
    Reboot
>
    <Command
        PackageFile
        Arguments
        EstimatedInstallSeconds
        EstimatedDiskBytes
        EstimatedTempBytes
        Log
    >
        <InstallConditions>
            <BypassIf 
                Property
                Compare
                Value
                Schedule
            />
            <FailIf 
                Property
                Compare
                Value
                String
                Schedule
            />
        </InstallConditions>
        <ExitCodes>
            <ExitCode 
                Value
                Result
                String
            />
        </ExitCodes>
    </Command>
</Commands>

Elementos e atributos

The Commands elemento é necessário. O elemento tem o atributo a seguir.

Atributo	Descrição
Reboot	Opcional. Determina se o sistema deve reiniciar se qualquer um dos pacotes retornar um código de sair de reinicialização. A lista a seguir mostra os valores válido: Adiar. A reinicialização é adiada até algum time de futuro. Imediata. Faz com que uma reinicialização imediata se um dos pacotes retornar um código de sair de reinicialização. Nenhum. Faz com que todas as solicitações de reinício seja ignorado. O padrão é Imediata.

Reboot

Opcional. Determina se o sistema deve reiniciar se qualquer um dos pacotes retornar um código de sair de reinicialização. A lista a seguir mostra os valores válido:

Adiar. A reinicialização é adiada até algum time de futuro.

Imediata. Faz com que uma reinicialização imediata se um dos pacotes retornar um código de sair de reinicialização.

Nenhum. Faz com que todas as solicitações de reinício seja ignorado.

O padrão é Imediata.

Comando

Um elemento Command é um filho do elemento Commands. A Commands elemento pode ter um ou mais Command elementos. O elemento tem os seguintes atributos.

Atributo	Descrição
PackageFile	Obrigatório. O nome do pacote para instalar deve uma ou mais das condições especificadas por InstallConditions retornará false. O pacote deve ser definido no mesmo arquivo usando um PackageFile elemento.
Arguments	Opcional. Um conjunto de argumentos de linha de comando para passar para o arquivo de pacote.
EstimatedInstallSeconds	Opcional. O time estimado (em segundos, levará para instalar o pacote. Esse valor determina o dimensionar da BAR de progresso que exibe o bootstrapper para o usuário. O padrão é 0, caso em que nenhum período de previsão é especificado.
EstimatedDiskBytes	Opcional. A quantidade estimada de espaço em disco, em bytes, que o pacote ocupará após a instalação estará concluída. Esse valor é usado no disco rígido espaço em disco requisitos que o bootstrapper exibe para o usuário. O padrão é 0, nesse caso o bootstrapper não exibe qualquer disco rígido espaço em disco requisitos.
EstimatedTempBytes	Opcional. A quantidade estimada de espaço temporário em disco, em bytes, que exigirão que o pacote.
Log	Opcional. O caminho para o arquivo de log que gera o pacote, em relação à diretório raiz do pacote.

InstallConditions

The InstallConditions elemento é filho do Command elemento. Cada Command elemento pode ter no máximo uma InstallConditions elemento. Se nenhum InstallConditions elemento existir, o pacote especificado por Condition sempre será executado.

BypassIf

The BypassIf elemento é filho do InstallConditions elemento e descreve uma condição positiva sob a qual o comando não deve ser executado. Cada InstallConditions elemento pode ter zero ou mais BypassIf elementos.

BypassIf tem os seguintes atributos.

Atributo	Descrição
Property	Obrigatório. O nome da propriedade para testar. A propriedade deve anteriormente foram definida por um filho do InstallChecks elemento. Para obter mais informações, consulte <installchecks>Elemento (ClickOnce Bootstrapper).
Compare	Obrigatório. O tipo de comparação para executar. A lista a seguir mostra os valores válido: ValueEqualTo, ValueNotEqualTo, ValueGreaterThan, ValueGreaterThanOrEqualTo, ValueLessThan, ValueLessThanOrEqualTo, VersionEqualTo, VersionNotEqualTo, VersionGreaterThan, VersionGreaterThanOrEqualTo, VersionLessThan, VersionLessThanOrEqualTo, ValueExists, ValueNotExists
Value	Obrigatório. O valor a ser comparado com a propriedade.
Schedule	Opcional. O nome de um Schedule marca que define quando esta regra deve ser avaliada.

FailIf

The FailIf elemento é filho do InstallConditions elemento e descreve uma condição positiva sob a qual deve interromper a instalação. Cada InstallConditions elemento pode ter zero ou mais FailIf elementos.

FailIf tem os seguintes atributos.

Atributo	Descrição
Property	Obrigatório. O nome da propriedade para testar. A propriedade deve anteriormente foram definida por um filho do InstallChecks elemento. Para obter mais informações, consulte <installchecks>Elemento (ClickOnce Bootstrapper).
Compare	Obrigatório. O tipo de comparação para executar. A lista a seguir mostra os valores válido: ValueEqualTo, ValueNotEqualTo, ValueGreaterThan, ValueGreaterThanOrEqualTo, ValueLessThan, ValueLessThanOrEqualTo, VersionEqualTo, VersionNotEqualTo, VersionGreaterThan, VersionGreaterThanOrEqualTo, VersionLessThan, VersionLessThanOrEqualTo, ValueExists, ValueNotExists
Value	Obrigatório. O valor a ser comparado com a propriedade.
String	Opcional. O texto a ser exibido para o usuário em caso de falha.
Schedule	Opcional. O nome de um Schedule marca que define quando esta regra deve ser avaliada.

ExitCodes

The ExitCodes elemento é filho do Command elemento. The ExitCodes elemento contém um ou mais ExitCode elementos, que determinam o que deve fazer a instalação em resposta a um código de sair de um pacote. Pode haver um opcional ExitCode elemento sob um Command elemento. ExitCodes tem sem atributos.

Código_de_saída

The ExitCode elemento é filho do ExitCodes elemento. The ExitCode elemento determina o que deve fazer a instalação em resposta a um código de sair de um pacote. ExitCode contém nenhum elemento filho e tem os seguintes atributos.

Atributo	Descrição
Value	Obrigatório. O valor do código de sair ao qual o ExitCode elemento aplica.
Result	Obrigatório. Como a instalação deve reagir a este código de sair. A lista a seguir mostra os valores válido: Sucesso. Sinalizadores do pacote instalado sistema autônomo com êxito. SuccessReboot. O pacote de sinalizadores sistema autônomo instalados com êxito e instrui o sistema reiniciar. Falha. O pacote de sinalizadores sistema autônomo falhou. FailReboot. O pacote de sinalizadores com falha e orienta a reinicialização do sistema.
String	Opcional. O valor seja exibido para o usuário em resposta a esse código de sair.
FormatMessageFromSystem	Opcional. Determina se usar a mensagem de erro fornecido pelo sistema correspondente ao código de sair, ou usar o valor fornecido em String. Os valores válido são True, que significa que para usar o erro fornecido pelo sistema e False, que significa usar a seqüência de caracteres fornecida pelo String. O padrão é false. Se essa propriedade for False, but String não é definido, que será usado o erro fornecido pelo sistema.

Exemplo

O exemplo de código a seguir define os comandos para instalar o .NET estrutura 2.0.

<Commands Reboot="Immediate">
    <Command PackageFile="instmsia.exe"
             Arguments= ' /q /c:"msiinst /delayrebootq"'
             EstimatedInstallSeconds="20" >
        <InstallConditions>
           <BypassIf Property="VersionNT" Compare="ValueExists"/>
             BypassIf Property="VersionMsi" Compare="VersionGreaterThanOrEqualTo" Value="2.0"/>
        </InstallConditions>
        <ExitCodes>
            <ExitCode Value="0" Result="SuccessReboot"/>
            <ExitCode Value="1641" Result="SuccessReboot"/>
            <ExitCode Value="3010" Result="SuccessReboot"/>
            <DefaultExitCode Result="Fail" FormatMessageFromSystem="true" String="GeneralFailure" />
        </ExitCodes>
    </Command>
    <Command PackageFile="WindowsInstaller-KB884016-v2-x86.exe"
             Arguments= '/quiet /norestart' 
             EstimatedInstallSeconds="20" >
      <InstallConditions>
          <BypassIf Property="Version9x" Compare="ValueExists"/>
          <BypassIf Property="VersionNT" Compare="VersionLessThan" Value="5.0.3"/>
          <BypassIf Property="VersionMsi" Compare="VersionGreaterThanOrEqualTo" Value="3.0"/>
          <FailIf Property="AdminUser" Compare="ValueEqualTo" Value="false" String="AdminRequired"/>
      </InstallConditions>
      <ExitCodes>
          <ExitCode Value="0" Result="Success"/>
          <ExitCode Value="1641" Result="SuccessReboot"/>
          <ExitCode Value="3010" Result="SuccessReboot"/>
          <DefaultExitCode Result="Fail" FormatMessageFromSystem="true" String="GeneralFailure" />
      </ExitCodes>
    </Command>
    <Command PackageFile="dotnetfx.exe" 
         Arguments=' /q:a /c:"install /q /l"' 
         EstimatedInstalledBytes="21000000" 
         EstimatedInstallSeconds="300">

        <!-- These checks determine whether the package is to be installed -->
        <InstallConditions>
            <!-- Either of these properties indicates the .Net Framework is already installed -->
            <BypassIf Property="DotNetInstalled" Compare="ValueNotEqualTo" Value="0"/>

            <!-- Block install if user does not have adminpermissions -->
            <FailIf Property="AdminUser" Compare="ValueEqualTo" Value="false" String="AdminRequired"/>

            <!-- Block install on Windows 95 -->
            <FailIf Property="Version9X" Compare="VersionLessThan" Value="4.10" String="InvalidPlatformWin9x"/>

            <!-- Block install on Windows 2000 SP 2 or less -->
            <FailIf Property="VersionNT" Compare="VersionLessThan" Value="5.0.3" String="InvalidPlatformWinNT"/>

            <!-- Block install if Internet Explorer 5.01 or later is not present -->
            <FailIf Property="IEVersion" Compare="ValueNotExists" String="InvalidPlatformIE" />
            <FailIf Property="IEVersion" Compare="VersionLessThan" Value="5.01" String="InvalidPlatformIE" />

            <!-- Block install if the operating system does not support x86 -->
            <FailIf Property="ProcessorArchitecture" Compare="ValueNotEqualTo" Value="Intel" String="InvalidPlatformArchitecture" />
       </InstallConditions>

        <ExitCodes>
            <ExitCode Value="0" Result="Success"/>
            <ExitCode Value="3010" Result="SuccessReboot"/>
            <ExitCode Value="4097" Result="Fail" String="AdminRequired"/>
            <ExitCode Value="4098" Result="Fail" String="WindowsInstallerComponentFailure"/>
            <ExitCode Value="4099" Result="Fail" String="WindowsInstallerImproperInstall"/>
            <ExitCode Value="4101" Result="Fail" String="AnotherInstanceRunning"/>
            <ExitCode Value="4102" Result="Fail" String="OpenDatabaseFailure"/>
            <ExitCode Value="4113" Result="Fail" String="BetaNDPFailure"/>
            <DefaultExitCode Result="Fail" FormatMessageFromSystem="true" String="GeneralFailure" />
        </ExitCodes>

    </Command>
</Commands>

Consulte também

Referência

Produto e referência do esquema do pacote

<installchecks>Elemento (ClickOnce Bootstrapper)

Last updated on 2010-08-25

Partilhar via