App Attach Package - Create Or Update

Servizio:: Desktop Virtualization

Versione API:: 2025-10-10

Creare o aggiornare un pacchetto di collegamento app.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]\|(-(?!-))){1,61}[a-z0-9]$	Il nome del pacchetto App Attach
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	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
properties	True	AppAttachPackageProperties	Proprietà dettagliate per il pacchetto Di collegamento app
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	AppAttachPackage	Aggiornamento con successo del pacchetto App Attach.
201 Created	AppAttachPackage	Compilato con successo il pacchetto App Alleg.
Other Status Codes	ErrorResponse	Risposta di errore

Esempio

AppAttachPackage_Create

Esempio di richiesta

HTTP

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

{
  "location": "southcentralus",
  "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": ""
  }
}

Risposta di esempio

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

Codice di stato:: 201

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

Definizioni

Nome	Descrizione
AppAttachPackage	Schema per le proprietà del pacchetto di collegamento app.
AppAttachPackageInfoProperties	Schema per le proprietà Importa informazioni pacchetto.
AppAttachPackageProperties	Schema per le proprietà del pacchetto di collegamento app.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
failHealthCheckOnStagingFailure	Parametro che indica il comportamento del controllo integrità se il pacchetto ha esito negativo
MsixPackageApplications	Schema per le proprietà dell'applicazione pacchetto MSIX.
MsixPackageDependencies	Schema per le proprietà delle dipendenze del pacchetto MSIX.
packageTimestamped	Timestamp del pacchetto in modo che possa ignorare la data di scadenza del certificato
ProvisioningState	Stato di provisioning corrente.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

AppAttachPackage

Oggetto

Schema per le proprietà del pacchetto di collegamento app.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties	AppAttachPackageProperties	Proprietà dettagliate per il pacchetto Di collegamento app
systemData	systemData	Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AppAttachPackageInfoProperties

Oggetto

Schema per le proprietà Importa informazioni pacchetto.

Nome	Tipo	Descrizione
certificateExpiry	string (date-time)	Data di scadenza del certificato, disponibile nel appxmanifest.xml.
certificateName	string	Nome certificato trovato nel appxmanifest.xml.
displayName	string	Nome descrittivo da visualizzare nel portale.
imagePath	string	Percorso dell'immagine VHD/CIM nella condivisione di rete.
isActive	boolean	Rendere questa versione del pacchetto attiva nell'hostpool.
isPackageTimestamped	packageTimestamped	Timestamp del pacchetto in modo che possa ignorare la data di scadenza del certificato
isRegularRegistration	boolean	Specifica come registrare il pacchetto nel feed.
lastUpdated	string (date-time)	Data dell'ultimo aggiornamento del pacchetto, disponibile nel appxmanifest.xml.
packageAlias	string	Alias del pacchetto App Attach. Assegnato in fase di importazione
packageApplications	MsixPackageApplications[]	Elenco delle applicazioni del pacchetto.
packageDependencies	MsixPackageDependencies[]	Elenco delle dipendenze dei pacchetti.
packageFamilyName	string	Nome della famiglia di pacchetti da appxmanifest.xml. Contiene il nome del pacchetto e il nome del server di pubblicazione.
packageFullName	string	Nome completo del pacchetto da appxmanifest.xml.
packageName	string	Nome del pacchetto da appxmanifest.xml.
packageRelativePath	string	Percorso relativo del pacchetto all'interno dell'immagine.
version	string	Versione del pacchetto trovata nella appxmanifest.xml.

AppAttachPackageProperties

Oggetto

Schema per le proprietà del pacchetto di collegamento app.

Nome	Tipo	Descrizione
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parametro che indica il comportamento del controllo integrità se il pacchetto ha esito negativo
hostPoolReferences	string[]	Elenco di ID risorsa hostpool.
image	AppAttachPackageInfoProperties	Proprietà dettagliate per il pacchetto Di collegamento app
keyVaultURL	string	Percorso URL del nome del certificato che si trova in keyVault
provisioningState	ProvisioningState	Stato di provisioning del pacchetto di collegamento app.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

failHealthCheckOnStagingFailure

Enumerazione

Parametro che indica il comportamento del controllo integrità se il pacchetto ha esito negativo

Valore	Descrizione
Unhealthy
NeedsAssistance
DoNotFail

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.

packageTimestamped

Enumerazione

Timestamp del pacchetto in modo che possa ignorare la data di scadenza del certificato

Valore	Descrizione
Timestamped
NotTimestamped

ProvisioningState

Enumerazione

Stato di provisioning corrente.

Valore	Descrizione
Succeeded
Provisioning
Failed
Canceled

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.