Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
- più recenti
- 2026-04-01-anteprima
- 2026-03-01-anteprima
- Anteprima 2026-01-01-
- 2025-11-01-anteprima
- 2025-10-10
- 2025-09-01-anteprima
- 2025-08-01-preview
- 2025-04-01-preview
- 2025-03-01-anteprima
- 2024-11-01-anteprima
- 2024-08-08-anteprima
- 2024-04-08-anteprima
- 2024-04-03
- Anteprima 2024-03-06
- 2024-01-16-anteprima
- 11-01-preview 2023
- 2023-10-04-anteprima
- 2023-09-05
- Anteprima 2022-10-14
- 2022-09-09
- 2022-04-01-anteprima
- Anteprima 2022-02-10
- Anteprima 2021-09-03
- 2021-07-12
- 2021-04-01-anteprima
-
03-03-09-preview 2021 - Anteprima 2021-02-01
-
2021-01-14-preview - Anteprima 2020-11-10
- Anteprima 2020-11-02-preview
- Anteprima 2020-10-19
- Anteprima 2020-09-21
- 12-10-preview 2019
- 24-09-2019
- Anteprima 2019-01-23
Definizione di risorsa Bicep
Il tipo di risorsa applicationGroups può essere distribuito con operazioni destinate a:
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:
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 |
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) |