Microsoft.DesktopVirtualisierungsanwendungGruppen

Bicep-Ressourcendefinition

Der ApplicationGroups-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DesktopVirtualization/applicationGroups-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.

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

Eigenschaftswerte

Microsoft.DesktopVirtualisierung/Anwendungsgruppen

Name Beschreibung Wert
Identität Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. ManagedServiceIdentity-
Art Metadaten, die von Portal/Tooling/etc. verwendet werden, um unterschiedliche UX-Oberflächen für Ressourcen desselben Typs zu rendern; z. B. ApiApps sind eine Art von Microsoft.Web/Sites-Typ. Wenn diese Unterstützung unterstützt wird, muss der Ressourcenanbieter diesen Wert überprüfen und beibehalten. Schnur

Zwänge:
Muster = ^[-\w\._,\(\)]+$
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
managedBy Die vollqualifizierte Ressourcen-ID der Ressource, die diese Ressource verwaltet. Gibt an, ob diese Ressource von einer anderen Azure-Ressource verwaltet wird. Wenn dies vorhanden ist, löscht die Bereitstellung des vollständigen Modus die Ressource nicht, wenn sie aus der Vorlage entfernt wird, da sie von einer anderen Ressource verwaltet wird. Schnur
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 3
Max. Länge = 64
Pattern = ^[A-Za-z0-9@.\-_ ]*$ (erforderlich)
Plan Details zum Ressourcenplan. Planen
Eigenschaften Detaillierte Eigenschaften für ApplicationGroup ApplicationGroupProperties- (erforderlich)
Sku Die dieser Ressource zugeordnete SKU (Lagerhaltungseinheit). Sku-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

ApplicationGroup-Eigenschaften

Name Beschreibung Wert
applicationGroupType Ressourcentyp der ApplicationGroup. "Desktop"
'RemoteApp' (erforderlich)
Beschreibung Beschreibung der ApplicationGroup. Schnur
benutzerfreundlicher Name Anzeigename von ApplicationGroup. Schnur
hostPoolArmPfad HostPool-Armpfad der ApplicationGroup. Zeichenfolge (erforderlich)
oboTenantId Mandant, für den die Ressource angefordert wird. Schnur
showInFeed Boolescher Wert, der angibt, ob die applicationGroup im Feed angezeigt wird. Bool

Verwaltete Dienstidentität

Name Beschreibung Wert
Art Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned" (erforderlich)
vom Benutzer zugewiesene Identitäten Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. ManagedServiceIdentityUserAssignedIdentities-

ManagedServiceIdentityUserAssignedIdentities

Name Beschreibung Wert

Plan

Name Beschreibung Wert
Name Ein benutzerdefinierter Name des 3rd Party Artifact, das beschafft wird. Zeichenfolge (erforderlich)
Produkt Das 3rd Party Artefakt, das beschafft wird. Z.B. NewRelic. Das Produkt entspricht der Für das Artefakt angegebenen OfferID zum Zeitpunkt des Data Market-Onboardings. Zeichenfolge (erforderlich)
Aktionscode Ein Herausgeber hat Werbecode bereitgestellt, der im Data Market für das angegebene Produkt/Artefakt bereitgestellt wird. Schnur
Verlag Der Herausgeber des 3rd Party Artifact, das gekauft wird. Z. B. NewRelic Zeichenfolge (erforderlich)
Version Die Version des gewünschten Produkts/Artefakts. Schnur

Sku

Name Beschreibung Wert
Fassungsvermögen Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. Int
Familie Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. Schnur
Name Der Name der SKU. Z.B. P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. Zeichenfolge (erforderlich)
Größe Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. Schnur
Rang Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. "Einfach"
"Kostenlos"
"Premium"
"Standard"

Verfolgte ResourceTags

Name Beschreibung Wert

UserAssignedIdentity

Name Beschreibung Wert

Verwendungsbeispiele

Bicep-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung einer Virtual Desktop-Anwendungsgruppe.

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: ''
  }
}

Von Azure verifizierte Module

Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Modul Beschreibung
Azure Virtual Desktop (AVD)-Anwendungsgruppe AVM-Ressourcenmodul für Die Anwendungsgruppe Azure Virtual Desktop (AVD)

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei Beschreibung
erstellt AVD mit microsoft Entra ID Join Mit dieser Vorlage können Sie Azure Virtual Desktop-Ressourcen wie Hostpool, Anwendungsgruppe, Arbeitsbereich, einen Testsitzungshost und deren Erweiterungen mit Microsoft Entra ID erstellen.

