Microsoft. DesktopVirtualization applicationGroups

Bicep-erőforrásdefiníció

Az applicationGroups erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Használati példák

Bicep-minták

Alapvető példa a virtuális asztali alkalmazáscsoport üzembe helyezésére.

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

Azure-ból ellenőrzött modulok

Az alábbi Azure Verified Modules használható az erőforrástípus üzembe helyezéséhez.

Modul Leírás
Azure Virtual Desktop (AVD) alkalmazáscsoport AVM-erőforrásmodul az Azure Virtual Desktop (AVD) alkalmazáscsoporthoz

Azure gyorsútmutató-minták

Az alábbi Azure rövid útmutatósablonok bicep-mintákat tartalmaznak az erőforrástípus üzembe helyezéséhez.

Bicep-fájl Leírás
AVD létrehozása a Microsoft Entra ID Join Ez a sablon lehetővé teszi olyan Azure Virtual Desktop-erőforrások létrehozását, mint a gazdagépkészlet, az alkalmazáscsoport, a munkaterület, a tesztmunkamenet-gazdagép és annak bővítményei a Microsoft Entra ID-csatlakozással

Erőforrás formátuma

Microsoft.DesktopVirtualization/applicationGroups erőforrás létrehozásához adja hozzá a következő Bicep-et a sablonhoz.

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

Tulajdonságértékek

Microsoft.DesktopVirtualization/applicationGroups

Név Leírás Érték
identitás Az erőforráshoz rendelt felügyeltszolgáltatás-identitások. ManagedServiceIdentity
fajta A portál/eszközhasználat/stb. által használt metaadatok az azonos típusú erőforrások különböző UX-élményének megjelenítéséhez; Például az ApiApps egyfajta Microsoft.Web/sites típusú. Ha támogatott, az erőforrás-szolgáltatónak ellenőriznie és meg kell őriznie ezt az értéket. húr

Korlátok:
Minta = ^[-\w\._,\(\)]+$
hely Az a földrajzi hely, ahol az erőforrás él sztring (kötelező)
managedBy Az erőforrást kezelő erőforrás teljes erőforrás-azonosítója. Azt jelzi, hogy ezt az erőforrást egy másik Azure-erőforrás felügyeli-e. Ha ez jelen van, a teljes módú üzembe helyezés nem törli az erőforrást, ha eltávolítják a sablonból, mivel azt egy másik erőforrás kezeli. karakterlánc
név Az erőforrás neve húr

Korlátok:
Minimális hossz = 3
Maximális hossz = 64
Minta = ^[A-Za-z0-9@.\-_ ]*$ (kötelező)
csomag Az erőforrásterv részletei. terv
kellékek Az ApplicationGroup részletes tulajdonságai ApplicationGroupProperties (kötelező)
Sku Az erőforráshoz rendelt termékváltozat (készletmegőrzési egység). termékváltozat
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése

ApplicationGroupProperties

Név Leírás Érték
applicationGroupType Az ApplicationGroup erőforrástípusa. "Asztal"
"RemoteApp" (kötelező)
leírás Az ApplicationGroup leírása. karakterlánc
barátságosNév Az ApplicationGroup rövid neve. karakterlánc
hostPoolArmPath Az ApplicationGroup HostPool arm elérési útja. sztring (kötelező)
oboTenantId Az a bérlő, amelynek nevében az erőforrást kéri. karakterlánc
showInFeed Logikai érték, amely azt jelzi, hogy az applicationGroup megjelenik-e a hírcsatornában. Bool

ManagedServiceIdentity

Név Leírás Érték
típus A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett). "Nincs"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (kötelező)
felhasználóhozzárendeltAzonosítók Az erőforráshoz társított felhasználó által hozzárendelt identitások készlete. A userAssignedIdentities szótárkulcsok arm-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. A szótár értékei lehetnek üres objektumok ({}) a kérelmekben. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Név Leírás Érték

