App Attach Package - Update

Servicio:: Desktop Virtualization

Versión de la API:: 2025-10-10

Actualizar un paquete de App Attach

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]\|(-(?!-))){1,61}[a-z0-9]$	El nombre del paquete de App Attach
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
properties	AppAttachPackagePatchProperties	Propiedades detalladas del paquete de asociación de aplicaciones

Respuestas

Nombre	Tipo	Description
200 OK	AppAttachPackage	Actualización exitosa del paquete de vinculación de aplicaciones.
Other Status Codes	ErrorResponse	Respuesta de error de automatización que describe por qué falló la operación.

Ejemplos

AppAttachPackage_Update

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 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": ""
  }
}

Definiciones

Nombre	Description
AppAttachPackage	Esquema para las propiedades del paquete de asociación de aplicaciones.
AppAttachPackageInfoProperties	Esquema para las propiedades de Importar información del paquete.
AppAttachPackagePatch	Esquema para las propiedades del paquete de asociación de aplicaciones actualizables.
AppAttachPackagePatchProperties	Esquema de campos parcheables en un paquete de App Attach.
AppAttachPackageProperties	Esquema para las propiedades del paquete de asociación de aplicaciones.
createdByType	Tipo de identidad que creó el recurso.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
failHealthCheckOnStagingFailure	Parámetro que indica cómo debe comportarse la comprobación de estado si se produce un error en el almacenamiento provisional de este paquete
MsixPackageApplications	Esquema para las propiedades de la aplicación de paquete MSIX.
MsixPackageDependencies	Esquema para las propiedades de dependencias de paquetes MSIX.
packageTimestamped	Es la marca de tiempo del paquete para que pueda omitir la fecha de expiración del certificado.
ProvisioningState	Estado de aprovisionamiento actual.
systemData	Metadatos relativos a la creación y última modificación del recurso.

AppAttachPackage

Objeto

Esquema para las propiedades del paquete de asociación de aplicaciones.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties	AppAttachPackageProperties	Propiedades detalladas del paquete de asociación de aplicaciones
systemData	systemData	Azure Resource Manager metadatos que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AppAttachPackageInfoProperties

Objeto

Esquema para las propiedades de Importar información del paquete.

Nombre	Tipo	Description
certificateExpiry	string (date-time)	El certificado de fecha expira, que se encuentra en el appxmanifest.xml.
certificateName	string	Nombre del certificado que se encuentra en el appxmanifest.xml.
displayName	string	Nombre descriptivo que se mostrará en el portal.
imagePath	string	Ruta de acceso de imagen de VHD/CIM en recurso compartido de red.
isActive	boolean	Convierta esta versión del paquete en la activa en el grupo de hosts.
isPackageTimestamped	packageTimestamped	Es la marca de tiempo del paquete para que pueda omitir la fecha de expiración del certificado.
isRegularRegistration	boolean	Especifica cómo registrar el paquete en la fuente.
lastUpdated	string (date-time)	Fecha en que se actualizó por última vez el paquete, que se encuentra en el appxmanifest.xml.
packageAlias	string	Alias del paquete de asociación de aplicaciones. Asignado en el momento de la importación
packageApplications	MsixPackageApplications[]	Lista de aplicaciones de paquete.
packageDependencies	MsixPackageDependencies[]	Lista de dependencias del paquete.
packageFamilyName	string	Nombre de familia de paquete de appxmanifest.xml. Contiene el nombre del paquete y el nombre del publicador.
packageFullName	string	Nombre completo del paquete de appxmanifest.xml.
packageName	string	Nombre del paquete de appxmanifest.xml.
packageRelativePath	string	Ruta de acceso relativa al paquete dentro de la imagen.
version	string	Versión del paquete que se encuentra en el appxmanifest.xml.

AppAttachPackagePatch

Objeto

Esquema para las propiedades del paquete de asociación de aplicaciones actualizables.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nombre del recurso
properties	AppAttachPackagePatchProperties	Propiedades detalladas del paquete de asociación de aplicaciones
systemData	systemData	Azure Resource Manager metadatos que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AppAttachPackagePatchProperties

Objeto

Esquema de campos parcheables en un paquete de App Attach.

Nombre	Tipo	Description
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parámetro que indica cómo debe comportarse la comprobación de estado si se produce un error en el almacenamiento provisional de este paquete
hostPoolReferences	string[] (arm-id)	Lista de identificadores de recursos del grupo de hosts.
image	AppAttachPackageInfoProperties	Propiedades detalladas del paquete de asociación de aplicaciones
keyVaultURL	string	Ruta de acceso url al nombre del certificado ubicado en keyVault

AppAttachPackageProperties

Objeto

Esquema para las propiedades del paquete de asociación de aplicaciones.

Nombre	Tipo	Description
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parámetro que indica cómo debe comportarse la comprobación de estado si se produce un error en el almacenamiento provisional de este paquete
hostPoolReferences	string[]	Lista de identificadores de recursos del grupo de hosts.
image	AppAttachPackageInfoProperties	Propiedades detalladas del paquete de asociación de aplicaciones
keyVaultURL	string	Ruta de acceso url al nombre del certificado ubicado en keyVault
provisioningState	ProvisioningState	El estado de aprovisionamiento del paquete de conexión de aplicaciones.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

failHealthCheckOnStagingFailure

Enumeración

Parámetro que indica cómo debe comportarse la comprobación de estado si se produce un error en el almacenamiento provisional de este paquete

Valor	Description
Unhealthy
NeedsAssistance
DoNotFail

MsixPackageApplications

Objeto

Esquema para las propiedades de la aplicación de paquete MSIX.

Nombre	Tipo	Description
appId	string	Id. de aplicación del paquete, que se encuentra en appxmanifest.xml.
appUserModelID	string	Se usa para activar la aplicación de paquete. Consta de Nombre de paquete y ApplicationID. Se encuentra en appxmanifest.xml.
description	string	Descripción de la aplicación de paquete.
friendlyName	string	Nombre descriptivo del usuario.
iconImageName	string	Nombre descriptivo del usuario.
rawIcon	string (byte)	el icono una cadena de 64 bits como una matriz de bytes.
rawPng	string (byte)	el icono una cadena de 64 bits como una matriz de bytes.

MsixPackageDependencies

Objeto

Esquema para las propiedades de dependencias de paquetes MSIX.

Nombre	Tipo	Description
dependencyName	string	Nombre de la dependencia del paquete.
minVersion	string	Se requiere la versión de dependencia.
publisher	string	Nombre del publicador de dependencias.

packageTimestamped

Enumeración

Es la marca de tiempo del paquete para que pueda omitir la fecha de expiración del certificado.

Valor	Description
Timestamped
NotTimestamped

ProvisioningState

Enumeración

Estado de aprovisionamiento actual.

Valor	Description
Succeeded
Provisioning
Failed
Canceled

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

App Attach Package - Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

AppAttachPackage_Update

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AppAttachPackage

AppAttachPackageInfoProperties

AppAttachPackagePatch

AppAttachPackagePatchProperties

AppAttachPackageProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

failHealthCheckOnStagingFailure

MsixPackageApplications

MsixPackageDependencies

packageTimestamped

ProvisioningState

systemData