<Commands> 要素 (ClickOnce ブートストラップ)

更新 : 2007 年 11 月

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 要素を 1 つ以上持つことができます。この要素には、次の属性があります。

InstallConditions

InstallConditions 要素は、Command 要素に必須の子です。各 Command 要素は、1 つ以上の InstallConditions 要素を持つことができます。InstallConditions 要素が存在しない場合、Condition で指定されたパッケージが常に実行されます。

BypassIf

BypassIf 要素は InstallConditions 要素の子要素です。コマンドを実行しない場合の肯定条件を記述します。各 InstallConditions 要素は、BypassIf 要素を 0 個以上持つことができます。

BypassIf には、以下の属性があります。

FailIf

FailIf 要素は InstallConditions 要素の子要素です。インストールを中止する肯定条件を記述します。各 InstallConditions 要素は、FailIf 要素を 0 個以上持つことができます。

FailIf には、以下の属性があります。

ExitCodes

ExitCodes 要素は、Command 要素に必須の子です。ExitCodes 要素は、パッケージの終了コードに応じてインストールが実行する内容を指定する 1 つ以上の ExitCode 要素を含みます。Command 要素の下には、オプションで 1 個の 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> 要素 (ClickOnce ブートストラップ)