MSIX Packages - Create Or Update

Serviço:: Desktop Virtualization

Versão da API:: 2025-10-10

Crie ou atualize um pacote MSIX.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	O nome do pool de hosts dentro do grupo de recursos especificado
msixPackageFullName	path	True	string minLength: 3 maxLength: 100 pattern: ^[A-Za-z0-9@.\-_ ]*$	O nome completo do pacote específico da versão do pacote MSIX dentro do hostpool especificado
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Tipo	Description
properties.displayName	string	Nome amigável a ser exibido no portal.
properties.imagePath	string	Caminho da imagem VHD/CIM no Compartilhamento de Rede.
properties.isActive	boolean	Torne esta versão do pacote a ativa em todo o hostpool.
properties.isRegularRegistration	boolean	Especifica como registrar o pacote no feed.
properties.lastUpdated	string (date-time)	Data em que o pacote foi atualizado pela última vez, encontrado no appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Lista de aplicativos de pacote.
properties.packageDependencies	MsixPackageDependencies[]	Lista de dependências do pacote.
properties.packageFamilyName	string	Nome de família do pacote de appxmanifest.xml. Contém Nome do Pacote e Nome do Editor.
properties.packageName	string	Nome do pacote de appxmanifest.xml.
properties.packageRelativePath	string	Caminho relativo para o pacote dentro da imagem.
properties.version	string	Versão do pacote encontrada no appxmanifest.xml.

Respostas

Name	Tipo	Description
200 OK	MSIXPackage	Atualizei com sucesso o pacote MSIX.
201 Created	MSIXPackage	Criei com sucesso o Pacote MSIX.
Other Status Codes	CloudError	Resposta de erro de automação descrevendo por que a operação falhou.

Exemplos

MSIXPackage_Create

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
      }
    ]
  }
}

Código de estado:: 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"
      }
    ]
  }
}

Definições

Name	Description
CloudError	Objeto de erro na nuvem.
CloudErrorProperties	Propriedades do objeto de erro na nuvem.
createdByType	O tipo de identidade que criou o recurso.
MSIXPackage	Esquema para propriedades do pacote MSIX.
MsixPackageApplications	Esquema para propriedades do aplicativo de pacote MSIX.
MsixPackageDependencies	Esquema para propriedades de dependências do pacote MSIX.
systemData	Metadados referentes à criação e última modificação do recurso.

CloudError

Object

Objeto de erro na nuvem.

Name	Tipo	Description
error	CloudErrorProperties	Propriedades do objeto de erro na nuvem.

CloudErrorProperties

Object

Propriedades do objeto de erro na nuvem.

Name	Tipo	Description
code	string	Código de erro
message	string	Mensagem de erro indicando por que a operação falhou.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

MSIXPackage

Object

Esquema para propriedades do pacote MSIX.

Name	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.displayName	string	Nome amigável a ser exibido no portal.
properties.imagePath	string	Caminho da imagem VHD/CIM no Compartilhamento de Rede.
properties.isActive	boolean	Torne esta versão do pacote a ativa em todo o hostpool.
properties.isRegularRegistration	boolean	Especifica como registrar o pacote no feed.
properties.lastUpdated	string (date-time)	Data em que o pacote foi atualizado pela última vez, encontrado no appxmanifest.xml.
properties.packageApplications	MsixPackageApplications[]	Lista de aplicativos de pacote.
properties.packageDependencies	MsixPackageDependencies[]	Lista de dependências do pacote.
properties.packageFamilyName	string	Nome de família do pacote de appxmanifest.xml. Contém Nome do Pacote e Nome do Editor.
properties.packageName	string	Nome do pacote de appxmanifest.xml.
properties.packageRelativePath	string	Caminho relativo para o pacote dentro da imagem.
properties.version	string	Versão do pacote encontrada no appxmanifest.xml.
systemData	systemData	Metadados referentes à criação e última modificação do recurso.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

MsixPackageApplications

Object

Esquema para propriedades do aplicativo de pacote MSIX.

Name	Tipo	Description
appId	string	ID do aplicativo do pacote, encontrado em appxmanifest.xml.
appUserModelID	string	Usado para ativar o aplicativo de pacote. Consiste em Nome do Pacote e ApplicationID. Encontrado em appxmanifest.xml.
description	string	Descrição do aplicativo do pacote.
friendlyName	string	Nome amigável.
iconImageName	string	Nome amigável.
rawIcon	string (byte)	o ícone uma cadeia de caracteres de 64 bits como uma matriz de bytes.
rawPng	string (byte)	o ícone uma cadeia de caracteres de 64 bits como uma matriz de bytes.

MsixPackageDependencies

Object

Esquema para propriedades de dependências do pacote MSIX.

Name	Tipo	Description
dependencyName	string	Nome da dependência do pacote.
minVersion	string	Versão de dependência necessária.
publisher	string	Nome do editor de dependência.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Partilhar via

MSIX Packages - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

MSIXPackage_Create

Pedido de amostra

Resposta da amostra

Definições

CloudError

CloudErrorProperties

createdByType

MSIXPackage

MsixPackageApplications

MsixPackageDependencies

systemData