ARM-Vorlagenressourcendefinition

Der ApplicationGroups-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DesktopVirtualization/applicationGroups-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

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

Eigenschaftswerte

Microsoft.DesktopVirtualisierung/Anwendungsgruppen

Name Beschreibung Wert
apiVersion (Englisch) Die API-Version '2026-04-01-Vorschau'
Identität Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. ManagedServiceIdentity-
Art Metadaten, die von Portal/Tooling/etc. verwendet werden, um unterschiedliche UX-Oberflächen für Ressourcen desselben Typs zu rendern; z. B. ApiApps sind eine Art von Microsoft.Web/Sites-Typ. Wenn diese Unterstützung unterstützt wird, muss der Ressourcenanbieter diesen Wert überprüfen und beibehalten. Schnur

Zwänge:
Muster = ^[-\w\._,\(\)]+$
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
managedBy Die vollqualifizierte Ressourcen-ID der Ressource, die diese Ressource verwaltet. Gibt an, ob diese Ressource von einer anderen Azure-Ressource verwaltet wird. Wenn dies vorhanden ist, löscht die Bereitstellung des vollständigen Modus die Ressource nicht, wenn sie aus der Vorlage entfernt wird, da sie von einer anderen Ressource verwaltet wird. Schnur
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 3
Max. Länge = 64
Pattern = ^[A-Za-z0-9@.\-_ ]*$ (erforderlich)
Plan Details zum Ressourcenplan. Planen
Eigenschaften Detaillierte Eigenschaften für ApplicationGroup ApplicationGroupProperties- (erforderlich)
Sku Die dieser Ressource zugeordnete SKU (Lagerhaltungseinheit). Sku-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp "Microsoft.DesktopVirtualization/applicationGroups"

ApplicationGroup-Eigenschaften

Name Beschreibung Wert
applicationGroupType Ressourcentyp der ApplicationGroup. "Desktop"
'RemoteApp' (erforderlich)
Beschreibung Beschreibung der ApplicationGroup. Schnur
benutzerfreundlicher Name Anzeigename von ApplicationGroup. Schnur
hostPoolArmPfad HostPool-Armpfad der ApplicationGroup. Zeichenfolge (erforderlich)
oboTenantId Mandant, für den die Ressource angefordert wird. Schnur
showInFeed Boolescher Wert, der angibt, ob die applicationGroup im Feed angezeigt wird. Bool

Verwaltete Dienstidentität

Name Beschreibung Wert
Art Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned" (erforderlich)
vom Benutzer zugewiesene Identitäten Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. ManagedServiceIdentityUserAssignedIdentities-

ManagedServiceIdentityUserAssignedIdentities

Name Beschreibung Wert

Plan

Name Beschreibung Wert
Name Ein benutzerdefinierter Name des 3rd Party Artifact, das beschafft wird. Zeichenfolge (erforderlich)
Produkt Das 3rd Party Artefakt, das beschafft wird. Z.B. NewRelic. Das Produkt entspricht der Für das Artefakt angegebenen OfferID zum Zeitpunkt des Data Market-Onboardings. Zeichenfolge (erforderlich)
Aktionscode Ein Herausgeber hat Werbecode bereitgestellt, der im Data Market für das angegebene Produkt/Artefakt bereitgestellt wird. Schnur
Verlag Der Herausgeber des 3rd Party Artifact, das gekauft wird. Z. B. NewRelic Zeichenfolge (erforderlich)
Version Die Version des gewünschten Produkts/Artefakts. Schnur

Sku

Name Beschreibung Wert
Fassungsvermögen Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. Int
Familie Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. Schnur
Name Der Name der SKU. Z.B. P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. Zeichenfolge (erforderlich)
Größe Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. Schnur
Rang Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. "Einfach"
"Kostenlos"
"Premium"
"Standard"

Verfolgte ResourceTags

Name Beschreibung Wert

UserAssignedIdentity

Name Beschreibung Wert

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Schablone Beschreibung
erstellt AVD mit microsoft Entra ID Join

