App Attach Package - Update

Serviço:: Desktop Virtualization

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

Atualizar um pacote de anexação de aplicativo

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]\|(-(?!-))){1,61}[a-z0-9]$	O nome do pacote de Anexo de Aplicativo
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 uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
properties	AppAttachPackagePatchProperties	Propriedades detalhadas do Pacote de Anexação de Aplicativo

Respostas

Nome	Tipo	Description
200 OK	AppAttachPackage	Atualizei com sucesso o App Attach Package.
Other Status Codes	ErrorResponse	Resposta de erro de automação descrevendo por que a operação falhou.

Exemplos

AppAttachPackage_Update

Solicitação de exemplo

HTTP

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

Resposta de exemplo

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

Definições

Nome	Description
AppAttachPackage	Esquema para propriedades do Pacote de Anexação de Aplicativo.
AppAttachPackageInfoProperties	Esquema para propriedades de Informações do Pacote de Importação.
AppAttachPackagePatch	Esquema para propriedades atualizáveis do Pacote de Anexação de Aplicativo.
AppAttachPackagePatchProperties	Esquema para campos que podem ser corrigidos em um Pacote de Anexo de Aplicativo.
AppAttachPackageProperties	Esquema para propriedades do Pacote de Anexação de Aplicativo.
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
failHealthCheckOnStagingFailure	Parâmetro que indica como a verificação de integridade deve se comportar se esse pacote falhar no preparo
MsixPackageApplications	Esquema para propriedades do aplicativo de pacote MSIX.
MsixPackageDependencies	Esquema para propriedades de Dependências de Pacote MSIX.
packageTimestamped	Está com carimbo de data/hora do pacote para que ele possa ignorar a data de expiração do certificado
ProvisioningState	O estado de provisionamento atual.
systemData	Metadados relativos à criação e última modificação do recurso.

AppAttachPackage

Objeto

Esquema para propriedades do Pacote de Anexação de Aplicativo.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	A localização geográfica onde o recurso reside
name	string	O nome do recurso
properties	AppAttachPackageProperties	Propriedades detalhadas do Pacote de Anexação de Aplicativo
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AppAttachPackageInfoProperties

Objeto

Esquema para propriedades de Informações do Pacote de Importação.

Nome	Tipo	Description
certificateExpiry	string (date-time)	O certificado de data expira, encontrado no appxmanifest.xml.
certificateName	string	Nome do certificado encontrado no appxmanifest.xml.
displayName	string	Nome amigável a ser exibido no portal.
imagePath	string	Caminho da imagem VHD/CIM no Compartilhamento de Rede.
isActive	boolean	Torne essa versão do pacote a ativa no hostpool.
isPackageTimestamped	packageTimestamped	Está com carimbo de data/hora do pacote para que ele possa ignorar a data de expiração do certificado
isRegularRegistration	boolean	Especifica como registrar o Pacote no feed.
lastUpdated	string (date-time)	O Pacote de Data foi atualizado pela última vez, encontrado no appxmanifest.xml.
packageAlias	string	Alias do Pacote de Anexação de Aplicativo. Atribuído no momento da importação
packageApplications	MsixPackageApplications[]	Lista de aplicativos de pacote.
packageDependencies	MsixPackageDependencies[]	Lista de dependências de pacote.
packageFamilyName	string	Nome da família do pacote de appxmanifest.xml. Contém o nome do pacote e o nome do publicador.
packageFullName	string	Nome completo do pacote de appxmanifest.xml.
packageName	string	Nome do pacote de appxmanifest.xml.
packageRelativePath	string	Caminho relativo para o pacote dentro da imagem.
version	string	Versão do pacote encontrada no appxmanifest.xml.

AppAttachPackagePatch

Objeto

Esquema para propriedades atualizáveis do Pacote de Anexação de Aplicativo.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties	AppAttachPackagePatchProperties	Propriedades detalhadas do Pacote de Anexação de Aplicativo
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AppAttachPackagePatchProperties

Objeto

Esquema para campos que podem ser corrigidos em um Pacote de Anexo de Aplicativo.

Nome	Tipo	Description
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parâmetro que indica como a verificação de integridade deve se comportar se esse pacote falhar no preparo
hostPoolReferences	string[] (arm-id)	Lista de IDs de recursos do Hostpool.
image	AppAttachPackageInfoProperties	Propriedades detalhadas do Pacote de Anexação de Aplicativo
keyVaultURL	string	Caminho da URL para o nome do certificado localizado em keyVault

AppAttachPackageProperties

Objeto

Esquema para propriedades do Pacote de Anexação de Aplicativo.

Nome	Tipo	Description
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parâmetro que indica como a verificação de integridade deve se comportar se esse pacote falhar no preparo
hostPoolReferences	string[]	Lista de IDs de recursos do Hostpool.
image	AppAttachPackageInfoProperties	Propriedades detalhadas do Pacote de Anexação de Aplicativo
keyVaultURL	string	Caminho da URL para o nome do certificado localizado em keyVault
provisioningState	ProvisioningState	O estado de provisionamento do Pacote de Anexação de Aplicativo.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

failHealthCheckOnStagingFailure

Enumeração

Parâmetro que indica como a verificação de integridade deve se comportar se esse pacote falhar no preparo

Valor	Description
Unhealthy
NeedsAssistance
DoNotFail

MsixPackageApplications

Objeto

Esquema para propriedades do aplicativo de pacote MSIX.

Nome	Tipo	Description
appId	string	ID do aplicativo de pacote, encontrada 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 de 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

Objeto

Esquema para propriedades de Dependências de Pacote MSIX.

Nome	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.

packageTimestamped

Enumeração

Está com carimbo de data/hora do pacote para que ele possa ignorar a data de expiração do certificado

Valor	Description
Timestamped
NotTimestamped

ProvisioningState

Enumeração

O estado de provisionamento atual.

Valor	Description
Succeeded
Provisioning
Failed
Canceled

systemData

Objeto

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

Nome	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.

Compartilhar via

App Attach Package - Update

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

AppAttachPackage_Update

Solicitação de exemplo

Resposta de exemplo

Definições

AppAttachPackage

AppAttachPackageInfoProperties

AppAttachPackagePatch

AppAttachPackagePatchProperties

AppAttachPackageProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

failHealthCheckOnStagingFailure

MsixPackageApplications

MsixPackageDependencies

packageTimestamped

ProvisioningState

systemData