App Attach Package - Update

Layanan:: Desktop Virtualization

Versi API:: 2025-10-10

Perbarui Paket Lampirkan Aplikasi

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]\|(-(?!-))){1,61}[a-z0-9]$	Nama paket App Attach
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
properties	AppAttachPackagePatchProperties	Properti terperinci untuk Paket Lampiran Aplikasi

Respons

Nama	Jenis	Deskripsi
200 OK	AppAttachPackage	Paket Lampirkan Aplikasi berhasil diperbarui.
Other Status Codes	ErrorResponse	Respons kesalahan otomatisasi yang menjelaskan mengapa operasi gagal.

Contoh

AppAttachPackage_Update

Permintaan sampel

HTTP

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

Respon sampel

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

Definisi

Nama	Deskripsi
AppAttachPackage	Skema untuk properti Paket Lampirkan Aplikasi.
AppAttachPackageInfoProperties	Skema untuk properti Informasi Paket Impor.
AppAttachPackagePatch	Skema untuk properti Paket Lampirkan Aplikasi yang dapat diperbarui.
AppAttachPackagePatchProperties	Skema untuk bidang yang dapat ditambal pada Paket Lampirkan Aplikasi.
AppAttachPackageProperties	Skema untuk properti Paket Lampirkan Aplikasi.
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
failHealthCheckOnStagingFailure	Parameter yang menunjukkan bagaimana pemeriksaan kesehatan harus berperilaku jika paket ini gagal penahapan
MsixPackageApplications	Skema untuk properti Aplikasi Paket MSIX.
MsixPackageDependencies	Skema untuk properti Dependensi Paket MSIX.
packageTimestamped	Apakah paket diberi tanda waktu sehingga dapat mengabaikan tanggal kedaluwarsa sertifikat
ProvisioningState	Status provisi saat ini.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

AppAttachPackage

Objek

Skema untuk properti Paket Lampirkan Aplikasi.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Lokasi geografis tempat sumber daya berada
name	string	Nama sumber daya
properties	AppAttachPackageProperties	Properti terperinci untuk Paket Lampiran Aplikasi
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

AppAttachPackageInfoProperties

Objek

Skema untuk properti Informasi Paket Impor.

Nama	Jenis	Deskripsi
certificateExpiry	string (date-time)	Sertifikat tanggal kedaluwarsa, ditemukan di appxmanifest.xml.
certificateName	string	Nama sertifikat ditemukan di appxmanifest.xml.
displayName	string	Nama ramah pengguna yang akan ditampilkan di portal.
imagePath	string	Jalur gambar VHD/CIM di Berbagi Jaringan.
isActive	boolean	Jadikan versi paket ini sebagai paket aktif di seluruh hostpool.
isPackageTimestamped	packageTimestamped	Apakah paket diberi tanda waktu sehingga dapat mengabaikan tanggal kedaluwarsa sertifikat
isRegularRegistration	boolean	Menentukan cara mendaftarkan Paket dalam umpan.
lastUpdated	string (date-time)	Paket Tanggal terakhir diperbarui, ditemukan di appxmanifest.xml.
packageAlias	string	Alias Paket Lampiran Aplikasi. Ditetapkan pada waktu impor
packageApplications	MsixPackageApplications[]	Daftar aplikasi paket.
packageDependencies	MsixPackageDependencies[]	Daftar dependensi paket.
packageFamilyName	string	Nama Keluarga Paket dari appxmanifest.xml. Berisi Nama Paket dan Nama Penerbit.
packageFullName	string	Nama Lengkap Paket dari appxmanifest.xml.
packageName	string	Nama Paket dari appxmanifest.xml.
packageRelativePath	string	Jalur Relatif ke paket di dalam gambar.
version	string	Versi paket ditemukan di appxmanifest.xml.

AppAttachPackagePatch

Objek

Skema untuk properti Paket Lampirkan Aplikasi yang dapat diperbarui.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties	AppAttachPackagePatchProperties	Properti terperinci untuk Paket Lampiran Aplikasi
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

AppAttachPackagePatchProperties

Objek

Skema untuk bidang yang dapat ditambal pada Paket Lampirkan Aplikasi.

Nama	Jenis	Deskripsi
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parameter yang menunjukkan bagaimana pemeriksaan kesehatan harus berperilaku jika paket ini gagal penahapan
hostPoolReferences	string[] (arm-id)	Daftar Id sumber daya Hostpool.
image	AppAttachPackageInfoProperties	Properti terperinci untuk Paket Lampiran Aplikasi
keyVaultURL	string	Jalur URL ke nama sertifikat yang terletak di keyVault

AppAttachPackageProperties

Objek

Skema untuk properti Paket Lampirkan Aplikasi.

Nama	Jenis	Deskripsi
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parameter yang menunjukkan bagaimana pemeriksaan kesehatan harus berperilaku jika paket ini gagal penahapan
hostPoolReferences	string[]	Daftar Id sumber daya Hostpool.
image	AppAttachPackageInfoProperties	Properti terperinci untuk Paket Lampiran Aplikasi
keyVaultURL	string	Jalur URL ke nama sertifikat yang terletak di keyVault
provisioningState	ProvisioningState	Status provisi Paket Lampirkan Aplikasi.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

failHealthCheckOnStagingFailure

Enumerasi

Parameter yang menunjukkan bagaimana pemeriksaan kesehatan harus berperilaku jika paket ini gagal penahapan

Nilai	Deskripsi
Unhealthy
NeedsAssistance
DoNotFail

MsixPackageApplications

Objek

Skema untuk properti Aplikasi Paket MSIX.

Nama	Jenis	Deskripsi
appId	string	Id Aplikasi Paket, ditemukan di appxmanifest.xml.
appUserModelID	string	Digunakan untuk mengaktifkan Aplikasi Paket. Terdiri dari Nama Paket dan ApplicationID. Ditemukan di appxmanifest.xml.
description	string	Deskripsi Aplikasi Paket.
friendlyName	string	Nama yang mudah diingat.
iconImageName	string	Nama yang mudah diingat.
rawIcon	string (byte)	ikon string 64 bit sebagai array byte.
rawPng	string (byte)	ikon string 64 bit sebagai array byte.

MsixPackageDependencies

Objek

Skema untuk properti Dependensi Paket MSIX.

Nama	Jenis	Deskripsi
dependencyName	string	Nama dependensi paket.
minVersion	string	Versi dependensi diperlukan.
publisher	string	Nama penerbit dependensi.

packageTimestamped

Enumerasi

Apakah paket diberi tanda waktu sehingga dapat mengabaikan tanggal kedaluwarsa sertifikat

Nilai	Deskripsi
Timestamped
NotTimestamped

ProvisioningState

Enumerasi

Status provisi saat ini.

Nilai	Deskripsi
Succeeded
Provisioning
Failed
Canceled

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

Bagikan melalui

App Attach Package - Update

Parameter URI

Isi Permintaan

Respons

Contoh

AppAttachPackage_Update

Permintaan sampel

Respon sampel

Definisi

AppAttachPackage

AppAttachPackageInfoProperties

AppAttachPackagePatch

AppAttachPackagePatchProperties

AppAttachPackageProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

failHealthCheckOnStagingFailure

MsixPackageApplications

MsixPackageDependencies

packageTimestamped

ProvisioningState

systemData