Terv

Név Leírás Érték
név A beszerzett harmadik féltől származó összetevő felhasználó által definiált neve. sztring (kötelező)
termék A beszerzett harmadik féltől származó összetevő. Például NewRelic. A termék leképezést készít az összetevőhöz az adatpiac előkészítésekor megadott OfferID azonosítóra. sztring (kötelező)
promócióKód A közzétevő az említett termékhez/összetevőhöz a Data Marketben kiépített promóciós kódot adta meg. karakterlánc
kiadó A megvásárolt harmadik féltől származó összetevő közzétevője. Pl. NewRelic sztring (kötelező)
verzió A kívánt termék/összetevő verziója. karakterlánc

termékazonosító (SKU)

Név Leírás Érték
kapacitás Ha az SKU támogatja a vertikális felskálázást/azt, akkor a kapacitás egészét is tartalmaznia kell. Ha az erőforrás esetében nem lehetséges a vertikális felskálázás/beskálázás, akkor ez kihagyható. Int
Család Ha a szolgáltatás különböző hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, akkor ezt itt rögzítheti. karakterlánc
név Az termékváltozat neve. Pl. P3. Ez általában egy betű+szám kód sztring (kötelező)
méret A termékváltozat mérete. Ha a névmező a réteg és más értékek kombinációja, akkor ez a különálló kód. karakterlánc
rétegez Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges. "Alapszintű"
"Ingyenes"
"Prémium"
"Standard"

TrackedResourceTags

Név Leírás Érték

Felhasználó által hozzárendelt identitás

Név Leírás Érték

ARM-sablon erőforrásdefiníciója

Az applicationGroups erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

Használati példák

Azure gyorsútmutató-sablonok

Az alábbi Azure rövid útmutatósablonok üzembe helyezni ezt az erőforrástípust.

Sablon Leírás
AVD létrehozása a Microsoft Entra ID Join

Üzembe helyezés az Azure
Ez a sablon lehetővé teszi olyan Azure Virtual Desktop-erőforrások létrehozását, mint a gazdagépkészlet, az alkalmazáscsoport, a munkaterület, a tesztmunkamenet-gazdagép és annak bővítményei a Microsoft Entra ID-csatlakozással

Erőforrás formátuma

Microsoft.DesktopVirtualization/applicationGroups erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.

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

Tulajdonságértékek

Microsoft.DesktopVirtualization/applicationGroups

Név Leírás Érték
apiVersion Az API verziója '2026-04-01-előzetes'
identitás Az erőforráshoz rendelt felügyeltszolgáltatás-identitások. ManagedServiceIdentity
fajta A portál/eszközhasználat/stb. által használt metaadatok az azonos típusú erőforrások különböző UX-élményének megjelenítéséhez; Például az ApiApps egyfajta Microsoft.Web/sites típusú. Ha támogatott, az erőforrás-szolgáltatónak ellenőriznie és meg kell őriznie ezt az értéket. húr

Korlátok:
Minta = ^[-\w\._,\(\)]+$
hely Az a földrajzi hely, ahol az erőforrás él sztring (kötelező)
managedBy Az erőforrást kezelő erőforrás teljes erőforrás-azonosítója. Azt jelzi, hogy ezt az erőforrást egy másik Azure-erőforrás felügyeli-e. Ha ez jelen van, a teljes módú üzembe helyezés nem törli az erőforrást, ha eltávolítják a sablonból, mivel azt egy másik erőforrás kezeli. karakterlánc
név Az erőforrás neve húr

Korlátok:
Minimális hossz = 3
Maximális hossz = 64
Minta = ^[A-Za-z0-9@.\-_ ]*$ (kötelező)
csomag Az erőforrásterv részletei. terv
kellékek Az ApplicationGroup részletes tulajdonságai ApplicationGroupProperties (kötelező)
Sku Az erőforráshoz rendelt termékváltozat (készletmegőrzési egység). termékváltozat
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése
típus Az erőforrás típusa "Microsoft.DesktopVirtualization/applicationGroups"

