<Commands> 요소(부트스트래퍼)

Commands 요소는 InstallChecks 요소 아래의 요소에서 설명하는 테스트를 구현하고, 테스트에 실패하는 경우 ClickOnce 부트스트래퍼에서 설치해야 할 패키지를 선언합니다.

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

요소 및 특성

Commands 요소는 필수 항목입니다. 요소에는 다음과 같은 특성이 있습니다.

명령

Command 요소는 Commands 요소의 자식 요소입니다.Commands 요소에는 Command 요소가 하나 이상 있을 수 있습니다.이 요소에는 다음과 같은 특성이 있습니다.

InstallConditions

InstallConditions 요소는 Command 요소의 자식입니다.각 Command 요소에는 InstallConditions 요소가 하나만 있을 수 있습니다.InstallConditions 요소가 없으면 Condition에서 지정한 패키지가 항상 실행됩니다.

BypassIf

BypassIf 요소는 InstallConditions 요소의 자식이며, 명령을 실행하지 말아야 할 조건을 설명합니다.각 InstallConditions 요소에는 BypassIf 요소가 0개 이상 있을 수 있습니다.

BypassIf에는 다음과 같은 특성이 있습니다.

FailIf

FailIf 요소는 InstallConditions 요소의 자식이며, 설치를 중단해야 할 조건을 설명합니다.각 InstallConditions 요소에는 FailIf 요소가 0개 이상 있을 수 있습니다.

FailIf에는 다음과 같은 특성이 있습니다.

ExitCodes

ExitCodes 요소는 Command 요소의 자식입니다.ExitCodes 요소에는 패키지의 종료 코드에 대한 응답으로 설치에서 수행해야 할 작업을 결정하는 ExitCode 요소가 하나 이상 들어 있습니다.Command 요소 아래에 선택적 ExitCode 요소가 하나 있을 수 있습니다.ExitCodes에는 특성이 없습니다.

ExitCode

ExitCode 요소는 ExitCodes 요소의 자식입니다.ExitCode 요소는 패키지의 종료 코드에 대한 응답으로 설치에서 수행해야 할 작업을 결정합니다.ExitCode는 자식 요소를 포함하지 않고 다음과 같은 특성이 있습니다.

예제

다음 코드 예제에서는 .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>

참고 항목

참조

제품 및 패키지 스키마 참조

<InstallChecks> 요소(부트스트래퍼)