desktop6：InstallAction

指定在桌面應用程式第一次啟動之前執行的安裝程式檔案（.exe 或 .msi]。

注意

此元素目前僅供封裝在 MSIXVC 容器中的桌面電腦遊戲使用。 它需要 customInstallActions受限制的功能。

元素階層

<套件>

     <擴充功能>

          <desktop6：Extension>

               <desktop6：CustomInstall>

                    <desktop6：InstallActions>

                        <desktop6：InstallAction>

語法

<desktop6:InstallAction
  File = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  Name = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  Arguments = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' />

屬性和元素

屬性

屬性	描述	數據類型	必填	預設值
檔案	要執行的檔名（.exe 或 .msi）。 此檔案必須存在於您的套件中。 您可以指定相對於 desktop6 Folder 屬性的路徑。CustomInstall 元素。 您無法指定絕對路徑，而且相對路徑不得以 \ 字元開頭。	長度介於 1 到 256 個字元的字串，不能包含下列字元：<、>、:、"、|、?或 *。	是的
名稱	安裝動作的名稱。 此名稱用來識別安裝動作，而OS會使用此名稱來追蹤已成功執行的動作。 請確定此值符合對應 desktop6：RepairAction 的 Name 屬性，並 desktop6：UninstallAction 您想要在相同序列中執行的元素。 此名稱在傳統型 desktop6：InstallActions 元素中必須是唯一的，但可由 desktop6：RepairActions 和 desktop6：UninstallActions 元素下的其他動作共用。	長度介於 1 到 32767 個字元的字串，其開頭和結尾有非空格符。	是的
自變數	要傳遞至安裝程式檔案的選擇性自變數。	長度介於 1 到 32767 個字元的字串，其開頭和結尾有非空格符。	不

子專案

沒有

父元素

父元素	描述
desktop6：InstallActions	指定在桌面應用程式第一次啟動之前執行的安裝程式檔案（.exe 或 .msi）。

言論

此元素需要 customInstallActions受限制的功能。

例子

<Package
  xmlns:desktop6="http://schemas.microsoft.com/appx/manifest/desktop/windows10/6"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  IgnorableNamespaces="rescap desktop6">

  <!-- ... -->
  <!-- Other entries omitted for brevity. -->
  <!-- ... -->

  <Extensions>
    <desktop6:Extension Category="windows.customInstall">
      <desktop6:CustomInstall Folder="MyInstallers">
        <desktop6:InstallActions>
          <desktop6:InstallAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/add /silent" />
        </desktop6:InstallActions>
        <desktop6:RepairActions>
          <desktop6:RepairAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/add /silent /force" />
        </desktop6:RepairActions>
        <desktop6:UninstallActions>
          <desktop6:UninstallAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/remove /silent" />
        </desktop6:UninstallActions>
      </desktop6:CustomInstall>
    </desktop6:Extension>
  </Extensions>

  <Capabilities>
    <rescap:Capability Name="customInstallActions"/>
  </Capabilities>
</Package>

要求

專案	價值
Namespace	http://schemas.microsoft.com/appx/manifest/desktop/windows10/6
最低 OS 版本	Windows 10 版本 1903 （組建 18362）