ApplicationGroupProperties

Név Leírás Érték
applicationGroupType Az ApplicationGroup erőforrástípusa. "Asztal"
"RemoteApp" (kötelező)
leírás Az ApplicationGroup leírása. karakterlánc
barátságosNév Az ApplicationGroup rövid neve. karakterlánc
hostPoolArmPath Az ApplicationGroup HostPool arm elérési útja. sztring (kötelező)
oboTenantId Az a bérlő, amelynek nevében az erőforrást kéri. karakterlánc
showInFeed Logikai érték, amely azt jelzi, hogy az applicationGroup megjelenik-e a hírcsatornában. Bool

ManagedServiceIdentity

Név Leírás Érték
típus A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett). "Nincs"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (kötelező)
felhasználóhozzárendeltAzonosítók Az erőforráshoz társított felhasználó által hozzárendelt identitások készlete. A userAssignedIdentities szótárkulcsok arm-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. A szótár értékei lehetnek üres objektumok ({}) a kérelmekben. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Név Leírás Érték

Terv

Név Leírás Érték
név A beszerzett harmadik féltől származó összetevő felhasználó által definiált neve. sztring (kötelező)
termék A beszerzett harmadik féltől származó összetevő. Például NewRelic. A termék leképezést készít az összetevőhöz az adatpiac előkészítésekor megadott OfferID azonosítóra. sztring (kötelező)
promócióKód A közzétevő az említett termékhez/összetevőhöz a Data Marketben kiépített promóciós kódot adta meg. karakterlánc
kiadó A megvásárolt harmadik féltől származó összetevő közzétevője. Pl. NewRelic sztring (kötelező)
verzió A kívánt termék/összetevő verziója. karakterlánc

termékazonosító (SKU)

Név Leírás Érték
kapacitás Ha az SKU támogatja a vertikális felskálázást/azt, akkor a kapacitás egészét is tartalmaznia kell. Ha az erőforrás esetében nem lehetséges a vertikális felskálázás/beskálázás, akkor ez kihagyható. Int
Család Ha a szolgáltatás különböző hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, akkor ezt itt rögzítheti. karakterlánc
név Az termékváltozat neve. Pl. P3. Ez általában egy betű+szám kód sztring (kötelező)
méret A termékváltozat mérete. Ha a névmező a réteg és más értékek kombinációja, akkor ez a különálló kód. karakterlánc
rétegez Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges. "Alapszintű"
"Ingyenes"
"Prémium"
"Standard"

TrackedResourceTags

Név Leírás Érték

Felhasználó által hozzárendelt identitás

Név Leírás Érték

Terraform (AzAPI-szolgáltató) erőforrásdefiníciója

Az applicationGroups erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

  • Erőforráscsoportok Az API verziók megváltoztatott tulajdonságainak listájáért lásd: Változásnapló.

Használati példák

Terraform minták

Alapvető példa a virtuális asztali alkalmazáscsoport üzembe helyezésére.

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

Azure-ból ellenőrzött modulok

Az alábbi Azure Verified Modules használható az erőforrástípus üzembe helyezéséhez.

Modul Leírás
Azure Virtual Desktop (AVD) alkalmazáscsoport AVM-erőforrásmodul az Azure Virtual Desktop (AVD) alkalmazáscsoporthoz

Erőforrás formátuma

Microsoft.DesktopVirtualization/applicationGroups erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.

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

Tulajdonságértékek

Microsoft.DesktopVirtualization/applicationGroups

Név Leírás Érték
identitás Az erőforráshoz rendelt felügyeltszolgáltatás-identitások. ManagedServiceIdentity
fajta A portál/eszközhasználat/stb. által használt metaadatok az azonos típusú erőforrások különböző UX-élményének megjelenítéséhez; Például az ApiApps egyfajta Microsoft.Web/sites típusú. Ha támogatott, az erőforrás-szolgáltatónak ellenőriznie és meg kell őriznie ezt az értéket. húr

