App Attach Package - Update

Service:: Desktop Virtualization

Version d'API:: 2025-10-10

Mettre à jour un package d’attachement d’application

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]\|(-(?!-))){1,61}[a-z0-9]$	Nom du package d’attachement d’application
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
properties	AppAttachPackagePatchProperties	Propriétés détaillées pour le package App Attach

Réponses

Nom	Type	Description
200 OK	AppAttachPackage	Mise à jour réussie du package App Attach.
Other Status Codes	ErrorResponse	Réponse d’erreur d’automatisation décrivant la raison de l’échec de l’opération.

Exemples

AppAttachPackage_Update

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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": ""
  }
}

Définitions

Nom	Description
AppAttachPackage	Schéma pour les propriétés du package d’attachement d’application.
AppAttachPackageInfoProperties	Schéma pour les propriétés d’importation des informations de package.
AppAttachPackagePatch	Schéma pour les propriétés du package d’attachement d’application pouvant être mises à jour.
AppAttachPackagePatchProperties	Schéma pour les champs pouvant être corrigés sur un package d’attachement d’application.
AppAttachPackageProperties	Schéma pour les propriétés du package d’attachement d’application.
createdByType	Type d’identité qui a créé la ressource.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
failHealthCheckOnStagingFailure	Paramètre indiquant comment la vérification d’intégrité doit se comporter si ce package échoue en préproduction
MsixPackageApplications	Schéma pour les propriétés de l’application de package MSIX.
MsixPackageDependencies	Schéma pour les propriétés des dépendances de package MSIX.
packageTimestamped	Est horodaté du package afin qu’il puisse ignorer la date d’expiration du certificat
ProvisioningState	État d’approvisionnement actuel.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

AppAttachPackage

Objet

Schéma pour les propriétés du package d’attachement d’application.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties	AppAttachPackageProperties	Propriétés détaillées pour le package App Attach
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

AppAttachPackageInfoProperties

Objet

Schéma pour les propriétés d’importation des informations de package.

Nom	Type	Description
certificateExpiry	string (date-time)	Date d’expiration du certificat, trouvé dans le appxmanifest.xml.
certificateName	string	Nom du certificat trouvé dans le appxmanifest.xml.
displayName	string	Nom convivial à afficher dans le portail.
imagePath	string	Chemin d’accès de l’image VHD/CIM sur le partage réseau.
isActive	boolean	Faites de cette version du package l’actif dans le pool d’hôtes.
isPackageTimestamped	packageTimestamped	Est horodaté du package afin qu’il puisse ignorer la date d’expiration du certificat
isRegularRegistration	boolean	Spécifie comment inscrire le package dans le flux.
lastUpdated	string (date-time)	Date de la dernière mise à jour du package trouvé dans le appxmanifest.xml.
packageAlias	string	Alias du package App Attach. Affecté au moment de l’importation
packageApplications	MsixPackageApplications[]	Liste des applications de package.
packageDependencies	MsixPackageDependencies[]	Liste des dépendances de package.
packageFamilyName	string	Nom de la famille de packages de appxmanifest.xml. Contient le nom du package et le nom du serveur de publication.
packageFullName	string	Nom complet du package à partir de appxmanifest.xml.
packageName	string	Nom du package de appxmanifest.xml.
packageRelativePath	string	Chemin relatif du package à l’intérieur de l’image.
version	string	Version du package trouvée dans le appxmanifest.xml.

AppAttachPackagePatch

Objet

Schéma pour les propriétés du package d’attachement d’application pouvant être mises à jour.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	Nom de la ressource
properties	AppAttachPackagePatchProperties	Propriétés détaillées pour le package App Attach
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

AppAttachPackagePatchProperties

Objet

Schéma pour les champs pouvant être corrigés sur un package d’attachement d’application.

Nom	Type	Description
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Paramètre indiquant comment la vérification d’intégrité doit se comporter si ce package échoue en préproduction
hostPoolReferences	string[] (arm-id)	Liste des ID de ressource Hostpool.
image	AppAttachPackageInfoProperties	Propriétés détaillées pour le package App Attach
keyVaultURL	string	Chemin d’URL du nom du certificat situé dans KeyVault

AppAttachPackageProperties

Objet

Schéma pour les propriétés du package d’attachement d’application.

Nom	Type	Description
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Paramètre indiquant comment la vérification d’intégrité doit se comporter si ce package échoue en préproduction
hostPoolReferences	string[]	Liste des ID de ressource Hostpool.
image	AppAttachPackageInfoProperties	Propriétés détaillées pour le package App Attach
keyVaultURL	string	Chemin d’URL du nom du certificat situé dans KeyVault
provisioningState	ProvisioningState	L’état de provisionnement du package d’attachement d’application.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

failHealthCheckOnStagingFailure

Énumération

Paramètre indiquant comment la vérification d’intégrité doit se comporter si ce package échoue en préproduction

Valeur	Description
Unhealthy
NeedsAssistance
DoNotFail

MsixPackageApplications

Objet

Schéma pour les propriétés de l’application de package MSIX.

Nom	Type	Description
appId	string	ID d’application de package, trouvé dans appxmanifest.xml.
appUserModelID	string	Permet d’activer l’application de package. Se compose du nom du package et de l’ID d’application. Trouvé dans appxmanifest.xml.
description	string	Description de l’application de package.
friendlyName	string	Nom convivial.
iconImageName	string	Nom convivial.
rawIcon	string (byte)	l’icône d’une chaîne 64 bits sous forme de tableau d’octets.
rawPng	string (byte)	l’icône d’une chaîne 64 bits sous forme de tableau d’octets.

MsixPackageDependencies

Objet

Schéma pour les propriétés des dépendances de package MSIX.

Nom	Type	Description
dependencyName	string	Nom de la dépendance de package.
minVersion	string	Version de dépendance requise.
publisher	string	Nom de l’éditeur de dépendances.

packageTimestamped

Énumération

Est horodaté du package afin qu’il puisse ignorer la date d’expiration du certificat

Valeur	Description
Timestamped
NotTimestamped

ProvisioningState

Énumération

État d’approvisionnement actuel.

Valeur	Description
Succeeded
Provisioning
Failed
Canceled

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

Partager via

App Attach Package - Update

Paramètres URI

Corps de la demande

Réponses

Exemples

AppAttachPackage_Update

Exemple de requête

Exemple de réponse

Définitions

AppAttachPackage

AppAttachPackageInfoProperties

AppAttachPackagePatch

AppAttachPackagePatchProperties

AppAttachPackageProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

failHealthCheckOnStagingFailure

MsixPackageApplications

MsixPackageDependencies

packageTimestamped

ProvisioningState

systemData