Microsoft.DesktopVirtualization 응용 프로그램 그룹

Bicep 리소스 정의

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

각 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 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.

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

Azure 빠른 시작 샘플

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

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

리소스 형식

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

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

속성 값

Microsoft.DesktopVirtualization/애플리케이션그룹

이름 묘사 값
신원 이 리소스에 할당된 관리 서비스 ID입니다. ManagedServiceIdentity
종류 포털/도구/등에서 동일한 형식의 리소스에 대해 다른 UX 환경을 렌더링하는 데 사용하는 메타데이터 예를 들어 ApiApps는 일종의 Microsoft.Web/sites 유형입니다. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. 문자열

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

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

ApplicationGroupProperties

이름 묘사 값
applicationGroupType ApplicationGroup의 리소스 종류입니다. '데스크톱'
'RemoteApp'(필수)
묘사 ApplicationGroup에 대한 설명입니다. 문자열
친근한 이름 ApplicationGroup의 이름입니다. 문자열
hostPoolArmPath ApplicationGroup의 HostPool arm 경로입니다. string(필수)
oboTenantId 리소스를 대신하여 요청되는 테넌트입니다. 문자열
쇼인피드 applicationGroup이 피드에 표시되는지 여부를 나타내는 부울입니다. 부울

ManagedServiceIdentity (관리형 서비스 ID)

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

ManagedServiceIdentityUserAssignedIdentities

이름 묘사 값

계획

이름 묘사 값
이름 조달 중인 타사 아티팩트 사용자 정의 이름입니다. string(필수)
제품 조달 중인 타사 아티팩트입니다. 예: NewRelic. 제품은 데이터 시장 온보딩 시 아티팩트용으로 지정된 OfferID에 매핑됩니다. string(필수)
프로모션 코드 게시자는 데이터 마켓에서 프로비전된 제품/아티팩트를 위한 프로모션 코드를 제공했습니다. 문자열
게시자 구입 중인 타사 아티팩트 게시자입니다. 예: NewRelic string(필수)
버전 원하는 제품/아티팩트 버전입니다. 문자열

SKU (재고 관리 코드)

이름 묘사 값
용량 SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. 정수 (int)
가족 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. 문자열
이름 SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. string(필수)
크기 SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. 문자열
계층 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. '기본'
'무료'
'프리미엄'
'표준'

TrackedResource태그

이름 묘사 값

사용자 할당 ID

이름 묘사 값

ARM 템플릿 리소스 정의

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

사용 예제

Azure 빠른 시작 템플릿

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

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

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

리소스 형식

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

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

속성 값

Microsoft.DesktopVirtualization/애플리케이션그룹

이름 묘사 값
API버전 api 버전 '2026-04-01-미리보기
신원 이 리소스에 할당된 관리 서비스 ID입니다. ManagedServiceIdentity
종류 포털/도구/등에서 동일한 형식의 리소스에 대해 다른 UX 환경을 렌더링하는 데 사용하는 메타데이터 예를 들어 ApiApps는 일종의 Microsoft.Web/sites 유형입니다. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. 문자열

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

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

ApplicationGroupProperties

이름 묘사 값
applicationGroupType ApplicationGroup의 리소스 종류입니다. '데스크톱'
'RemoteApp'(필수)
묘사 ApplicationGroup에 대한 설명입니다. 문자열
친근한 이름 ApplicationGroup의 이름입니다. 문자열
hostPoolArmPath ApplicationGroup의 HostPool arm 경로입니다. string(필수)
oboTenantId 리소스를 대신하여 요청되는 테넌트입니다. 문자열
쇼인피드 applicationGroup이 피드에 표시되는지 여부를 나타내는 부울입니다. 부울

ManagedServiceIdentity (관리형 서비스 ID)

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

ManagedServiceIdentityUserAssignedIdentities

이름 묘사 값

계획

이름 묘사 값
이름 조달 중인 타사 아티팩트 사용자 정의 이름입니다. string(필수)
제품 조달 중인 타사 아티팩트입니다. 예: NewRelic. 제품은 데이터 시장 온보딩 시 아티팩트용으로 지정된 OfferID에 매핑됩니다. string(필수)
프로모션 코드 게시자는 데이터 마켓에서 프로비전된 제품/아티팩트를 위한 프로모션 코드를 제공했습니다. 문자열
게시자 구입 중인 타사 아티팩트 게시자입니다. 예: NewRelic string(필수)
버전 원하는 제품/아티팩트 버전입니다. 문자열

SKU (재고 관리 코드)

이름 묘사 값
용량 SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. 정수 (int)
가족 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. 문자열
이름 SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. string(필수)
크기 SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. 문자열
계층 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. '기본'
'무료'
'프리미엄'
'표준'

TrackedResource태그

이름 묘사 값

사용자 할당 ID

이름 묘사 값

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 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.

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

리소스 형식

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

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

속성 값

Microsoft.DesktopVirtualization/애플리케이션그룹

이름 묘사 값
신원 이 리소스에 할당된 관리 서비스 ID입니다. ManagedServiceIdentity
종류 포털/도구/등에서 동일한 형식의 리소스에 대해 다른 UX 환경을 렌더링하는 데 사용하는 메타데이터 예를 들어 ApiApps는 일종의 Microsoft.Web/sites 유형입니다. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. 문자열

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

제약 조건:
최소 길이 = 3
최대 길이 = 64
패턴 = ^[A-Za-z0-9@.\-_ ]*$(필수)
계획 리소스 계획의 세부 정보입니다. 계획
속성 ApplicationGroup에 대한 자세한 속성 ApplicationGroupProperties (필수)
SKU (재고 관리 코드) 이 리소스에 할당된 SKU(스톡 키핑 단위)입니다. 스쿠
태그 리소스 태그 태그 이름 및 값의 사전입니다.
형 리소스 종류 "Microsoft. DesktopVirtualization/applicationGroups@2026-04-01-preview"

ApplicationGroupProperties

이름 묘사 값
applicationGroupType ApplicationGroup의 리소스 종류입니다. '데스크톱'
'RemoteApp'(필수)
묘사 ApplicationGroup에 대한 설명입니다. 문자열
친근한 이름 ApplicationGroup의 이름입니다. 문자열
hostPoolArmPath ApplicationGroup의 HostPool arm 경로입니다. string(필수)
oboTenantId 리소스를 대신하여 요청되는 테넌트입니다. 문자열
쇼인피드 applicationGroup이 피드에 표시되는지 여부를 나타내는 부울입니다. 부울

ManagedServiceIdentity (관리형 서비스 ID)

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

ManagedServiceIdentityUserAssignedIdentities

이름 묘사 값

계획

이름 묘사 값
이름 조달 중인 타사 아티팩트 사용자 정의 이름입니다. string(필수)
제품 조달 중인 타사 아티팩트입니다. 예: NewRelic. 제품은 데이터 시장 온보딩 시 아티팩트용으로 지정된 OfferID에 매핑됩니다. string(필수)
프로모션 코드 게시자는 데이터 마켓에서 프로비전된 제품/아티팩트를 위한 프로모션 코드를 제공했습니다. 문자열
게시자 구입 중인 타사 아티팩트 게시자입니다. 예: NewRelic string(필수)
버전 원하는 제품/아티팩트 버전입니다. 문자열

SKU (재고 관리 코드)

이름 묘사 값
용량 SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. 정수 (int)
가족 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. 문자열
이름 SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. string(필수)
크기 SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. 문자열
계층 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. '기본'
'무료'
'프리미엄'
'표준'

TrackedResource태그

이름 묘사 값

사용자 할당 ID

이름 묘사 값