Korlátok:
Minta = ^[-\w\._,\(\)]+$
hely Az a földrajzi hely, ahol az erőforrás él sztring (kötelező)
managedBy Az erőforrást kezelő erőforrás teljes erőforrás-azonosítója. Azt jelzi, hogy ezt az erőforrást egy másik Azure-erőforrás felügyeli-e. Ha ez jelen van, a teljes módú üzembe helyezés nem törli az erőforrást, ha eltávolítják a sablonból, mivel azt egy másik erőforrás kezeli. karakterlánc
név Az erőforrás neve húr

Korlátok:
Minimális hossz = 3
Maximális hossz = 64
Minta = ^[A-Za-z0-9@.\-_ ]*$ (kötelező)
csomag Az erőforrásterv részletei. terv
kellékek Az ApplicationGroup részletes tulajdonságai ApplicationGroupProperties (kötelező)
Sku Az erőforráshoz rendelt termékváltozat (készletmegőrzési egység). termékváltozat
Címkék Erőforráscímkék Címkenevek és -értékek szótára.
típus Az erőforrás típusa "Microsoft. DesktopVirtualization/applicationGroups@2026-04-01-preview"

ApplicationGroupProperties

Név Leírás Érték
applicationGroupType Az ApplicationGroup erőforrástípusa. "Asztal"
"RemoteApp" (kötelező)
leírás Az ApplicationGroup leírása. karakterlánc
barátságosNév Az ApplicationGroup rövid neve. karakterlánc
hostPoolArmPath Az ApplicationGroup HostPool arm elérési útja. sztring (kötelező)
oboTenantId Az a bérlő, amelynek nevében az erőforrást kéri. karakterlánc
showInFeed Logikai érték, amely azt jelzi, hogy az applicationGroup megjelenik-e a hírcsatornában. Bool

ManagedServiceIdentity

Név Leírás Érték
típus A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett). "Nincs"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (kötelező)
felhasználóhozzárendeltAzonosítók Az erőforráshoz társított felhasználó által hozzárendelt identitások készlete. A userAssignedIdentities szótárkulcsok arm-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. A szótár értékei lehetnek üres objektumok ({}) a kérelmekben. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Név Leírás Érték

Terv

Név Leírás Érték
név A beszerzett harmadik féltől származó összetevő felhasználó által definiált neve. sztring (kötelező)
termék A beszerzett harmadik féltől származó összetevő. Például NewRelic. A termék leképezést készít az összetevőhöz az adatpiac előkészítésekor megadott OfferID azonosítóra. sztring (kötelező)
promócióKód A közzétevő az említett termékhez/összetevőhöz a Data Marketben kiépített promóciós kódot adta meg. karakterlánc
kiadó A megvásárolt harmadik féltől származó összetevő közzétevője. Pl. NewRelic sztring (kötelező)
verzió A kívánt termék/összetevő verziója. karakterlánc

termékazonosító (SKU)

Név Leírás Érték
kapacitás Ha az SKU támogatja a vertikális felskálázást/azt, akkor a kapacitás egészét is tartalmaznia kell. Ha az erőforrás esetében nem lehetséges a vertikális felskálázás/beskálázás, akkor ez kihagyható. Int
Család Ha a szolgáltatás különböző hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, akkor ezt itt rögzítheti. karakterlánc
név Az termékváltozat neve. Pl. P3. Ez általában egy betű+szám kód sztring (kötelező)
méret A termékváltozat mérete. Ha a névmező a réteg és más értékek kombinációja, akkor ez a különálló kód. karakterlánc
rétegez Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges. "Alapszintű"
"Ingyenes"
"Prémium"
"Standard"

TrackedResourceTags

Név Leírás Érték

Felhasználó által hozzárendelt identitás

Név Leírás Érték