Microsoft. DesktopVirtualization applicationGroups 2026-03-01-preview

Bicep 리소스 정의

applicationGroups 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • Resource groups - 자원 그룹 배치 명령

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

사용 예제

Bicep 샘플

Virtual Desktop Application Group을 배포하는 기본 예입니다.

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 확인된 모듈

다음 Azure 확인된 모듈을 사용하여 이 리소스 유형을 배포할 수 있습니다.

Module Description
AVD(Azure Virtual Desktop) 애플리케이션 그룹 AVD(Azure Virtual Desktop) 애플리케이션 그룹용 AVM 리소스 모듈

Azure 빠른 시작 샘플

다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.

Bicep 파일 Description
Microsoft Entra ID 조인 사용하여 AVD를 만듭니다. 이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, 테스트 세션 호스트 및 Microsoft Entra ID 조인을 사용하여 확장과 같은 Azure Virtual Desktop 리소스를 만들 수 있습니다.

리소스 형식

Microsoft.DesktopVirtualization/applicationGroups 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

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

속성 값

Microsoft.DesktopVirtualization/applicationGroups

Name Description Value
identity 이 리소스에 할당된 관리 서비스 ID입니다. ManagedServiceIdentity
kind 포털/툴링 등에서 동일한 유형의 리소스에 대해 다양한 UX 경험을 렌더링하는 데 사용되는 메타데이터; 예를 들어, ApiApps는 일종의 Microsoft입니다. 웹사이트/사이트 유형. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. string

Constraints:
패턴 = ^[-\w\._,\(\)]+$
location 리소스가 있는 지리적 위치 string(필수)
managedBy 이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다. string
name 리소스 이름 string

Constraints:
최소 길이 = 3
최대 길이 = 64
패턴 = ^[A-Za-z0-9@.\-_ ]*$(필수)
plan 리소스 계획의 세부 정보입니다. Plan
속성 ApplicationGroup에 대한 자세한 속성 ApplicationGroupProperties (필수)
sku 이 리소스에 할당된 SKU(스톡 키핑 단위)입니다. Sku
tags 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿Tags를 참고하세요>

ApplicationGroupProperties

Name Description Value
applicationGroupType ApplicationGroup의 리소스 종류입니다. 'Desktop'
'RemoteApp'(필수)
description ApplicationGroup에 대한 설명입니다. string
friendlyName ApplicationGroup의 이름입니다. string
hostPoolArmPath ApplicationGroup의 HostPool arm 경로입니다. string(필수)
oboTenantId 리소스를 대신하여 요청되는 테넌트입니다. string
쇼인피드 applicationGroup이 피드에 표시되는지 여부를 나타내는 부울입니다. bool

ManagedServiceIdentity

Name Description Value
type 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). '없음'
'시스템 할당됨'
'시스템 할당, 사용자 할당'
'UserAssigned'(필수)
사용자 지정 ID 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft 형식의 ARM 리소스 ID입니다. ManagedIdentity/userAssignedIdentities/{identityName}. 사전 값은 요청에서 빈 개체({})일 수 있습니다. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

Plan

Name Description Value
name 조달 중인 타사 아티팩트 사용자 정의 이름입니다. string(필수)
product 조달 중인 타사 아티팩트입니다. 예: NewRelic. 제품은 데이터 시장 온보딩 시 아티팩트용으로 지정된 OfferID에 매핑됩니다. string(필수)
promotionCode publisher가 해당 제품/아티팩트에 대해 Data Market에 제공된 프로모션 코드를 제공했습니다. string
출판사 구매 중인 3자 유물의 publisher입니다. 예: NewRelic string(필수)
version 원하는 제품/아티팩트 버전입니다. string

Sku

Name Description Value
capacity SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. int
family 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. string
name SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. string(필수)
size SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. string
tier 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResource태그

Name Description Value

UserAssignedIdentity

Name Description Value

ARM 템플릿 리소스 정의

applicationGroups 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

사용 예제

Azure 빠른 시작 템플릿

다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.

템플릿 Description
Microsoft Entra ID 조인 사용하여 AVD를 만듭니다.

Azure로 배포합니다
이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, 테스트 세션 호스트 및 Microsoft Entra ID 조인을 사용하여 확장과 같은 Azure Virtual Desktop 리소스를 만들 수 있습니다.

리소스 형식

Microsoft.DesktopVirtualization/applicationGroups 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

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

속성 값

Microsoft.DesktopVirtualization/applicationGroups

Name Description Value
API버전 api 버전 '2026-03-01-미리보기'
identity 이 리소스에 할당된 관리 서비스 ID입니다. ManagedServiceIdentity
kind 포털/툴링 등에서 동일한 유형의 리소스에 대해 다양한 UX 경험을 렌더링하는 데 사용되는 메타데이터; 예를 들어, ApiApps는 일종의 Microsoft입니다. 웹사이트/사이트 유형. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. string

Constraints:
패턴 = ^[-\w\._,\(\)]+$
location 리소스가 있는 지리적 위치 string(필수)
managedBy 이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다. string
name 리소스 이름 string

Constraints:
최소 길이 = 3
최대 길이 = 64
패턴 = ^[A-Za-z0-9@.\-_ ]*$(필수)
plan 리소스 계획의 세부 정보입니다. Plan
속성 ApplicationGroup에 대한 자세한 속성 ApplicationGroupProperties (필수)
sku 이 리소스에 할당된 SKU(스톡 키핑 단위)입니다. Sku
tags 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿Tags를 참고하세요>
type 리소스 종류 'Microsoft.DesktopVirtualization/애플리케이션 그룹'

