Microsoft. DesktopVirtualisasi aplikasiGrup 2026-03-01-preview

Definisi sumber daya Bicep

Jenis sumber daya applicationGroups dapat disebarkan dengan operasi yang menargetkan:

Untuk daftar properti yang diubah di setiap versi API, lihat catatan perubahan.

Contoh Penggunaan

Contoh Bicep

Contoh dasar penyebaran Grup Aplikasi Desktop Virtual.

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

Modul Terverifikasi Azure

Modul Terverifikasi Azure berikut dapat digunakan untuk menyebarkan jenis sumber daya ini.

Modul Description
Grup Aplikasi Azure Virtual Desktop (AVD) Modul Sumber Daya AVM untuk Grup Aplikasi Azure Virtual Desktop (AVD)

Sampel Mulai Cepat Azure

Templat Mulai Cepat Azure berikut ini berisi sampel Bicep untuk menyebarkan jenis sumber daya ini.

File Bisep Description
Membuat AVD dengan Microsoft Entra ID Join Templat ini memungkinkan Anda membuat sumber daya Azure Virtual Desktop seperti kumpulan host, grup aplikasi, ruang kerja, host sesi pengujian, dan ekstensinya dengan gabungan ID Microsoft Entra

Format sumber daya

Untuk membuat sumber daya Microsoft.DesktopVirtualization/applicationGroups, tambahkan Bicep berikut ke templat Anda.

resource symbolicname 'Microsoft.DesktopVirtualization/applicationGroups@2026-03-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'
  }
}

Nilai Properti

Microsoft.DesktopVirtualization/applicationGroups

Name Description Nilai
identitas Identitas layanan terkelola yang ditetapkan ke sumber daya ini. managedServiceIdentity
kind Metadata yang digunakan oleh portal/tooling/dll untuk merender pengalaman UX yang berbeda untuk sumber daya dengan jenis yang sama; misalnya ApiApps adalah sejenis Microsoft. Jenis web/situs. Jika didukung, penyedia sumber daya harus memvalidasi dan mempertahankan nilai ini. string

Kendala:
Pola = ^[-\w\._,\(\)]+$
lokasi Lokasi geografis tempat sumber daya berada string (diperlukan)
managedBy ID sumber daya yang sepenuhnya memenuhi syarat dari sumber daya yang mengelola sumber daya ini. Menunjukkan apakah sumber daya ini dikelola oleh sumber daya Azure lain. Jika ada, penyebaran mode lengkap tidak akan menghapus sumber daya jika dihapus dari templat karena dikelola oleh sumber daya lain. string
name Nama sumber daya string

Kendala:
Panjang min = 3
Panjang maksimum = 64
Pola = ^[A-Za-z0-9@.\-_ ]*$ (diperlukan)
plan Detail paket sumber daya. Rencana
properties Properti terperinci untuk ApplicationGroup applicationGroupProperties (diperlukan)
sku SKU (Stock Keeping Unit) yang ditetapkan ke sumber daya ini. Sku
tags Tag sumber daya Kamus nama dan nilai tag. Lihat Tag dalam templat

ApplicationGroupProperties

Name Description Nilai
applicationGroupType Jenis Sumber Daya ApplicationGroup. 'Desktop'
'RemoteApp' (diperlukan)
description Deskripsi ApplicationGroup. string
friendlyName Nama yang mudah diingat dari ApplicationGroup. string
hostPoolArmPath Jalur arm HostPool dari ApplicationGroup. string (diperlukan)
oboTenantId Penyewa yang diminta sumber daya atas namanya. string
showInFeed Boolean mewakili apakah applicationGroup ditampilkan di umpan. bool

ManagedServiceIdentity

Name Description Nilai
jenis Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan). 'Tidak Ada'
'SistemDitetapkan'
'SistemDitetapkan,Pengguna Ditetapkan'
'UserAssigned' (diperlukan)
userAssignedIdentities Kumpulan identitas yang ditetapkan pengguna yang terkait dengan sumber daya. Kunci kamus userAssignedIdentities akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Nilai kamus dapat berupa objek kosong ({}) dalam permintaan. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Nilai

