MSIX Packages - Create Or Update

Service:: Desktop Virtualization

Version d'API:: 2025-10-10

Créez ou mettez à jour un package MSIX.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	Nom du pool d’hôtes dans le groupe de ressources spécifié
msixPackageFullName	path	True	string minLength: 3 maxLength: 100 pattern: ^[A-Za-z0-9@.\-_ ]*$	Nom complet du package MSIX spécifique à la version dans le pool d’hôtes spécifié
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.displayName	string	Nom convivial à afficher dans le portail.
properties.imagePath	string	Chemin d’accès de l’image VHD/CIM sur le partage réseau.
properties.isActive	boolean	Faites de cette version du package l’actif dans le pool d’hôtes.
properties.isRegularRegistration	boolean	Spécifie comment inscrire le package dans le flux.
properties.lastUpdated	string (date-time)	Date de la dernière mise à jour du package trouvé dans le appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Liste des applications de package.
properties.packageDependencies	MsixPackageDependencies[]	Liste des dépendances de package.
properties.packageFamilyName	string	Nom de la famille de packages de appxmanifest.xml. Contient le nom du package et le nom du serveur de publication.
properties.packageName	string	Nom du package de appxmanifest.xml.
properties.packageRelativePath	string	Chemin relatif du package à l’intérieur de l’image.
properties.version	string	Version du package trouvée dans le appxmanifest.xml.

Réponses

Nom	Type	Description
200 OK	MSIXPackage	Mise à jour réussie du package MSIX.
201 Created	MSIXPackage	Création réussie du package MSIX.
Other Status Codes	CloudError	Réponse d’erreur d’automatisation décrivant la raison de l’échec de l’opération.

Exemples

MSIXPackage_Create

Exemple de requête

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"
  }
}

Exemple de réponse

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

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

Définitions

Nom	Description
CloudError	Objet d’erreur cloud.
CloudErrorProperties	Propriétés de l’objet d’erreur cloud.
createdByType	Type d’identité qui a créé la ressource.
MSIXPackage	Schéma pour les propriétés du package MSIX.
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.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

CloudError

Objet

Objet d’erreur cloud.

Nom	Type	Description
error	CloudErrorProperties	Propriétés de l’objet d’erreur cloud.

CloudErrorProperties

Objet

Propriétés de l’objet d’erreur cloud.

Nom	Type	Description
code	string	Code d’erreur
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.

createdByType

Énumération

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

Valeur	Description
User
Application
ManagedIdentity
Key

MSIXPackage

Objet

Schéma pour les propriétés du package MSIX.

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.displayName	string	Nom convivial à afficher dans le portail.
properties.imagePath	string	Chemin d’accès de l’image VHD/CIM sur le partage réseau.
properties.isActive	boolean	Faites de cette version du package l’actif dans le pool d’hôtes.
properties.isRegularRegistration	boolean	Spécifie comment inscrire le package dans le flux.
properties.lastUpdated	string (date-time)	Date de la dernière mise à jour du package trouvé dans le appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Liste des applications de package.
properties.packageDependencies	MsixPackageDependencies[]	Liste des dépendances de package.
properties.packageFamilyName	string	Nom de la famille de packages de appxmanifest.xml. Contient le nom du package et le nom du serveur de publication.
properties.packageName	string	Nom du package de appxmanifest.xml.
properties.packageRelativePath	string	Chemin relatif du package à l’intérieur de l’image.
properties.version	string	Version du package trouvée dans le appxmanifest.xml.
systemData	systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

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.

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

MSIX Packages - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Exemples

MSIXPackage_Create

Exemple de requête

Exemple de réponse

Définitions

CloudError

CloudErrorProperties

createdByType

MSIXPackage

MsixPackageApplications

MsixPackageDependencies

systemData