App Attach Package - Update

Dienst:: Desktop Virtualization

API-Version:: 2025-10-10

Aktualisieren eines App-Anfügepakets

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]\|(-(?!-))){1,61}[a-z0-9]$	Der Name des App Attach-Pakets
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties	AppAttachPackagePatchProperties	Detaillierte Eigenschaften für das App Attach-Paket

Antworten

Name	Typ	Beschreibung
200 OK	AppAttachPackage	App Attach Package erfolgreich aktualisiert.
Other Status Codes	ErrorResponse	Automatisierungsfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

AppAttachPackage_Update

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
AppAttachPackage	Schema für die Eigenschaften von App Attach Package.
AppAttachPackageInfoProperties	Schema für die Eigenschaften von Importpaketinformationen.
AppAttachPackagePatch	Schema für aktualisierbare Eigenschaften von App Attach Package.
AppAttachPackagePatchProperties	Schema für patchbare Felder in einem App Attach Package.
AppAttachPackageProperties	Schema für die Eigenschaften von App Attach Package.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
failHealthCheckOnStagingFailure	Parameter, der angibt, wie sich die Integritätsprüfung verhalten soll, wenn das Staging dieses Pakets fehlschlägt
MsixPackageApplications	Schema für Eigenschaften der MSIX-Paketanwendung.
MsixPackageDependencies	Schema für MSIX-Paketabhängigkeiten-Eigenschaften.
packageTimestamped	Ist paketzeitstempelt, sodass es das Ablaufdatum des Zertifikats ignorieren kann
ProvisioningState	Der aktuelle Bereitstellungsstatus.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

AppAttachPackage

Objekt

Schema für die Eigenschaften von App Attach Package.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties	AppAttachPackageProperties	Detaillierte Eigenschaften für das App Attach-Paket
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

AppAttachPackageInfoProperties

Objekt

Schema für die Eigenschaften von Importpaketinformationen.

Name	Typ	Beschreibung
certificateExpiry	string (date-time)	Das Datum läuft ab, das im appxmanifest.xmlgefunden wird.
certificateName	string	Im appxmanifest.xmlgefundener Zertifikatname.
displayName	string	Benutzerfreundlicher Name, der im Portal angezeigt werden soll.
imagePath	string	VHD/CIM-Imagepfad auf der Netzwerkfreigabe.
isActive	boolean	Legen Sie diese Version des Pakets für das aktive Paket im Hostpool fest.
isPackageTimestamped	packageTimestamped	Ist paketzeitstempelt, sodass es das Ablaufdatum des Zertifikats ignorieren kann
isRegularRegistration	boolean	Gibt an, wie Paket im Feed registriert wird.
lastUpdated	string (date-time)	Das Datumspaket wurde zuletzt aktualisiert, das im appxmanifest.xmlgefunden wurde.
packageAlias	string	Alias des App Attach-Pakets. Zur Importzeit zugewiesen
packageApplications	MsixPackageApplications[]	Liste der Paketanwendungen.
packageDependencies	MsixPackageDependencies[]	Liste der Paketabhängigkeiten.
packageFamilyName	string	Paketfamilienname aus appxmanifest.xml. Enthält den Paketnamen und den Herausgebernamen.
packageFullName	string	Vollständiger Paketname aus appxmanifest.xml.
packageName	string	Paketname aus appxmanifest.xml.
packageRelativePath	string	Relativer Pfad zum Paket innerhalb des Bilds.
version	string	Paketversion im appxmanifest.xmlgefunden.

AppAttachPackagePatch

Objekt

Schema für aktualisierbare Eigenschaften von App Attach Package.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties	AppAttachPackagePatchProperties	Detaillierte Eigenschaften für das App Attach-Paket
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

AppAttachPackagePatchProperties

Objekt

Schema für patchbare Felder in einem App Attach Package.

Name	Typ	Beschreibung
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parameter, der angibt, wie sich die Integritätsprüfung verhalten soll, wenn das Staging dieses Pakets fehlschlägt
hostPoolReferences	string[] (arm-id)	Liste der Hostpool-Ressourcen-IDs.
image	AppAttachPackageInfoProperties	Detaillierte Eigenschaften für das App Attach-Paket
keyVaultURL	string	URL-Pfad zum Zertifikatnamen, der sich in keyVault befindet

AppAttachPackageProperties

Objekt

Schema für die Eigenschaften von App Attach Package.

Name	Typ	Beschreibung
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parameter, der angibt, wie sich die Integritätsprüfung verhalten soll, wenn das Staging dieses Pakets fehlschlägt
hostPoolReferences	string[]	Liste der Hostpool-Ressourcen-IDs.
image	AppAttachPackageInfoProperties	Detaillierte Eigenschaften für das App Attach-Paket
keyVaultURL	string	URL-Pfad zum Zertifikatnamen, der sich in keyVault befindet
provisioningState	ProvisioningState	Der Bereitstellungsstatus des App-Anfügepakets.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

failHealthCheckOnStagingFailure

Enumeration

Parameter, der angibt, wie sich die Integritätsprüfung verhalten soll, wenn das Staging dieses Pakets fehlschlägt

Wert	Beschreibung
Unhealthy
NeedsAssistance
DoNotFail

MsixPackageApplications

Objekt

Schema für Eigenschaften der MSIX-Paketanwendung.

Name	Typ	Beschreibung
appId	string	Paketanwendungs-ID, in appxmanifest.xmlgefunden.
appUserModelID	string	Wird zum Aktivieren der Paketanwendung verwendet. Besteht aus Paketname und ApplicationID. In appxmanifest.xmlgefunden.
description	string	Beschreibung der Paketanwendung.
friendlyName	string	Benutzerfreundlicher Name.
iconImageName	string	Benutzerfreundlicher Name.
rawIcon	string (byte)	das Symbol eine 64-Bit-Zeichenfolge als Bytearray.
rawPng	string (byte)	das Symbol eine 64-Bit-Zeichenfolge als Bytearray.

MsixPackageDependencies

Objekt

Schema für MSIX-Paketabhängigkeiten-Eigenschaften.

Name	Typ	Beschreibung
dependencyName	string	Name der Paketabhängigkeit.
minVersion	string	Abhängigkeitsversion erforderlich.
publisher	string	Name des Abhängigkeitsherausgebers.

packageTimestamped

Enumeration

Ist paketzeitstempelt, sodass es das Ablaufdatum des Zertifikats ignorieren kann

Wert	Beschreibung
Timestamped
NotTimestamped

ProvisioningState

Enumeration

Der aktuelle Bereitstellungsstatus.

Wert	Beschreibung
Succeeded
Provisioning
Failed
Canceled

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über

App Attach Package - Update

URI-Parameter

Anforderungstext

Antworten

Beispiele

AppAttachPackage_Update

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AppAttachPackage

AppAttachPackageInfoProperties

AppAttachPackagePatch

AppAttachPackagePatchProperties

AppAttachPackageProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

failHealthCheckOnStagingFailure

MsixPackageApplications

MsixPackageDependencies

packageTimestamped

ProvisioningState

systemData