Plan

Name Description Nilai
name Nama yang ditentukan pengguna dari Artefak Pihak ke-3 yang sedang diakui. string (diperlukan)
product Artefak Pihak ke-3 yang sedang dijadikan pengadaan. Misalnya NewRelic. Peta produk ke OfferID yang ditentukan untuk artefak pada saat onboarding Data Market. string (diperlukan)
promotionCode Publisher memberikan kode promosi sebagaimana disediakan di Data Market untuk produk/artefak tersebut. string
penerbit publisher Artefak Pihak ke-3 yang sedang dibeli. Misalnya NewRelic string (diperlukan)
versi Versi produk/artefak yang diinginkan. string

Sku

Name Description Nilai
kapasitas Jika SKU mendukung peluasan skala/masuk, bilangan bulat kapasitas harus disertakan. Jika peluasan/masuk skala tidak dimungkinkan untuk sumber daya, ini dapat dihilangkan. int
family Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. string
name Nama SKU. Misalnya P3. Biasanya kode huruf+angka string (diperlukan)
ukuran Ukuran SKU. Ketika bidang nama adalah kombinasi tingkatan dan beberapa nilai lainnya, ini akan menjadi kode mandiri. string
tier Bidang ini diperlukan untuk diimplementasikan oleh Penyedia Sumber Jika layanan memiliki lebih dari satu tingkat, tetapi tidak diperlukan pada PUT. 'Basic'
'Gratis'
'Premium'
'Standard'

TrackedResourceTags

Name Description Nilai

UserAssignedIdentity

Name Description Nilai

Definisi sumber daya templat ARM

Jenis sumber daya applicationGroups dapat disebarkan dengan operasi yang menargetkan:

Contoh Penggunaan

Templat Pemulaan Cepat Azure

Templat Mulai Cepat Azure berikut ini menyebarkan jenis sumber daya ini.

Templat Description
Membuat AVD dengan Microsoft Entra ID Join

Terapkan ke Azure
Templat ini memungkinkan Anda membuat sumber daya Azure Virtual Desktop seperti kumpulan host, grup aplikasi, ruang kerja, host sesi pengujian, dan ekstensinya dengan gabungan ID Microsoft Entra

Format sumber daya

Untuk membuat sumber daya Microsoft.DesktopVirtualization/applicationGroups, tambahkan JSON berikut ke templat Anda.

{
  "type": "Microsoft.DesktopVirtualization/applicationGroups",
  "apiVersion": "2026-03-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"
  }
}

Nilai Properti

Microsoft.DesktopVirtualization/applicationGroups

Name Description Nilai
apiVersion Versi api '2026-03-01-pratinjau'
identitas Identitas layanan terkelola yang ditetapkan ke sumber daya ini. managedServiceIdentity
kind Metadata yang digunakan oleh portal/tooling/dll untuk merender pengalaman UX yang berbeda untuk sumber daya dengan jenis yang sama; misalnya ApiApps adalah sejenis Microsoft. Jenis web/situs. Jika didukung, penyedia sumber daya harus memvalidasi dan mempertahankan nilai ini. string

Kendala:
Pola = ^[-\w\._,\(\)]+$
lokasi Lokasi geografis tempat sumber daya berada string (diperlukan)
managedBy ID sumber daya yang sepenuhnya memenuhi syarat dari sumber daya yang mengelola sumber daya ini. Menunjukkan apakah sumber daya ini dikelola oleh sumber daya Azure lain. Jika ada, penyebaran mode lengkap tidak akan menghapus sumber daya jika dihapus dari templat karena dikelola oleh sumber daya lain. string
name Nama sumber daya string

Kendala:
Panjang min = 3
Panjang maksimum = 64
Pola = ^[A-Za-z0-9@.\-_ ]*$ (diperlukan)
plan Detail paket sumber daya. Rencana
properties Properti terperinci untuk ApplicationGroup applicationGroupProperties (diperlukan)
sku SKU (Stock Keeping Unit) yang ditetapkan ke sumber daya ini. Sku
tags Tag sumber daya Kamus nama dan nilai tag. Lihat Tag dalam templat
jenis Jenis sumber daya 'Microsoft.DesktopVirtualization/applicationGroups'

