MSIX Packages - Create Or Update

Usługa:: Desktop Virtualization

Wersja interfejsu API:: 2025-10-10

Tworzenie lub aktualizowanie pakietu MSIX.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	Nazwa puli hostów w określonej grupie zasobów
msixPackageFullName	path	True	string minLength: 3 maxLength: 100 pattern: ^[A-Za-z0-9@.\-_ ]*$	Pełna nazwa pakietu MSIX specyficzna dla wersji w określonej puli hostów
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
properties.displayName	string	Przyjazna nazwa użytkownika, która ma być wyświetlana w portalu.
properties.imagePath	string	Ścieżka obrazu VHD/CIM w udziale sieciowym.
properties.isActive	boolean	Ustaw tę wersję pakietu jako aktywną w puli hostów.
properties.isRegularRegistration	boolean	Określa sposób rejestrowania pakietu w kanale informacyjnym.
properties.lastUpdated	string (date-time)	Data ostatniej aktualizacji pakietu znaleziono w appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Lista aplikacji pakietów.
properties.packageDependencies	MsixPackageDependencies[]	Lista zależności pakietów.
properties.packageFamilyName	string	Nazwa rodziny pakietów z appxmanifest.xml. Zawiera nazwę pakietu i nazwę wydawcy.
properties.packageName	string	Nazwa pakietu z appxmanifest.xml.
properties.packageRelativePath	string	Względna ścieżka do pakietu wewnątrz obrazu.
properties.version	string	Wersja pakietu znaleziona w appxmanifest.xml.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	MSIXPackage	Pakiet MSIX został pomyślnie zaktualizowany.
201 Created	MSIXPackage	Pomyślnie utworzony pakiet MSIX.
Other Status Codes	CloudError	Odpowiedź na błąd automatyzacji opisująca, dlaczego operacja nie powiodła się.

Przykłady

MSIXPackage_Create

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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"
      }
    ]
  }
}

Kod stanu:: 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"
      }
    ]
  }
}

Definicje

Nazwa	Opis
CloudError	Błąd w chmurze.
CloudErrorProperties	Właściwości obiektu błędu chmury.
createdByType	Typ tożsamości, która utworzyła zasób.
MSIXPackage	Schemat właściwości pakietu MSIX.
MsixPackageApplications	Schemat właściwości aplikacji pakietu MSIX.
MsixPackageDependencies	Schemat właściwości zależności pakietu MSIX.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

CloudError

Objekt

Błąd w chmurze.

Nazwa	Typ	Opis
error	CloudErrorProperties	Właściwości obiektu błędu chmury.

CloudErrorProperties

Objekt

Właściwości obiektu błędu chmury.

Nazwa	Typ	Opis
code	string	Kod błędu
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

MSIXPackage

Objekt

Schemat właściwości pakietu MSIX.

Nazwa	Typ	Opis
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nazwa zasobu
properties.displayName	string	Przyjazna nazwa użytkownika, która ma być wyświetlana w portalu.
properties.imagePath	string	Ścieżka obrazu VHD/CIM w udziale sieciowym.
properties.isActive	boolean	Ustaw tę wersję pakietu jako aktywną w puli hostów.
properties.isRegularRegistration	boolean	Określa sposób rejestrowania pakietu w kanale informacyjnym.
properties.lastUpdated	string (date-time)	Data ostatniej aktualizacji pakietu znaleziono w appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Lista aplikacji pakietów.
properties.packageDependencies	MsixPackageDependencies[]	Lista zależności pakietów.
properties.packageFamilyName	string	Nazwa rodziny pakietów z appxmanifest.xml. Zawiera nazwę pakietu i nazwę wydawcy.
properties.packageName	string	Nazwa pakietu z appxmanifest.xml.
properties.packageRelativePath	string	Względna ścieżka do pakietu wewnątrz obrazu.
properties.version	string	Wersja pakietu znaleziona w appxmanifest.xml.
systemData	systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

MsixPackageApplications

Objekt

Schemat właściwości aplikacji pakietu MSIX.

Nazwa	Typ	Opis
appId	string	Identyfikator aplikacji pakietu znajdujący się w appxmanifest.xml.
appUserModelID	string	Służy do aktywowania aplikacji pakietu. Składa się z nazwy pakietu i identyfikatora aplikacji. Znaleziono w appxmanifest.xml.
description	string	Opis aplikacji pakietu.
friendlyName	string	Przyjazna nazwa użytkownika.
iconImageName	string	Przyjazna nazwa użytkownika.
rawIcon	string (byte)	ikona 64-bitowy ciąg jako tablica bajtów.
rawPng	string (byte)	ikona 64-bitowy ciąg jako tablica bajtów.

MsixPackageDependencies

Objekt

Schemat właściwości zależności pakietu MSIX.

Nazwa	Typ	Opis
dependencyName	string	Nazwa zależności pakietu.
minVersion	string	Wymagana wersja zależności.
publisher	string	Nazwa wydawcy zależności.

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Udostępnij za pośrednictwem

MSIX Packages - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

MSIXPackage_Create

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

CloudError

CloudErrorProperties

createdByType

MSIXPackage

MsixPackageApplications

MsixPackageDependencies

systemData