- Latest
- 2026-04-01-미리보기
- 2026-03-01-미리보기
- 2026-01-01-미리보기
- 2025-11-01-preview
- 2025-10-10
- 2025-09-01-미리보기
- 2025-08-01-preview
- 2025-04-01-preview
- 2025-03-01-preview
- 2024-11-01-preview
- 2024-08-08-미리보기
- 2024-04-08-미리보기
- 2024-04-03
- 2024-03-06-미리보기
- 2024-01-16-미리보기
- 2023-11-01-preview
- 2023-10-04-미리보기
- 2023-09-05
- 2022-10-14-미리보기
- 2022-09-09
- 2022-04-01-preview
- 2022-02-10-미리보기
- 2021-09-03-미리보기
- 2021-07-12
- 2021-04-01-미리 보기
- 2021-03-09-미리보기
- 2021-02-01-preview
- 2021-01-14-미리보기
- 2020-11-10-미리보기
- 2020-11-02-미리보기
- 2020-10-19-미리보기
- 2020-09-21-미리보기
- 2019-12-10-미리보기
- 2019-09-24-미리보기
- 2019-01-23-미리보기
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 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 어를 참조하세요. 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
Azure 빠른 시작 템플릿
다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.
| 템플릿 | Description |
|---|---|
|
Microsoft Entra ID 조인 사용하여 AVD를 만듭니다. |
이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, 테스트 세션 호스트 및 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 |
|---|