ApplicationGroupProperties

Name Description Nilai
applicationGroupType Jenis Sumber Daya ApplicationGroup. 'Desktop'
'RemoteApp' (diperlukan)
description Deskripsi ApplicationGroup. string
friendlyName Nama yang mudah diingat dari ApplicationGroup. string
hostPoolArmPath Jalur arm HostPool dari ApplicationGroup. string (diperlukan)
oboTenantId Penyewa yang diminta sumber daya atas namanya. string
showInFeed Boolean mewakili apakah applicationGroup ditampilkan di umpan. bool

ManagedServiceIdentity

Name Description Nilai
jenis Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan). 'Tidak Ada'
'SistemDitetapkan'
'SistemDitetapkan,Pengguna Ditetapkan'
'UserAssigned' (diperlukan)
userAssignedIdentities Kumpulan identitas yang ditetapkan pengguna yang terkait dengan sumber daya. Kunci kamus userAssignedIdentities akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Nilai kamus dapat berupa objek kosong ({}) dalam permintaan. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Nilai

Plan

Name Description Nilai
name Nama yang ditentukan pengguna dari Artefak Pihak ke-3 yang sedang diakui. string (diperlukan)
product Artefak Pihak ke-3 yang sedang dijadikan pengadaan. Misalnya NewRelic. Peta produk ke OfferID yang ditentukan untuk artefak pada saat onboarding Data Market. string (diperlukan)
promotionCode Publisher memberikan kode promosi sebagaimana disediakan di Data Market untuk produk/artefak tersebut. string
penerbit publisher Artefak Pihak ke-3 yang sedang dibeli. Misalnya NewRelic string (diperlukan)
versi Versi produk/artefak yang diinginkan. string

Sku

Name Description Nilai
kapasitas Jika SKU mendukung peluasan skala/masuk, bilangan bulat kapasitas harus disertakan. Jika peluasan/masuk skala tidak dimungkinkan untuk sumber daya, ini dapat dihilangkan. int
family Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. string
name Nama SKU. Misalnya P3. Biasanya kode huruf+angka string (diperlukan)
ukuran Ukuran SKU. Ketika bidang nama adalah kombinasi tingkatan dan beberapa nilai lainnya, ini akan menjadi kode mandiri. string
tier Bidang ini diperlukan untuk diimplementasikan oleh Penyedia Sumber Jika layanan memiliki lebih dari satu tingkat, tetapi tidak diperlukan pada PUT. 'Basic'
'Gratis'
'Premium'
'Standard'

TrackedResourceTags

Name Description Nilai

UserAssignedIdentity

Name Description Nilai

Definisi sumber daya Terraform (penyedia AzAPI)

Jenis sumber daya applicationGroups dapat disebarkan dengan operasi yang menargetkan:

  • Grup sumber daya Untuk daftar properti yang diubah di setiap versi API, lihat log perubahan.

Contoh Penggunaan

Sampel Terraform

Contoh dasar penyebaran Grup Aplikasi Desktop Virtual.

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

Modul Terverifikasi Azure

Modul Terverifikasi Azure berikut dapat digunakan untuk menyebarkan jenis sumber daya ini.

Modul Description
Grup Aplikasi Azure Virtual Desktop (AVD) Modul Sumber Daya AVM untuk Grup Aplikasi Azure Virtual Desktop (AVD)

Format sumber daya

Untuk membuat sumber daya Microsoft.DesktopVirtualization/applicationGroups, tambahkan Terraform berikut ke templat Anda.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DesktopVirtualization/applicationGroups@2026-03-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"
    }
  }
}

Nilai Properti

Microsoft.DesktopVirtualization/applicationGroups

