<Commands> Element (program inicjujący)

Artykuł
02/27/2013

Commands Element implementuje badań opisanych przez elementów znajdujących się pod InstallChecks element i deklaruje, który pakiet ClickOnce należy zainstalować program inicjujący, jeśli test zakończy się niepowodzeniem.

<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>

Elementy i atrybuty

Commands Element jest wymagany.Element ma następujący atrybut.

Atrybut	Opis
Reboot	Opcjonalne.Określa, czy system należy ponownie uruchomić, jeśli któregokolwiek z pakietów zwraca kod zakończenia ponownego uruchomienia komputera.Na poniższej liście przedstawiono prawidłowe wartości: Odroczenie.Ponowne uruchomienie jest odroczone do czasu przyszłości. Natychmiastowe.Powoduje natychmiastowe ponowne uruchomienie, jeżeli jeden z pakietów zwrócił kod zakończenia ponownego uruchomienia komputera. Brak.Powoduje, że wszystkie żądania ponownego uruchomienia komputera będzie pomijany. Wartością domyślną jest natychmiastowe.

Reboot

Opcjonalne.Określa, czy system należy ponownie uruchomić, jeśli któregokolwiek z pakietów zwraca kod zakończenia ponownego uruchomienia komputera.Na poniższej liście przedstawiono prawidłowe wartości:

Odroczenie.Ponowne uruchomienie jest odroczone do czasu przyszłości.

Natychmiastowe.Powoduje natychmiastowe ponowne uruchomienie, jeżeli jeden z pakietów zwrócił kod zakończenia ponownego uruchomienia komputera.

Brak.Powoduje, że wszystkie żądania ponownego uruchomienia komputera będzie pomijany.

Wartością domyślną jest natychmiastowe.

Polecenie

Command Element jest elementem podrzędnym elementu Commands element.A Commands element może mieć jeden lub więcej Command elementy.Atrybuty elementu.

Atrybut	Opis
PackageFile	Wymagane.Nazwa pakietu do zainstalowania powinny jeden lub więcej warunków określonych przez InstallConditions return false.Pakiet musi być zdefiniowana w tym samym pliku za pomocą PackageFile element.
Arguments	Opcjonalne.Zestaw argumenty wiersza polecenia do przekazania do pliku pakietu.
EstimatedInstallSeconds	Opcjonalne.Szacowany czas w sekundach, będzie trwało do zainstalowania pakietu.Ta wartość określa rozmiar paska postępu, który program inicjujący wyświetla użytkownikowi.Wartość domyślna to 0, w którym to przypadku nie szacowania jest określony czas.
EstimatedDiskBytes	Opcjonalne.Szacunkowa ilość miejsca na dysku, w bajtach, które pakiet zajmie się po zakończeniu instalacji został zakończony.Ta wartość jest używana w wymagania dotyczące miejsca na dysku twardym, które program inicjujący wyświetla użytkownikowi.Wartość domyślna to 0, w przypadku program inicjujący nie wyświetla wszelkie wymagania dotyczące miejsca na dysku twardym.
EstimatedTempBytes	Opcjonalne.Szacunkowa kwota tymczasowego miejsca na dysku, w bajtach, wymagających pakietu.
Log	Opcjonalne.Ścieżka do pliku dziennika, generujący pakiet, względem katalogu głównego pakietu.

InstallConditions

InstallConditions Element jest elementem podrzędnym Command element.Każdy Command element może mieć co najwyżej jeden InstallConditions element.Jeśli nie InstallConditions istnieje element, pakiet, określonej przez Condition będą zawsze uruchamiane.

BypassIf

BypassIf Element jest elementem podrzędnym InstallConditions element i opisuje pozytywny warunek, w jakich powinny nie można wykonać tego polecenia.Każdy InstallConditions element może mieć zero lub więcej BypassIf elementy.

BypassIfma następujące atrybuty.

