MSIX Packages - Create Or Update

Servicio:: Desktop Virtualization

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

Crear o actualizar un paquete MSIX.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	El nombre del grupo de hosts dentro del grupo de recursos especificado
msixPackageFullName	path	True	string minLength: 3 maxLength: 100 pattern: ^[A-Za-z0-9@.\-_ ]*$	Nombre completo del paquete específico de la versión del paquete MSIX dentro del grupo de hosts especificado
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.displayName	string	Nombre descriptivo que se mostrará en el portal.
properties.imagePath	string	Ruta de acceso de imagen de VHD/CIM en recurso compartido de red.
properties.isActive	boolean	Convierta esta versión del paquete en la activa en el grupo de hosts.
properties.isRegularRegistration	boolean	Especifica cómo registrar el paquete en la fuente.
properties.lastUpdated	string (date-time)	Fecha en que se actualizó por última vez el paquete, que se encuentra en el appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Lista de aplicaciones de paquete.
properties.packageDependencies	MsixPackageDependencies[]	Lista de dependencias del paquete.
properties.packageFamilyName	string	Nombre de familia de paquete de appxmanifest.xml. Contiene el nombre del paquete y el nombre del publicador.
properties.packageName	string	Nombre del paquete de appxmanifest.xml.
properties.packageRelativePath	string	Ruta de acceso relativa al paquete dentro de la imagen.
properties.version	string	Versión del paquete que se encuentra en el appxmanifest.xml.

Respuestas

Nombre	Tipo	Description
200 OK	MSIXPackage	Actualizado con éxito el paquete MSIX.
201 Created	MSIXPackage	He creado con éxito el paquete MSIX.
Other Status Codes	CloudError	Respuesta de error de automatización que describe por qué falló la operación.

Ejemplos

MSIXPackage_Create

Solicitud de ejemplo

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

Respuesta de muestra

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

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

Definiciones

Nombre	Description
CloudError	Objeto de error en la nube.
CloudErrorProperties	Propiedades del objeto de error en la nube.
createdByType	Tipo de identidad que creó el recurso.
MSIXPackage	Esquema para las propiedades del paquete MSIX.
MsixPackageApplications	Esquema para las propiedades de la aplicación de paquete MSIX.
MsixPackageDependencies	Esquema para las propiedades de dependencias de paquetes MSIX.
systemData	Metadatos relativos a la creación y última modificación del recurso.

CloudError

Objeto

Objeto de error en la nube.

Nombre	Tipo	Description
error	CloudErrorProperties	Propiedades del objeto de error en la nube.

CloudErrorProperties

Objeto

Propiedades del objeto de error en la nube.

Nombre	Tipo	Description
code	string	Código de error
message	string	Mensaje de error que indica por qué se produjo un error en la operación.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

MSIXPackage

Objeto

Esquema para las propiedades del paquete MSIX.

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.displayName	string	Nombre descriptivo que se mostrará en el portal.
properties.imagePath	string	Ruta de acceso de imagen de VHD/CIM en recurso compartido de red.
properties.isActive	boolean	Convierta esta versión del paquete en la activa en el grupo de hosts.
properties.isRegularRegistration	boolean	Especifica cómo registrar el paquete en la fuente.
properties.lastUpdated	string (date-time)	Fecha en que se actualizó por última vez el paquete, que se encuentra en el appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Lista de aplicaciones de paquete.
properties.packageDependencies	MsixPackageDependencies[]	Lista de dependencias del paquete.
properties.packageFamilyName	string	Nombre de familia de paquete de appxmanifest.xml. Contiene el nombre del paquete y el nombre del publicador.
properties.packageName	string	Nombre del paquete de appxmanifest.xml.
properties.packageRelativePath	string	Ruta de acceso relativa al paquete dentro de la imagen.
properties.version	string	Versión del paquete que se encuentra en el appxmanifest.xml.
systemData	systemData	Metadatos relativos a la creación y última modificación del recurso.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

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.

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

MSIX Packages - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

MSIXPackage_Create

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CloudError

CloudErrorProperties

createdByType

MSIXPackage

MsixPackageApplications

MsixPackageDependencies

systemData