Name Description Nilai
identitas Identitas layanan terkelola yang ditetapkan ke sumber daya ini. managedServiceIdentity
kind Metadata yang digunakan oleh portal/tooling/dll untuk merender pengalaman UX yang berbeda untuk sumber daya dengan jenis yang sama; misalnya ApiApps adalah sejenis Microsoft. Jenis web/situs. Jika didukung, penyedia sumber daya harus memvalidasi dan mempertahankan nilai ini. string

Kendala:
Pola = ^[-\w\._,\(\)]+$
lokasi Lokasi geografis tempat sumber daya berada string (diperlukan)
managedBy ID sumber daya yang sepenuhnya memenuhi syarat dari sumber daya yang mengelola sumber daya ini. Menunjukkan apakah sumber daya ini dikelola oleh sumber daya Azure lain. Jika ada, penyebaran mode lengkap tidak akan menghapus sumber daya jika dihapus dari templat karena dikelola oleh sumber daya lain. string
name Nama sumber daya string

Kendala:
Panjang min = 3
Panjang maksimum = 64
Pola = ^[A-Za-z0-9@.\-_ ]*$ (diperlukan)
plan Detail paket sumber daya. Rencana
properties Properti terperinci untuk ApplicationGroup applicationGroupProperties (diperlukan)
sku SKU (Stock Keeping Unit) yang ditetapkan ke sumber daya ini. Sku
tags Tag sumber daya Kamus nama dan nilai tag.
jenis Jenis sumber daya "Microsoft. DesktopVirtualization/applicationGroups@2026-03-01-preview"

ApplicationGroupProperties

Name Description Nilai
applicationGroupType Jenis Sumber Daya ApplicationGroup. 'Desktop'
'RemoteApp' (diperlukan)
description Deskripsi ApplicationGroup. string
friendlyName Nama yang mudah diingat dari ApplicationGroup. string
hostPoolArmPath Jalur arm HostPool dari ApplicationGroup. string (diperlukan)
oboTenantId Penyewa yang diminta sumber daya atas namanya. string
showInFeed Boolean mewakili apakah applicationGroup ditampilkan di umpan. bool

ManagedServiceIdentity

Name Description Nilai
jenis Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan). 'Tidak Ada'
'SistemDitetapkan'
'SistemDitetapkan,Pengguna Ditetapkan'
'UserAssigned' (diperlukan)
userAssignedIdentities Kumpulan identitas yang ditetapkan pengguna yang terkait dengan sumber daya. Kunci kamus userAssignedIdentities akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Nilai kamus dapat berupa objek kosong ({}) dalam permintaan. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Nilai

Plan

Name Description Nilai
name Nama yang ditentukan pengguna dari Artefak Pihak ke-3 yang sedang diakui. string (diperlukan)
product Artefak Pihak ke-3 yang sedang dijadikan pengadaan. Misalnya NewRelic. Peta produk ke OfferID yang ditentukan untuk artefak pada saat onboarding Data Market. string (diperlukan)
promotionCode Publisher memberikan kode promosi sebagaimana disediakan di Data Market untuk produk/artefak tersebut. string
penerbit publisher Artefak Pihak ke-3 yang sedang dibeli. Misalnya NewRelic string (diperlukan)
versi Versi produk/artefak yang diinginkan. string

Sku

Name Description Nilai
kapasitas Jika SKU mendukung peluasan skala/masuk, bilangan bulat kapasitas harus disertakan. Jika peluasan/masuk skala tidak dimungkinkan untuk sumber daya, ini dapat dihilangkan. int
family Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. string
name Nama SKU. Misalnya P3. Biasanya kode huruf+angka string (diperlukan)
ukuran Ukuran SKU. Ketika bidang nama adalah kombinasi tingkatan dan beberapa nilai lainnya, ini akan menjadi kode mandiri. string
tier Bidang ini diperlukan untuk diimplementasikan oleh Penyedia Sumber Jika layanan memiliki lebih dari satu tingkat, tetapi tidak diperlukan pada PUT. 'Basic'
'Gratis'
'Premium'
'Standard'

TrackedResourceTags

Name Description Nilai

UserAssignedIdentity

Name Description Nilai