Aplikasi Microsoft.DesktopVirtualizationGroups

Definisi sumber daya Bicep

Jenis sumber daya applicationGroups dapat disebarkan dengan operasi yang menargetkan:

  • Grup sumber daya - Lihat perintah penyebaran grup sumber daya

Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.

Contoh Penggunaan

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

Nilai Properti

Microsoft.DesktopVirtualization/applicationGroups (Kelompok Aplikasi Virtualisasi Desktop)

Nama Deskripsi Nilai
identitas Identitas layanan terkelola yang ditetapkan ke sumber daya ini. managedServiceIdentity
jenis Metadata yang digunakan oleh portal/peralatan/dll untuk merender pengalaman UX yang berbeda untuk sumber daya dengan jenis yang sama; misalnya ApiApps adalah jenis Microsoft.Web/sites. Jika didukung, penyedia sumber daya harus memvalidasi dan mempertahankan nilai ini. tali

Kendala:
Pola = ^[-\w\._,\(\)]+$
lokasi Lokasi geografis tempat sumber daya berada string (diperlukan)
dikelola oleh 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
Nama Nama sumber daya tali

Kendala:
Panjang min = 3
Panjang maksimum = 64
Pola = ^[A-Za-z0-9@.\-_ ]*$ (diperlukan)
rencana Detail paket sumber daya. Paket
Properti 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

Nama Deskripsi Nilai
applicationGroupType Jenis Sumber Daya ApplicationGroup. 'Desktop'
'RemoteApp' (diperlukan)
deskripsi Deskripsi ApplicationGroup. string
nama ramah 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

Identitas Layanan Terkelola

Nama Deskripsi Nilai
jenis Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan). 'Tidak Ada'
'SistemDitetapkan'
'SistemDitetapkan,Pengguna Ditetapkan'
'UserAssigned' (diperlukan)
identitasYangDitetapkanPengguna 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

Nama Deskripsi Nilai

Rencana

Nama Deskripsi Nilai
Nama Nama yang ditentukan pengguna dari Artefak Pihak ke-3 yang sedang diakui. string (diperlukan)
hasil 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)
Kode promosi Penerbit menyediakan kode promosi seperti yang disediakan di Pasar Data untuk produk/artefak tersebut. string
penerbit Penerbit Artefak Pihak ke-3 yang sedang dibeli. Misalnya NewRelic string (diperlukan)
versi Versi produk/artefak yang diinginkan. string

SKU (Kode Barang)

Nama Deskripsi 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
keluarga Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. string
Nama Nama SKU. Misalnya P3. Biasanya kode huruf+angka string (diperlukan)
tingginya 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. 'Dasar'
'Gratis'
'Premium'
'Standar'

TrackedResourceTags

Nama Deskripsi Nilai

IdentitasDitugaskanPengguna

Nama Deskripsi Nilai

Definisi sumber daya templat ARM

Jenis sumber daya applicationGroups dapat disebarkan dengan operasi yang menargetkan:

Contoh Penggunaan

Templat Quickstart Azure

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

Templat Deskripsi
Membuat AVD dengan Microsoft Entra ID Join

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

Nilai Properti

Microsoft.DesktopVirtualization/applicationGroups (Kelompok Aplikasi Virtualisasi Desktop)

Nama Deskripsi Nilai
apiVersi Versi api '2026-04-01-pratinjau'
identitas Identitas layanan terkelola yang ditetapkan ke sumber daya ini. managedServiceIdentity
jenis Metadata yang digunakan oleh portal/peralatan/dll untuk merender pengalaman UX yang berbeda untuk sumber daya dengan jenis yang sama; misalnya ApiApps adalah jenis Microsoft.Web/sites. Jika didukung, penyedia sumber daya harus memvalidasi dan mempertahankan nilai ini. tali

Kendala:
Pola = ^[-\w\._,\(\)]+$
lokasi Lokasi geografis tempat sumber daya berada string (diperlukan)
dikelola oleh 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
Nama Nama sumber daya tali

Kendala:
Panjang min = 3
Panjang maksimum = 64
Pola = ^[A-Za-z0-9@.\-_ ]*$ (diperlukan)
rencana Detail paket sumber daya. Paket
Properti 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