Bereitstellen in Azure
Mit dieser Vorlage können Sie Azure Virtual Desktop-Ressourcen wie Hostpool, Anwendungsgruppe, Arbeitsbereich, einen Testsitzungshost und deren Erweiterungen mit Microsoft Entra ID erstellen.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der ApplicationGroups-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DesktopVirtualization/applicationGroups-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

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

Eigenschaftswerte

Microsoft.DesktopVirtualisierung/Anwendungsgruppen

Name Beschreibung Wert
Identität Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. ManagedServiceIdentity-
Art Metadaten, die von Portal/Tooling/etc. verwendet werden, um unterschiedliche UX-Oberflächen für Ressourcen desselben Typs zu rendern; z. B. ApiApps sind eine Art von Microsoft.Web/Sites-Typ. Wenn diese Unterstützung unterstützt wird, muss der Ressourcenanbieter diesen Wert überprüfen und beibehalten. Schnur

Zwänge:
Muster = ^[-\w\._,\(\)]+$
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
managedBy Die vollqualifizierte Ressourcen-ID der Ressource, die diese Ressource verwaltet. Gibt an, ob diese Ressource von einer anderen Azure-Ressource verwaltet wird. Wenn dies vorhanden ist, löscht die Bereitstellung des vollständigen Modus die Ressource nicht, wenn sie aus der Vorlage entfernt wird, da sie von einer anderen Ressource verwaltet wird. Schnur
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 3
Max. Länge = 64
Pattern = ^[A-Za-z0-9@.\-_ ]*$ (erforderlich)
Plan Details zum Ressourcenplan. Planen
Eigenschaften Detaillierte Eigenschaften für ApplicationGroup ApplicationGroupProperties- (erforderlich)
Sku Die dieser Ressource zugeordnete SKU (Lagerhaltungseinheit). Sku-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft. DesktopVirtualization/applicationGroups@2026-04-01-preview"

ApplicationGroup-Eigenschaften

Name Beschreibung Wert
applicationGroupType Ressourcentyp der ApplicationGroup. "Desktop"
'RemoteApp' (erforderlich)
Beschreibung Beschreibung der ApplicationGroup. Schnur
benutzerfreundlicher Name Anzeigename von ApplicationGroup. Schnur
hostPoolArmPfad HostPool-Armpfad der ApplicationGroup. Zeichenfolge (erforderlich)
oboTenantId Mandant, für den die Ressource angefordert wird. Schnur
showInFeed Boolescher Wert, der angibt, ob die applicationGroup im Feed angezeigt wird. Bool

Verwaltete Dienstidentität

Name Beschreibung Wert
Art Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned" (erforderlich)
vom Benutzer zugewiesene Identitäten Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. ManagedServiceIdentityUserAssignedIdentities-

ManagedServiceIdentityUserAssignedIdentities

Name Beschreibung Wert

Plan

Name Beschreibung Wert
Name Ein benutzerdefinierter Name des 3rd Party Artifact, das beschafft wird. Zeichenfolge (erforderlich)
Produkt Das 3rd Party Artefakt, das beschafft wird. Z.B. NewRelic. Das Produkt entspricht der Für das Artefakt angegebenen OfferID zum Zeitpunkt des Data Market-Onboardings. Zeichenfolge (erforderlich)
Aktionscode Ein Herausgeber hat Werbecode bereitgestellt, der im Data Market für das angegebene Produkt/Artefakt bereitgestellt wird. Schnur
Verlag Der Herausgeber des 3rd Party Artifact, das gekauft wird. Z. B. NewRelic Zeichenfolge (erforderlich)
Version Die Version des gewünschten Produkts/Artefakts. Schnur

Sku

Name Beschreibung Wert
Fassungsvermögen Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. Int
Familie Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. Schnur
Name Der Name der SKU. Z.B. P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. Zeichenfolge (erforderlich)
Größe Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. Schnur
Rang Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. "Einfach"
"Kostenlos"
"Premium"
"Standard"

Verfolgte ResourceTags

Name Beschreibung Wert

UserAssignedIdentity

Name Beschreibung Wert

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung einer Virtual Desktop-Anwendungsgruppe.

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

Von Azure verifizierte Module

Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Modul Beschreibung
Azure Virtual Desktop (AVD)-Anwendungsgruppe AVM-Ressourcenmodul für Die Anwendungsgruppe Azure Virtual Desktop (AVD)