Microsoft.DesktopApplicazione di virtualizzazioneGruppi

Definizione di risorsa Bicep

Il tipo di risorsa applicationGroups può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DesktopVirtualization/applicationGroups, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.DesktopVirtualization/applicationGroups@2026-04-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  managedBy: 'string'
  name: 'string'
  plan: {
    name: 'string'
    product: 'string'
    promotionCode: 'string'
    publisher: 'string'
    version: 'string'
  }
  properties: {
    applicationGroupType: 'string'
    description: 'string'
    friendlyName: 'string'
    hostPoolArmPath: 'string'
    oboTenantId: 'string'
    showInFeed: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

Microsoft.DesktopVirtualization/gruppiDiApplicazioni

Nome Descrizione Valore
identità Identità del servizio gestito assegnate a questa risorsa. ManagedServiceIdentity
gentile Metadati usati dal portale/strumenti/ecc per eseguire il rendering di esperienze utente diverse per le risorse dello stesso tipo; Ad esempio, ApiApps è un tipo di tipo Microsoft.Web/sites. Se supportato, il provider di risorse deve convalidare e rendere persistente questo valore. corda

Vincoli:
Modello = ^[-\w\._,\(\)]+$
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
managedBy ID risorsa completo della risorsa che gestisce questa risorsa. Indica se questa risorsa è gestita da un'altra risorsa di Azure. Se presente, la distribuzione in modalità completa non eliminerà la risorsa se viene rimossa dal modello perché è gestita da un'altra risorsa. corda
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 64
Pattern = ^[A-Za-z0-9@.\-_ ]*$ (obbligatorio)
piano Dettagli del piano di risorse. Pianificare
proprietà Proprietà dettagliate per ApplicationGroup ApplicationGroupProperties (obbligatorio)
Sku SKU (stock keeping unit) assegnato a questa risorsa. sku
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

ApplicationGroupProperties

Nome Descrizione Valore
applicationGroupType Tipo di risorsa applicationgroup. 'Desktop'
'RemoteApp' (obbligatorio)
descrizione Descrizione di ApplicationGroup. corda
nome amichevole Nome descrittivo di ApplicationGroup. corda
hostPoolArmPath Percorso arm hostPool di ApplicationGroup. stringa (obbligatorio)
oboTenantId Tenant per conto del quale viene richiesta la risorsa. corda
mostraInFeed Valore booleano che indica se il gruppo di applicazioni viene visualizzato nel feed. Bool

Identità dei Servizi Gestiti

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

Piano

Nome Descrizione Valore
nome Nome definito dall'utente dell'artefatto di terze parti che viene acquistato. stringa (obbligatorio)
prodotto Artefatto di terze parti che viene acquistato. Ad esempio NewRelic. Il prodotto esegue il mapping all'OfferID specificato per l'artefatto al momento dell'onboarding di Data Market. stringa (obbligatorio)
Codice promozionale Un editore ha fornito il codice promozionale di cui è stato effettuato il provisioning in Data Market per il prodotto o l'artefatto specificato. corda
editore Autore dell'artefatto di terze parti acquistato. Ad esempio, NewRelic stringa (obbligatorio)
Versione Versione del prodotto/artefatto desiderato. corda

Sku

Nome Descrizione Valore
capacità Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. Int
famiglia Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. corda
nome Nome dello SKU. Ad esempio P3. Si tratta in genere di un codice lettera+numero stringa (obbligatorio)
grandezza Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. corda
livello Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. 'Di base'
'Libero'
'Premium'
'Standard'

TrackedResourceTags

Nome Descrizione Valore

Identità Assegnata dall'Utente

Nome Descrizione Valore

Esempi di utilizzo

Esempi bicep

Esempio di base di distribuzione di un gruppo di applicazioni desktop virtuali.

param resourceName string = 'acctest0001'
param location string = 'westus'

resource applicationGroup 'Microsoft.DesktopVirtualization/applicationGroups@2024-04-03' = {
  name: '${resourceName}-ag'
  location: location
  properties: {
    applicationGroupType: 'Desktop'
    description: ''
    friendlyName: ''
    hostPoolArmPath: hostPool.id
  }
}

resource hostPool 'Microsoft.DesktopVirtualization/hostPools@2024-04-03' = {
  name: '${resourceName}-hp'
  location: location
  properties: {
    customRdpProperty: ''
    description: ''
    friendlyName: ''
    hostPoolType: 'Pooled'
    loadBalancerType: 'BreadthFirst'
    maxSessionLimit: 999999
    personalDesktopAssignmentType: ''
    preferredAppGroupType: 'Desktop'
    publicNetworkAccess: 'Enabled'
    startVMOnConnect: false
    validationEnvironment: false
    vmTemplate: ''
  }
}

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo Descrizione
gruppo di applicazioni di Desktop virtuale Azure (AVD) Gruppo di applicazioni AVM Resource Module for Desktop virtuale Azure (AVD)

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

File bicipite Descrizione
crea AVD con microsoft Entra ID Join Questo modello consente di creare risorse di Desktop virtuale Azure, ad esempio pool di host, gruppo di applicazioni, area di lavoro, host di sessione di test e relative estensioni con aggiunta all'ID Microsoft Entra

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa applicationGroups può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DesktopVirtualization/applicationGroups, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.DesktopVirtualization/applicationGroups",
  "apiVersion": "2026-04-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "managedBy": "string",
  "plan": {
    "name": "string",
    "product": "string",
    "promotionCode": "string",
    "publisher": "string",
    "version": "string"
  },
  "properties": {
    "applicationGroupType": "string",
    "description": "string",
    "friendlyName": "string",
    "hostPoolArmPath": "string",
    "oboTenantId": "string",
    "showInFeed": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

Microsoft.DesktopVirtualization/gruppiDiApplicazioni

Nome Descrizione Valore
versione dell'API Versione dell'API 'Anteprima 2026-04-01'
identità Identità del servizio gestito assegnate a questa risorsa. ManagedServiceIdentity
gentile Metadati usati dal portale/strumenti/ecc per eseguire il rendering di esperienze utente diverse per le risorse dello stesso tipo; Ad esempio, ApiApps è un tipo di tipo Microsoft.Web/sites. Se supportato, il provider di risorse deve convalidare e rendere persistente questo valore. corda

Vincoli:
Modello = ^[-\w\._,\(\)]+$
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
managedBy ID risorsa completo della risorsa che gestisce questa risorsa. Indica se questa risorsa è gestita da un'altra risorsa di Azure. Se presente, la distribuzione in modalità completa non eliminerà la risorsa se viene rimossa dal modello perché è gestita da un'altra risorsa. corda
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 64
Pattern = ^[A-Za-z0-9@.\-_ ]*$ (obbligatorio)
piano Dettagli del piano di risorse. Pianificare
proprietà Proprietà dettagliate per ApplicationGroup ApplicationGroupProperties (obbligatorio)
Sku SKU (stock keeping unit) assegnato a questa risorsa. sku
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.DesktopVirtualization/applicationGroups'

ApplicationGroupProperties

Nome Descrizione Valore
applicationGroupType Tipo di risorsa applicationgroup. 'Desktop'
'RemoteApp' (obbligatorio)
descrizione Descrizione di ApplicationGroup. corda
nome amichevole Nome descrittivo di ApplicationGroup. corda
hostPoolArmPath Percorso arm hostPool di ApplicationGroup. stringa (obbligatorio)
oboTenantId Tenant per conto del quale viene richiesta la risorsa. corda
mostraInFeed Valore booleano che indica se il gruppo di applicazioni viene visualizzato nel feed. Bool

Identità dei Servizi Gestiti

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

Piano

Nome Descrizione Valore
nome Nome definito dall'utente dell'artefatto di terze parti che viene acquistato. stringa (obbligatorio)
prodotto Artefatto di terze parti che viene acquistato. Ad esempio NewRelic. Il prodotto esegue il mapping all'OfferID specificato per l'artefatto al momento dell'onboarding di Data Market. stringa (obbligatorio)
Codice promozionale Un editore ha fornito il codice promozionale di cui è stato effettuato il provisioning in Data Market per il prodotto o l'artefatto specificato. corda
editore Autore dell'artefatto di terze parti acquistato. Ad esempio, NewRelic stringa (obbligatorio)
Versione Versione del prodotto/artefatto desiderato. corda

Sku

Nome Descrizione Valore
capacità Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. Int
famiglia Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. corda
nome Nome dello SKU. Ad esempio P3. Si tratta in genere di un codice lettera+numero stringa (obbligatorio)
grandezza Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. corda
livello Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. 'Di base'
'Libero'
'Premium'
'Standard'

TrackedResourceTags

Nome Descrizione Valore

Identità Assegnata dall'Utente

Nome Descrizione Valore

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma Descrizione
crea AVD con microsoft Entra ID Join

Distribuire in Azure
Questo modello consente di creare risorse di Desktop virtuale Azure, ad esempio pool di host, gruppo di applicazioni, area di lavoro, host di sessione di test e relative estensioni con aggiunta all'ID Microsoft Entra

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa applicationGroups può essere distribuito con operazioni destinate a:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DesktopVirtualization/applicationGroups, aggiungere il file Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DesktopVirtualization/applicationGroups@2026-04-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    managedBy = "string"
    plan = {
      name = "string"
      product = "string"
      promotionCode = "string"
      publisher = "string"
      version = "string"
    }
    properties = {
      applicationGroupType = "string"
      description = "string"
      friendlyName = "string"
      hostPoolArmPath = "string"
      oboTenantId = "string"
      showInFeed = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Valori delle proprietà

Microsoft.DesktopVirtualization/gruppiDiApplicazioni

Nome Descrizione Valore
identità Identità del servizio gestito assegnate a questa risorsa. ManagedServiceIdentity
gentile Metadati usati dal portale/strumenti/ecc per eseguire il rendering di esperienze utente diverse per le risorse dello stesso tipo; Ad esempio, ApiApps è un tipo di tipo Microsoft.Web/sites. Se supportato, il provider di risorse deve convalidare e rendere persistente questo valore. corda

Vincoli:
Modello = ^[-\w\._,\(\)]+$
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
managedBy ID risorsa completo della risorsa che gestisce questa risorsa. Indica se questa risorsa è gestita da un'altra risorsa di Azure. Se presente, la distribuzione in modalità completa non eliminerà la risorsa se viene rimossa dal modello perché è gestita da un'altra risorsa. corda
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 64
Pattern = ^[A-Za-z0-9@.\-_ ]*$ (obbligatorio)
piano Dettagli del piano di risorse. Pianificare
proprietà Proprietà dettagliate per ApplicationGroup ApplicationGroupProperties (obbligatorio)
Sku SKU (stock keeping unit) assegnato a questa risorsa. sku
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft. DesktopVirtualization/applicationGroups@2026-04-01-preview"

ApplicationGroupProperties

Nome Descrizione Valore
applicationGroupType Tipo di risorsa applicationgroup. 'Desktop'
'RemoteApp' (obbligatorio)
descrizione Descrizione di ApplicationGroup. corda
nome amichevole Nome descrittivo di ApplicationGroup. corda
hostPoolArmPath Percorso arm hostPool di ApplicationGroup. stringa (obbligatorio)
oboTenantId Tenant per conto del quale viene richiesta la risorsa. corda
mostraInFeed Valore booleano che indica se il gruppo di applicazioni viene visualizzato nel feed. Bool

Identità dei Servizi Gestiti

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

Piano

Nome Descrizione Valore
nome Nome definito dall'utente dell'artefatto di terze parti che viene acquistato. stringa (obbligatorio)
prodotto Artefatto di terze parti che viene acquistato. Ad esempio NewRelic. Il prodotto esegue il mapping all'OfferID specificato per l'artefatto al momento dell'onboarding di Data Market. stringa (obbligatorio)
Codice promozionale Un editore ha fornito il codice promozionale di cui è stato effettuato il provisioning in Data Market per il prodotto o l'artefatto specificato. corda
editore Autore dell'artefatto di terze parti acquistato. Ad esempio, NewRelic stringa (obbligatorio)
Versione Versione del prodotto/artefatto desiderato. corda

Sku

Nome Descrizione Valore
capacità Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. Int
famiglia Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. corda
nome Nome dello SKU. Ad esempio P3. Si tratta in genere di un codice lettera+numero stringa (obbligatorio)
grandezza Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. corda
livello Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. 'Di base'
'Libero'
'Premium'
'Standard'

TrackedResourceTags

Nome Descrizione Valore

Identità Assegnata dall'Utente

Nome Descrizione Valore

Esempi di utilizzo

Esempi di Terraform

Esempio di base di distribuzione di un gruppo di applicazioni desktop virtuali.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "hostPool" {
  type      = "Microsoft.DesktopVirtualization/hostPools@2024-04-03"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-hp"
  location  = var.location
  body = {
    properties = {
      customRdpProperty             = ""
      description                   = ""
      friendlyName                  = ""
      hostPoolType                  = "Pooled"
      loadBalancerType              = "BreadthFirst"
      maxSessionLimit               = 999999
      personalDesktopAssignmentType = ""
      preferredAppGroupType         = "Desktop"
      publicNetworkAccess           = "Enabled"
      startVMOnConnect              = false
      validationEnvironment         = false
      vmTemplate                    = ""
    }
  }
}

resource "azapi_resource" "applicationGroup" {
  type      = "Microsoft.DesktopVirtualization/applicationGroups@2024-04-03"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-ag"
  location  = var.location
  body = {
    properties = {
      applicationGroupType = "Desktop"
      description          = ""
      friendlyName         = ""
      hostPoolArmPath      = azapi_resource.hostPool.id
    }
  }
}

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo Descrizione
gruppo di applicazioni di Desktop virtuale Azure (AVD) Gruppo di applicazioni AVM Resource Module for Desktop virtuale Azure (AVD)