MSIX Packages - Create Or Update

服務:: Desktop Virtualization

API 版本:: 2025-10-10

建立或更新 MSIX 套件。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/msixPackages/{msixPackageFullName}?api-version=2025-10-10

URI 參數

名稱	位於	必要	類型	Description
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	指定資源群組內主機集區的名稱
msixPackageFullName	path	True	string minLength: 3 maxLength: 100 pattern: ^[A-Za-z0-9@.\-_ ]*$	指定主機集區內 MSIX 套件的版本特定套件完整名稱
resourceGroupName	path	True	string minLength: 1 maxLength: 90	資源群組的名稱。名稱不區分大小寫。
subscriptionId	path	True	string (uuid)	目標訂用帳戶的標識碼。此值必須是 UUID。
api-version	query	True	string minLength: 1	用於此作業的 API 版本。

要求本文

名稱	類型	Description
properties.displayName	string	要顯示在入口網站中的使用者易記名稱。
properties.imagePath	string	網路共用上的 VHD/CIM 映射路徑。
properties.isActive	boolean	將此版本的套件設為跨主機集區的作用中套件。
properties.isRegularRegistration	boolean	指定如何在摘要中註冊封裝。
properties.lastUpdated	string (date-time)	上次更新日期套件，可在 appxmanifest.xml中找到。
properties.packageApplications	MsixPackageApplications[]	套件應用程式清單。
properties.packageDependencies	MsixPackageDependencies[]	套件相依性清單。
properties.packageFamilyName	string	appxmanifest.xml的套件系列名稱。包含套件名稱和發行者名稱。
properties.packageName	string	appxmanifest.xml的套件名稱。
properties.packageRelativePath	string	映射內封裝的相對路徑。
properties.version	string	在 appxmanifest.xml中找到的套件版本。

回應

名稱	類型	Description
200 OK	MSIXPackage	已成功更新 MSIX 套件。
201 Created	MSIXPackage	成功建立 MSIX 套件。
Other Status Codes	CloudError	自動化錯誤回應，說明作業失敗的原因。

範例

MSIXPackage_Create

範例要求

HTTP

PUT https://management.azure.com/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostpool1/msixPackages/msixpackagefullname?api-version=2025-10-10

{
  "properties": {
    "displayName": "displayname",
    "imagePath": "imagepath",
    "isActive": false,
    "isRegularRegistration": false,
    "lastUpdated": "2008-09-22T14:01:54.9571247Z",
    "packageApplications": [
      {
        "description": "application-desc",
        "appId": "ApplicationId",
        "appUserModelID": "AppUserModelId",
        "friendlyName": "friendlyname",
        "iconImageName": "Apptile",
        "rawIcon": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo",
        "rawPng": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"
      }
    ],
    "packageDependencies": [
      {
        "dependencyName": "MsixTest_Dependency_Name",
        "minVersion": "version",
        "publisher": "PublishedName"
      }
    ],
    "packageFamilyName": "MsixPackage_FamilyName",
    "packageName": "MsixPackage_name",
    "packageRelativePath": "packagerelativepath",
    "version": "version"
  }
}

範例回覆

狀態碼:: 200

{
  "name": "hostpool1/MsixPackageFullName",
  "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourcegroups/resourcegroup1/providers/Microsoft.DesktopVirtualization/hostpools/hostpool1/msixpackages/msixPackageFullName",
  "type": "Microsoft.DesktopVirtualization/hostpools/msixpackages",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "imagePath": "imagepath",
    "packageName": "MsixPackage_Name",
    "packageFamilyName": "MsixPackage_FamilyName",
    "displayName": "dis",
    "packageRelativePath": "MsixPackage_RelativePackageRoot",
    "isRegularRegistration": false,
    "isActive": false,
    "packageDependencies": [
      {
        "dependencyName": "MsixPackage_Dependency_Name",
        "publisher": "MsixPackage_Dependency_Publisher",
        "minVersion": "packageDep_version"
      }
    ],
    "version": "version",
    "lastUpdated": "2008-09-22T14:01:54.9571247Z",
    "packageApplications": [
      {
        "appId": "Application_Id",
        "description": "desc",
        "appUserModelID": "Application_ModelID",
        "friendlyName": "fri",
        "iconImageName": "Apptile",
        "rawIcon": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo",
        "rawPng": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"
      }
    ]
  }
}