Atrybut	Opis
Property	Wymagane.Nazwa właściwości, aby przetestować.Właściwość musi wcześniej zostały określone przez dziecko InstallChecks element.Aby uzyskać więcej informacji, zobacz <InstallChecks> Element (program inicjujący).
Compare	Wymagane.Typ porównania do wykonania.Na poniższej liście przedstawiono prawidłowe wartości: ValueEqualTo, ValueNotEqualTo, ValueGreaterThan, ValueGreaterThanOrEqualTo, ValueLessThan, ValueLessThanOrEqualTo, VersionEqualTo, VersionNotEqualTo, VersionGreaterThan, VersionGreaterThanOrEqualTo, VersionLessThan, VersionLessThanOrEqualTo, ValueExists, ValueNotExists
Value	Wymagane.Wartość do porównania z właściwością.
Schedule	Opcjonalne.Nazwa Schedule znacznika, który definiuje, kiedy należy ocenić tę regułę.

FailIf

FailIf Element jest elementem podrzędnym InstallConditions element i opisuje pozytywny warunek, jakich należy przerwać instalację.Każdy InstallConditions element może mieć zero lub więcej FailIf elementy.

FailIfma następujące atrybuty.

Atrybut	Opis
Property	Wymagane.Nazwa właściwości, aby przetestować.Właściwość musi wcześniej zostały określone przez dziecko InstallChecks element.Aby uzyskać więcej informacji, zobacz <InstallChecks> Element (program inicjujący).
Compare	Wymagane.Typ porównania do wykonania.Na poniższej liście przedstawiono prawidłowe wartości: ValueEqualTo, ValueNotEqualTo, ValueGreaterThan, ValueGreaterThanOrEqualTo, ValueLessThan, ValueLessThanOrEqualTo, VersionEqualTo, VersionNotEqualTo, VersionGreaterThan, VersionGreaterThanOrEqualTo, VersionLessThan, VersionLessThanOrEqualTo, ValueExists, ValueNotExists
Value	Wymagane.Wartość do porównania z właściwością.
String	Opcjonalne.Tekst wyświetlany dla użytkownika w przypadku awarii.
Schedule	Opcjonalne.Nazwa Schedule znacznika, który definiuje, kiedy należy ocenić tę regułę.

ExitCodes

ExitCodes Element jest elementem podrzędnym Command element.ExitCodes Element zawiera jeden lub więcej ExitCode elementów, które określają, w odpowiedzi na kod wyjścia z pakietu należy wykonać instalacji.Może istnieć jeden opcjonalny ExitCode elementów znajdujących się pod Command element.ExitCodesposiada żadnych atrybutów.

ExitCode

ExitCode Element jest elementem podrzędnym ExitCodes element.ExitCode Element określa, w odpowiedzi na kod wyjścia z pakietu należy wykonać instalacji.ExitCodezawiera nie elementów podrzędnych i ma następujące atrybuty.

Atrybut	Opis
Value	Wymagane.Wartość kodu wyjścia, do której ta ExitCode stosuje się element.
Result	Wymagane.W jaki sposób instalacji powinny reagować na ten kod wyjścia.Na poniższej liście przedstawiono prawidłowe wartości: Sukces.Flagi pakietu, jak pomyślnie zainstalowana. SuccessReboot.Flagi pakietu, jak pomyślnie zainstalowany i powoduje, że ponowne uruchomienie systemu. Niepowodzenie.Flagi pakietu, ponieważ nie powiodło się. FailReboot.Flagi pakietu, ponieważ nie powiodło się i powoduje, że ponowne uruchomienie systemu.
String	Opcjonalne.Wartość wyświetlaną użytkownika, w odpowiedzi na ten kod wyjścia.
FormatMessageFromSystem	Opcjonalne.Określa, czy użyć komunikat błędu w systemie odpowiadające kod wyjścia lub wartość podana w String.Prawidłowe wartości to true, oznacza błędy dostarczonych do systemu i false, co oznacza, należy użyć ciągu dostarczonych przez String.Wartością domyślną jest false.Jeśli ta właściwość jest false, ale String nie jest set błędu w systemie będą używane.

Przykład

Poniższy przykład kodu definiuje polecenia do instalowania.NET Framework 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>

Zobacz też

Informacje

Produkt i pakiet schematu odwołania

<InstallChecks> Element (program inicjujący)

Udostępnij za pośrednictwem