ApplicationGroupProperties

Name Description Value
applicationGroupType ApplicationGroup의 리소스 종류입니다. 'Desktop'
'RemoteApp'(필수)
description ApplicationGroup에 대한 설명입니다. string
friendlyName ApplicationGroup의 이름입니다. string
hostPoolArmPath ApplicationGroup의 HostPool arm 경로입니다. string(필수)
oboTenantId 리소스를 대신하여 요청되는 테넌트입니다. string
쇼인피드 applicationGroup이 피드에 표시되는지 여부를 나타내는 부울입니다. bool

ManagedServiceIdentity

Name Description Value
type 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). '없음'
'시스템 할당됨'
'시스템 할당, 사용자 할당'
'UserAssigned'(필수)
사용자 지정 ID 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft 형식의 ARM 리소스 ID입니다. ManagedIdentity/userAssignedIdentities/{identityName}. 사전 값은 요청에서 빈 개체({})일 수 있습니다. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

Plan

Name Description Value
name 조달 중인 타사 아티팩트 사용자 정의 이름입니다. string(필수)
product 조달 중인 타사 아티팩트입니다. 예: NewRelic. 제품은 데이터 시장 온보딩 시 아티팩트용으로 지정된 OfferID에 매핑됩니다. string(필수)
promotionCode publisher가 해당 제품/아티팩트에 대해 Data Market에 제공된 프로모션 코드를 제공했습니다. string
출판사 구매 중인 3자 유물의 publisher입니다. 예: NewRelic string(필수)
version 원하는 제품/아티팩트 버전입니다. string

Sku

Name Description Value
capacity SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. int
family 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. string
name SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. string(필수)
size SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. string
tier 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResource태그

Name Description Value

UserAssignedIdentity

Name Description Value

Terraform(AzAPI 공급자) 리소스 정의

applicationGroups 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 자원 그룹 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

사용 예제

Terraform 샘플

Virtual Desktop Application Group을 배포하는 기본 예입니다.

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 확인된 모듈

다음 Azure 확인된 모듈을 사용하여 이 리소스 유형을 배포할 수 있습니다.

Module Description
AVD(Azure Virtual Desktop) 애플리케이션 그룹 AVD(Azure Virtual Desktop) 애플리케이션 그룹용 AVM 리소스 모듈

리소스 형식

Microsoft.DesktopVirtualization/applicationGroups 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

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

속성 값

Microsoft.DesktopVirtualization/applicationGroups

Name Description Value
identity 이 리소스에 할당된 관리 서비스 ID입니다. ManagedServiceIdentity
kind 포털/툴링 등에서 동일한 유형의 리소스에 대해 다양한 UX 경험을 렌더링하는 데 사용되는 메타데이터; 예를 들어, ApiApps는 일종의 Microsoft입니다. 웹사이트/사이트 유형. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. string

Constraints:
패턴 = ^[-\w\._,\(\)]+$
location 리소스가 있는 지리적 위치 string(필수)
managedBy 이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다. string
name 리소스 이름 string

Constraints:
최소 길이 = 3
최대 길이 = 64
패턴 = ^[A-Za-z0-9@.\-_ ]*$(필수)
plan 리소스 계획의 세부 정보입니다. Plan
속성 ApplicationGroup에 대한 자세한 속성 ApplicationGroupProperties (필수)
sku 이 리소스에 할당된 SKU(스톡 키핑 단위)입니다. Sku
tags 리소스 태그 태그 이름 및 값의 사전입니다.
type 리소스 종류 "Microsoft. DesktopVirtualization/applicationGroups@2026-03-01-preview"

ApplicationGroupProperties

Name Description Value
applicationGroupType ApplicationGroup의 리소스 종류입니다. 'Desktop'
'RemoteApp'(필수)
description ApplicationGroup에 대한 설명입니다. string
friendlyName ApplicationGroup의 이름입니다. string
hostPoolArmPath ApplicationGroup의 HostPool arm 경로입니다. string(필수)
oboTenantId 리소스를 대신하여 요청되는 테넌트입니다. string
쇼인피드 applicationGroup이 피드에 표시되는지 여부를 나타내는 부울입니다. bool

ManagedServiceIdentity

Name Description Value
type 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). '없음'
'시스템 할당됨'
'시스템 할당, 사용자 할당'
'UserAssigned'(필수)
사용자 지정 ID 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft 형식의 ARM 리소스 ID입니다. ManagedIdentity/userAssignedIdentities/{identityName}. 사전 값은 요청에서 빈 개체({})일 수 있습니다. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

Plan

Name Description Value
name 조달 중인 타사 아티팩트 사용자 정의 이름입니다. string(필수)
product 조달 중인 타사 아티팩트입니다. 예: NewRelic. 제품은 데이터 시장 온보딩 시 아티팩트용으로 지정된 OfferID에 매핑됩니다. string(필수)
promotionCode publisher가 해당 제품/아티팩트에 대해 Data Market에 제공된 프로모션 코드를 제공했습니다. string
출판사 구매 중인 3자 유물의 publisher입니다. 예: NewRelic string(필수)
version 원하는 제품/아티팩트 버전입니다. string

Sku

Name Description Value
capacity SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. int
family 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. string
name SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. string(필수)
size SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. string
tier 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResource태그

Name Description Value

UserAssignedIdentity

Name Description Value