狀態碼:: 201

{
  "name": "hostpool1/MsixPackageFullName",
  "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourcegroups/resourcegroup1/providers/Microsoft.DesktopVirtualization/hostpools/hostpool1/msixpackages/msixPackageFullName",
  "type": "Microsoft.DesktopVirtualization/hostpools/msixpackages",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "imagePath": "imagepath",
    "packageName": "MsixPackage_Name",
    "packageFamilyName": "MsixPackage_FamilyName",
    "displayName": "dis",
    "packageRelativePath": "MsixPackage_RelativePackageRoot",
    "isRegularRegistration": false,
    "isActive": true,
    "packageDependencies": [
      {
        "dependencyName": "MsixPackage_Dependency_Name",
        "publisher": "MsixPackage_Dependency_Publisher",
        "minVersion": "packageDep_version"
      }
    ],
    "version": "version",
    "lastUpdated": "2008-09-22T14:01:54.9571247Z",
    "packageApplications": [
      {
        "appId": "Application_Id",
        "description": "desc",
        "appUserModelID": "Application_ModelID",
        "friendlyName": "fri",
        "iconImageName": "Apptile",
        "rawIcon": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo",
        "rawPng": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"
      }
    ]
  }
}

定義

名稱	Description
CloudError	雲端錯誤物件。
CloudErrorProperties	雲端錯誤物件屬性。
createdByType	建立資源的身分識別類型。
MSIXPackage	MSIX 套件屬性的架構。
MsixPackageApplications	MSIX 套件應用程式屬性的架構。
MsixPackageDependencies	MSIX 套件相依性屬性的架構。
systemData	與建立和上次修改資源相關的元數據。

CloudError

Object

雲端錯誤物件。

名稱	類型	Description
error	CloudErrorProperties	雲端錯誤物件屬性。

CloudErrorProperties

Object

雲端錯誤物件屬性。

名稱	類型	Description
code	string	錯誤碼
message	string	錯誤訊息，指出作業失敗的原因。

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

MSIXPackage

Object

MSIX 套件屬性的架構。

名稱	類型	Description
id	string (arm-id)	資源的完整資源標識碼。例如 “/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	資源的名稱
properties.displayName	string	要顯示在入口網站中的使用者易記名稱。
properties.imagePath	string	網路共用上的 VHD/CIM 映射路徑。
properties.isActive	boolean	將此版本的套件設為跨主機集區的作用中套件。
properties.isRegularRegistration	boolean	指定如何在摘要中註冊封裝。
properties.lastUpdated	string (date-time)	上次更新日期套件，可在 appxmanifest.xml中找到。
properties.packageApplications	MsixPackageApplications[]	套件應用程式清單。
properties.packageDependencies	MsixPackageDependencies[]	套件相依性清單。
properties.packageFamilyName	string	appxmanifest.xml的套件系列名稱。包含套件名稱和發行者名稱。
properties.packageName	string	appxmanifest.xml的套件名稱。
properties.packageRelativePath	string	映射內封裝的相對路徑。
properties.version	string	在 appxmanifest.xml中找到的套件版本。
systemData	systemData	與建立和上次修改資源相關的元數據。
type	string	資源的類型。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

MsixPackageApplications

Object

MSIX 套件應用程式屬性的架構。

名稱	類型	Description
appId	string	套件應用程式識別碼，位於 appxmanifest.xml。
appUserModelID	string	用來啟動封裝應用程式。由套件名稱和ApplicationID所組成。在 appxmanifest.xml中找到。
description	string	封裝應用程式的描述。
friendlyName	string	用戶易記名稱。
iconImageName	string	用戶易記名稱。
rawIcon	string (byte)	圖示 64 位字串做為位元組陣列。
rawPng	string (byte)	圖示 64 位字串做為位元組陣列。

MsixPackageDependencies

Object

MSIX 套件相依性屬性的架構。

名稱	類型	Description
dependencyName	string	套件相依性的名稱。
minVersion	string	需要相依性版本。
publisher	string	相依性發行者的名稱。

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

共用方式為

MSIX Packages - Create Or Update

URI 參數

要求本文

回應

範例

MSIXPackage_Create

範例要求

範例回覆

定義

CloudError

CloudErrorProperties

createdByType

MSIXPackage

MsixPackageApplications

MsixPackageDependencies

systemData