MSIX Packages - Create Or Update

Servizio:: Desktop Virtualization

Versione API:: 2025-10-10

Creare o aggiornare un pacchetto MSIX.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	Nome del pool di host all'interno del gruppo di risorse specificato
msixPackageFullName	path	True	string minLength: 3 maxLength: 100 pattern: ^[A-Za-z0-9@.\-_ ]*$	Nome completo del pacchetto specifico della versione del pacchetto MSIX all'interno del pool di host specificato
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
properties.displayName	string	Nome descrittivo da visualizzare nel portale.
properties.imagePath	string	Percorso dell'immagine VHD/CIM nella condivisione di rete.
properties.isActive	boolean	Rendere questa versione del pacchetto attiva nell'hostpool.
properties.isRegularRegistration	boolean	Specifica come registrare il pacchetto nel feed.
properties.lastUpdated	string (date-time)	Data dell'ultimo aggiornamento del pacchetto, disponibile nel appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Elenco delle applicazioni del pacchetto.
properties.packageDependencies	MsixPackageDependencies[]	Elenco delle dipendenze dei pacchetti.
properties.packageFamilyName	string	Nome della famiglia di pacchetti da appxmanifest.xml. Contiene il nome del pacchetto e il nome del server di pubblicazione.
properties.packageName	string	Nome del pacchetto da appxmanifest.xml.
properties.packageRelativePath	string	Percorso relativo del pacchetto all'interno dell'immagine.
properties.version	string	Versione del pacchetto trovata nella appxmanifest.xml.

Risposte

Nome	Tipo	Descrizione
200 OK	MSIXPackage	Aggiornamento con successo del pacchetto MSIX.
201 Created	MSIXPackage	Ho creato con successo il pacchetto MSIX.
Other Status Codes	CloudError	Risposta di errore di automazione che descrive il motivo per cui l'operazione non è riuscita.

Esempio

MSIXPackage_Create

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
      }
    ]
  }
}

Codice di stato:: 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"
      }
    ]
  }
}

Definizioni

Nome	Descrizione
CloudError	Oggetto di errore cloud.
CloudErrorProperties	Proprietà dell'oggetto di errore nella nube.
createdByType	Tipo di identità che ha creato la risorsa.
MSIXPackage	Schema per le proprietà del pacchetto MSIX.
MsixPackageApplications	Schema per le proprietà dell'applicazione pacchetto MSIX.
MsixPackageDependencies	Schema per le proprietà delle dipendenze del pacchetto MSIX.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

CloudError

Oggetto

Oggetto di errore cloud.

Nome	Tipo	Descrizione
error	CloudErrorProperties	Proprietà dell'oggetto di errore nella nube.

CloudErrorProperties

Oggetto

Proprietà dell'oggetto di errore nella nube.

Nome	Tipo	Descrizione
code	string	Codice di errore
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

MSIXPackage

Oggetto

Schema per le proprietà del pacchetto MSIX.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties.displayName	string	Nome descrittivo da visualizzare nel portale.
properties.imagePath	string	Percorso dell'immagine VHD/CIM nella condivisione di rete.
properties.isActive	boolean	Rendere questa versione del pacchetto attiva nell'hostpool.
properties.isRegularRegistration	boolean	Specifica come registrare il pacchetto nel feed.
properties.lastUpdated	string (date-time)	Data dell'ultimo aggiornamento del pacchetto, disponibile nel appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Elenco delle applicazioni del pacchetto.
properties.packageDependencies	MsixPackageDependencies[]	Elenco delle dipendenze dei pacchetti.
properties.packageFamilyName	string	Nome della famiglia di pacchetti da appxmanifest.xml. Contiene il nome del pacchetto e il nome del server di pubblicazione.
properties.packageName	string	Nome del pacchetto da appxmanifest.xml.
properties.packageRelativePath	string	Percorso relativo del pacchetto all'interno dell'immagine.
properties.version	string	Versione del pacchetto trovata nella appxmanifest.xml.
systemData	systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

MsixPackageApplications

Oggetto

Schema per le proprietà dell'applicazione pacchetto MSIX.

Nome	Tipo	Descrizione
appId	string	ID applicazione pacchetto, disponibile in appxmanifest.xml.
appUserModelID	string	Utilizzato per attivare l'applicazione pacchetto. È costituito dal nome del pacchetto e dall'ID applicazione. Trovato in appxmanifest.xml.
description	string	Descrizione dell'applicazione pacchetto.
friendlyName	string	Nome descrittivo dell'utente.
iconImageName	string	Nome descrittivo dell'utente.
rawIcon	string (byte)	l'icona una stringa a 64 bit come matrice di byte.
rawPng	string (byte)	l'icona una stringa a 64 bit come matrice di byte.

MsixPackageDependencies

Oggetto

Schema per le proprietà delle dipendenze del pacchetto MSIX.

Nome	Tipo	Descrizione
dependencyName	string	Nome della dipendenza del pacchetto.
minVersion	string	Versione delle dipendenze obbligatoria.
publisher	string	Nome dell'autore delle dipendenze.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Condividi tramite

MSIX Packages - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

MSIXPackage_Create

Esempio di richiesta

Risposta di esempio

Definizioni

CloudError

CloudErrorProperties

createdByType

MSIXPackage

MsixPackageApplications

MsixPackageDependencies

systemData