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

App Attach Package - Update

服务:: Desktop Virtualization

API 版本:: 2025-10-10

更新应用附加包

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/appAttachPackages/{appAttachPackageName}?api-version=2025-10-10

URI 参数

名称	在	必需	类型	说明
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]\|(-(?!-))){1,61}[a-z0-9]$	应用附加包的名称
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。此名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。该值必须是 UUID。
api-version	query	True	string minLength: 1	用于此作的 API 版本。

请求正文

名称	类型	说明
properties	AppAttachPackagePatchProperties	应用附加包的详细属性

响应

名称	类型	说明
200 OK	AppAttachPackage	已成功更新应用附件包。
Other Status Codes	ErrorResponse	描述作失败原因的自动化错误响应。

示例

AppAttachPackage_Update

示例请求

HTTP

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

示例响应

状态代码:: 200

{
  "name": "packageName",
  "id": "/subscriptions/d15725f7-6577-4a8c-95f1-3da903b42364/resourcegroups/charlesk-southcentralus/providers/Microsoft.DesktopVirtualization/appattachpackages/ModifierPackage",
  "type": "Microsoft.DesktopVirtualization/appattachpackages",
  "location": "southcentralus",
  "tags": {},
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2023-09-28T23:44:56.13Z",
    "lastModifiedBy": "user1",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2023-10-09T01:43:31.07Z"
  },
  "properties": {
    "image": {
      "packageAlias": "msixpackagealias",
      "imagePath": "imagepath",
      "packageName": "MsixPackageName",
      "packageFamilyName": "MsixPackage_FamilyName",
      "packageFullName": "MsixPackage_FullName",
      "displayName": "displayname",
      "packageRelativePath": "packagerelativepath",
      "isRegularRegistration": false,
      "isActive": false,
      "packageDependencies": [
        {
          "dependencyName": "MsixPackage_Dependency_Name",
          "publisher": "MsixPackage_Dependency_Publisher",
          "minVersion": "packageDep_version"
        }
      ],
      "version": "packageversion",
      "lastUpdated": "2008-09-22T14:01:54.9571247Z",
      "packageApplications": [
        {
          "appId": "AppId",
          "description": "PackageApplicationDescription",
          "appUserModelID": "AppUserModelId",
          "friendlyName": "FriendlyName",
          "iconImageName": "Iconimagename",
          "rawIcon": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo",
          "rawPng": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"
        }
      ],
      "certificateName": "certName",
      "certificateExpiry": "2023-01-02T17:18:19.1234567Z"
    },
    "hostPoolReferences": [],
    "failHealthCheckOnStagingFailure": "NeedsAssistance",
    "keyVaultURL": ""
  }
}

定义

名称	说明
AppAttachPackage	应用附加包属性的架构。
AppAttachPackageInfoProperties	导入包信息属性的架构。
AppAttachPackagePatch	可更新的应用附加包属性的架构。
AppAttachPackagePatchProperties	应用附加包上可修补字段的架构。
AppAttachPackageProperties	应用附加包属性的架构。
createdByType	创建资源的标识的类型。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
failHealthCheckOnStagingFailure	指示如果此包无法暂存，运行状况检查的行为方式的参数
MsixPackageApplications	MSIX 包应用程序属性的架构。
MsixPackageDependencies	MSIX 包依赖项属性的架构。
packageTimestamped	包是否带有时间戳，以便可以忽略证书到期日期
ProvisioningState	当前预配状态。
systemData	与创建和上次修改资源相关的元数据。

AppAttachPackage

对象

应用附加包属性的架构。

名称	类型	说明
id	string (arm-id)	资源的完全限定资源 ID。例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
location	string	资源所在的地理位置
name	string	资源的名称
properties	AppAttachPackageProperties	应用附加包的详细属性
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	资源标记。
type	string	资源类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

AppAttachPackageInfoProperties

对象

导入包信息属性的架构。

名称	类型	说明
certificateExpiry	string (date-time)	日期证书过期，在 appxmanifest.xml中找到。
certificateName	string	在 appxmanifest.xml中找到的证书名称。
displayName	string	要显示在门户中的用户友好名称。
imagePath	string	网络共享上的 VHD/CIM 映像路径。
isActive	boolean	将此版本的包设为主机池中的活动包。
isPackageTimestamped	packageTimestamped	包是否带有时间戳，以便可以忽略证书到期日期
isRegularRegistration	boolean	指定如何在源中注册包。
lastUpdated	string (date-time)	上次更新日期包，在 appxmanifest.xml中找到。
packageAlias	string	应用附加包的别名。在导入时分配
packageApplications	MsixPackageApplications[]	包应用程序列表。
packageDependencies	MsixPackageDependencies[]	包依赖项列表。
packageFamilyName	string	来自 appxmanifest.xml的包系列名称。包含包名称和发布服务器名称。
packageFullName	string	来自 appxmanifest.xml的包全名。
packageName	string	来自 appxmanifest.xml的包名称。
packageRelativePath	string	映像中包的相对路径。
version	string	在 appxmanifest.xml中找到的包版本。

AppAttachPackagePatch

对象

可更新的应用附加包属性的架构。

名称	类型	说明
id	string (arm-id)	资源的完全限定资源 ID。例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	资源的名称
properties	AppAttachPackagePatchProperties	应用附加包的详细属性
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

AppAttachPackagePatchProperties

对象

应用附加包上可修补字段的架构。

名称	类型	说明
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	指示如果此包无法暂存，运行状况检查的行为方式的参数
hostPoolReferences	string[] (arm-id)	Hostpool 资源 ID 的列表。
image	AppAttachPackageInfoProperties	应用附加包的详细属性
keyVaultURL	string	keyVault 中证书名称的 URL 路径

AppAttachPackageProperties

对象

应用附加包属性的架构。

名称	类型	说明
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	指示如果此包无法暂存，运行状况检查的行为方式的参数
hostPoolReferences	string[]	Hostpool 资源 ID 的列表。
image	AppAttachPackageInfoProperties	应用附加包的详细属性
keyVaultURL	string	keyVault 中证书名称的 URL 路径
provisioningState	ProvisioningState	应用附加包的预配状态。

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

对象

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

对象

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

对象

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

failHealthCheckOnStagingFailure

枚举

指示如果此包无法暂存，运行状况检查的行为方式的参数

值	说明
Unhealthy
NeedsAssistance
DoNotFail

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	依赖项发布者的名称。

packageTimestamped

枚举

包是否带有时间戳，以便可以忽略证书到期日期

值	说明
Timestamped
NotTimestamped

ProvisioningState

枚举

当前预配状态。

值	说明
Succeeded
Provisioning
Failed
Canceled

systemData

对象

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

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

通过