MSIX Packages - Create Or Update

Layanan:: Desktop Virtualization

Versi API:: 2025-10-10

Buat atau perbarui paket MSEN.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	Nama kumpulan host dalam grup sumber daya yang ditentukan
msixPackageFullName	path	True	string minLength: 3 maxLength: 100 pattern: ^[A-Za-z0-9@.\-_ ]*$	Nama lengkap paket spesifik versi paket MSIX dalam hostpool yang ditentukan
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.displayName	string	Nama ramah pengguna yang akan ditampilkan di portal.
properties.imagePath	string	Jalur gambar VHD/CIM di Berbagi Jaringan.
properties.isActive	boolean	Jadikan versi paket ini sebagai paket aktif di seluruh hostpool.
properties.isRegularRegistration	boolean	Menentukan cara mendaftarkan Paket dalam umpan.
properties.lastUpdated	string (date-time)	Paket Tanggal terakhir diperbarui, ditemukan di appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Daftar aplikasi paket.
properties.packageDependencies	MsixPackageDependencies[]	Daftar dependensi paket.
properties.packageFamilyName	string	Nama Keluarga Paket dari appxmanifest.xml. Berisi Nama Paket dan Nama Penerbit.
properties.packageName	string	Nama Paket dari appxmanifest.xml.
properties.packageRelativePath	string	Jalur Relatif ke paket di dalam gambar.
properties.version	string	Versi paket ditemukan di appxmanifest.xml.

Respons

Nama	Jenis	Deskripsi
200 OK	MSIXPackage	Berhasil memperbarui Paket MSIX.
201 Created	MSIXPackage	Berhasil membuat Paket MSIX.
Other Status Codes	CloudError	Respons kesalahan otomatisasi yang menjelaskan mengapa operasi gagal.

Contoh

MSIXPackage_Create

Permintaan sampel

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

Respon sampel

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

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

Definisi

Nama	Deskripsi
CloudError	Objek kesalahan cloud.
CloudErrorProperties	Properti objek kesalahan cloud.
createdByType	Jenis identitas yang membuat sumber daya.
MSIXPackage	Skema untuk properti Paket MSIX.
MsixPackageApplications	Skema untuk properti Aplikasi Paket MSIX.
MsixPackageDependencies	Skema untuk properti Dependensi Paket MSIX.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

CloudError

Objek

Objek kesalahan cloud.

Nama	Jenis	Deskripsi
error	CloudErrorProperties	Properti objek kesalahan cloud.

CloudErrorProperties

Objek

Properti objek kesalahan cloud.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan
message	string	Pesan kesalahan yang menunjukkan mengapa operasi gagal.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

MSIXPackage

Objek

Skema untuk properti Paket MSIX.

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.displayName	string	Nama ramah pengguna yang akan ditampilkan di portal.
properties.imagePath	string	Jalur gambar VHD/CIM di Berbagi Jaringan.
properties.isActive	boolean	Jadikan versi paket ini sebagai paket aktif di seluruh hostpool.
properties.isRegularRegistration	boolean	Menentukan cara mendaftarkan Paket dalam umpan.
properties.lastUpdated	string (date-time)	Paket Tanggal terakhir diperbarui, ditemukan di appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Daftar aplikasi paket.
properties.packageDependencies	MsixPackageDependencies[]	Daftar dependensi paket.
properties.packageFamilyName	string	Nama Keluarga Paket dari appxmanifest.xml. Berisi Nama Paket dan Nama Penerbit.
properties.packageName	string	Nama Paket dari appxmanifest.xml.
properties.packageRelativePath	string	Jalur Relatif ke paket di dalam gambar.
properties.version	string	Versi paket ditemukan di appxmanifest.xml.
systemData	systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

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.

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

MSIX Packages - Create Or Update

Parameter URI

Isi Permintaan

Respons

Contoh

MSIXPackage_Create

Permintaan sampel

Respon sampel

Definisi

CloudError

CloudErrorProperties

createdByType

MSIXPackage

MsixPackageApplications

MsixPackageDependencies

systemData