Nama Deskripsi Nilai
applicationGroupType Jenis Sumber Daya ApplicationGroup. 'Desktop'
'RemoteApp' (diperlukan)
deskripsi Deskripsi ApplicationGroup. string
nama ramah 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

Identitas Layanan Terkelola

Nama Deskripsi Nilai
jenis Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan). 'Tidak Ada'
'SistemDitetapkan'
'SistemDitetapkan,Pengguna Ditetapkan'
'UserAssigned' (diperlukan)
identitasYangDitetapkanPengguna 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

Nama Deskripsi Nilai

Rencana

Nama Deskripsi Nilai
Nama Nama yang ditentukan pengguna dari Artefak Pihak ke-3 yang sedang diakui. string (diperlukan)
hasil 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)
Kode promosi Penerbit menyediakan kode promosi seperti yang disediakan di Pasar Data untuk produk/artefak tersebut. string
penerbit Penerbit Artefak Pihak ke-3 yang sedang dibeli. Misalnya NewRelic string (diperlukan)
versi Versi produk/artefak yang diinginkan. string

SKU (Kode Barang)

Nama Deskripsi 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
keluarga Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. string
Nama Nama SKU. Misalnya P3. Biasanya kode huruf+angka string (diperlukan)
tingginya 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. 'Dasar'
'Gratis'
'Premium'
'Standar'

TrackedResourceTags

Nama Deskripsi Nilai

IdentitasDitugaskanPengguna

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

Nilai Properti

Microsoft.DesktopVirtualization/applicationGroups (Kelompok Aplikasi Virtualisasi Desktop)

Nama Deskripsi Nilai
identitas Identitas layanan terkelola yang ditetapkan ke sumber daya ini. managedServiceIdentity
jenis Metadata yang digunakan oleh portal/peralatan/dll untuk merender pengalaman UX yang berbeda untuk sumber daya dengan jenis yang sama; misalnya ApiApps adalah jenis Microsoft.Web/sites. Jika didukung, penyedia sumber daya harus memvalidasi dan mempertahankan nilai ini. tali

Kendala:
Pola = ^[-\w\._,\(\)]+$
lokasi Lokasi geografis tempat sumber daya berada string (diperlukan)
dikelola oleh 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
Nama Nama sumber daya tali

Kendala:
Panjang min = 3
Panjang maksimum = 64
Pola = ^[A-Za-z0-9@.\-_ ]*$ (diperlukan)
rencana Detail paket sumber daya. Paket
Properti 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-04-01-preview"

ApplicationGroupProperties

Nama Deskripsi Nilai
applicationGroupType Jenis Sumber Daya ApplicationGroup. 'Desktop'
'RemoteApp' (diperlukan)
deskripsi Deskripsi ApplicationGroup. string
nama ramah 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

Identitas Layanan Terkelola

Nama Deskripsi Nilai
jenis Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan). 'Tidak Ada'
'SistemDitetapkan'
'SistemDitetapkan,Pengguna Ditetapkan'
'UserAssigned' (diperlukan)
identitasYangDitetapkanPengguna 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

Nama Deskripsi Nilai

Rencana

Nama Deskripsi Nilai
Nama Nama yang ditentukan pengguna dari Artefak Pihak ke-3 yang sedang diakui. string (diperlukan)
hasil 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)
Kode promosi Penerbit menyediakan kode promosi seperti yang disediakan di Pasar Data untuk produk/artefak tersebut. string
penerbit Penerbit Artefak Pihak ke-3 yang sedang dibeli. Misalnya NewRelic string (diperlukan)
versi Versi produk/artefak yang diinginkan. string

SKU (Kode Barang)

Nama Deskripsi 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
keluarga Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. string
Nama Nama SKU. Misalnya P3. Biasanya kode huruf+angka string (diperlukan)
tingginya 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. 'Dasar'
'Gratis'
'Premium'
'Standar'

TrackedResourceTags

Nama Deskripsi Nilai

IdentitasDitugaskanPengguna

Nama Deskripsi Nilai