你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

名称	在	必需	类型	说明
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)	目标订阅的 ID。该值必须是 UUID。
api-version	query	True	string minLength: 1	用于此作的 API 版本。

请求正文

名称	类型	说明
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中找到的包版本。

响应

名称	类型	说明
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"
      }
    ]
  }
}

定义

名称	说明
CloudError	云端错误对象。
CloudErrorProperties	云错误对象属性。
createdByType	创建资源的标识的类型。
MSIXPackage	MSIX 包属性的架构。
MsixPackageApplications	MSIX 包应用程序属性的架构。
MsixPackageDependencies	MSIX 包依赖项属性的架构。
systemData	与创建和上次修改资源相关的元数据。

CloudError

对象

云端错误对象。

名称	类型	说明
error	CloudErrorProperties	云错误对象属性。

CloudErrorProperties

对象

云错误对象属性。

名称	类型	说明
code	string	错误代码
message	string	指示操作失败的原因的错误消息。

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

MSIXPackage

对象

MSIX 包属性的架构。

名称	类型	说明
id	string (arm-id)	资源的完全限定资源 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

对象

MSIX 包应用程序属性的架构。

名称	类型	说明
appId	string	包应用程序 ID，位于 appxmanifest.xml中。
appUserModelID	string	用于激活包应用程序。由包名称和 ApplicationID 组成。在 appxmanifest.xml中找到。
description	string	包应用程序的说明。
friendlyName	string	用户友好名称。
iconImageName	string	用户友好名称。
rawIcon	string (byte)	图标为 64 位字符串作为字节数组。
rawPng	string (byte)	图标为 64 位字符串作为字节数组。

MsixPackageDependencies

对象

MSIX 包依赖项属性的架构。

名称	类型	说明
dependencyName	string	包依赖项的名称。
minVersion	string	需要依赖项版本。
publisher	string	依赖项发布者的名称。

systemData

对象

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

通过