Microsoft.DesktopAplikacja do wirtualizacjiGrupy

Definicja zasobu Bicep

Typ zasobu applicationGroups można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Przykłady użycia

Przykłady Bicep

Podstawowy przykład wdrażania grupy aplikacji pulpitu wirtualnego.

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

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
grupa aplikacji usługi Azure Virtual Desktop (AVD) Moduł zasobów AVM dla grupy aplikacji usługi Azure Virtual Desktop (AVD)

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
tworzy usługę AVD przy użyciu dołączania do identyfikatora entra firmy Microsoft Ten szablon umożliwia tworzenie zasobów usługi Azure Virtual Desktop, takich jak pula hostów, grupa aplikacji, obszar roboczy, host sesji testowej i jego rozszerzenia za pomocą dołączania identyfikatora Entra firmy Microsoft

Format zasobu

Aby utworzyć zasób Microsoft.DesktopVirtualization/applicationGroups, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

Microsoft.DesktopVirtualization/applicationGroups

Nazwa Opis Wartość
tożsamość Tożsamości usługi zarządzanej przypisane do tego zasobu. ManagedServiceIdentity (tożsamość usługi)
rodzaj Metadane używane przez portal/narzędzia/itp. do renderowania różnych środowisk środowiska użytkownika dla zasobów tego samego typu; Np. ApiApps to rodzaj typu Microsoft.Web/sites. Jeśli jest obsługiwana, dostawca zasobów musi zweryfikować i utrwalić tę wartość. struna

Ograniczenia:
Wzorzec = ^[-\w\._,\(\)]+$
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
zarządzanePrzez W pełni kwalifikowany identyfikator zasobu, który zarządza tym zasobem. Wskazuje, czy ten zasób jest zarządzany przez inny zasób platformy Azure. Jeśli jest to obecne, wdrożenie trybu pełnego nie spowoduje usunięcia zasobu, jeśli zostanie usunięty z szablonu, ponieważ jest on zarządzany przez inny zasób. ciąg
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 3
Maksymalna długość = 64
Wzorzec = ^[A-Za-z0-9@.\-_ ]*$ (wymagane)
plan Szczegóły planu zasobów. planu
Właściwości Szczegółowe właściwości grupy aplikacji ApplicationGroupProperties (wymagane)
Numer jednostki magazynowej Jednostka SKU (jednostka przechowywania zapasów) przypisana do tego zasobu. sku
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

Właściwości grupy aplikacji

Nazwa Opis Wartość
applicationGroupType (typ grupyaplikacji) Typ zasobu ApplicationGroup. "Pulpit"
"RemoteApp" (wymagane)
opis Opis grupy aplikacji. ciąg
przyjaznaNazwa Przyjazna nazwa grupy aplikacji. ciąg
hostPoolArmPath (ścieżka ramienia hosta) Ścieżka arm puli hostów grupy aplikacji. ciąg (wymagany)
oboTenantId Dzierżawca, w imieniu którego jest żądany zasób. ciąg
showInFeed Wartość logiczna reprezentująca, czy grupa aplikacji jest wyświetlana w kanale informacyjnym. Bool

ManagedServiceIdentity (tożsamość usługi)

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nazwa Opis Wartość

Planowanie

Nazwa Opis Wartość
nazwa Zdefiniowana przez użytkownika nazwa artefaktu innej firmy, który jest pozyskiwany. ciąg (wymagany)
produkt Artefakt innej firmy, który jest pozyskiwany. Np. NewRelic. Produkt jest mapowy na wartość OfferID określoną dla artefaktu podczas dołączania do usługi Data Market. ciąg (wymagany)
kod podwyższania poziomu Wydawca dostarczył kod podwyższania poziomu jako zaaprowizowany w usłudze Data Market dla podanego produktu/artefaktu. ciąg
wydawca Wydawca zakupionego artefaktu innej firmy. Np. NewRelic ciąg (wymagany)
wersja Wersja żądanego produktu/artefaktu. ciąg

Numer jednostki magazynowej

Nazwa Opis Wartość
dyspozycyjność Jeśli jednostka SKU obsługuje skalowanie w poziomie/w, należy uwzględnić liczbę całkowitą pojemności. Jeśli skalowanie w poziomie/w nie jest możliwe dla zasobu, może to zostać pominięte. Int
rodzina Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. ciąg
nazwa Nazwa jednostki SKU. Np. P3. Zazwyczaj jest to kod z literą i cyfrą ciąg (wymagany)
rozmiar Rozmiar jednostki SKU. Gdy pole nazwy jest kombinacją warstwy i innej wartości, będzie to autonomiczny kod. ciąg
warstwa To pole jest wymagane do zaimplementowania przez dostawcę zasobów, jeśli usługa ma więcej niż jedną warstwę, ale nie jest wymagana w put. "Podstawowa"
"Bezpłatna"
"Premium"
"Standardowa"

Śledzone tagi zasobów

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

Definicja zasobu szablonu usługi ARM

Typ zasobu applicationGroups można wdrożyć przy użyciu operacji docelowych:

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
tworzy usługę AVD przy użyciu dołączania do identyfikatora entra firmy Microsoft

wdrażanie w usłudze Azure
Ten szablon umożliwia tworzenie zasobów usługi Azure Virtual Desktop, takich jak pula hostów, grupa aplikacji, obszar roboczy, host sesji testowej i jego rozszerzenia za pomocą dołączania identyfikatora Entra firmy Microsoft

Format zasobu

Aby utworzyć zasób Microsoft.DesktopVirtualization/applicationGroups, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Microsoft.DesktopVirtualization/applicationGroups

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API 'Zapowiedź 2026-04-01'
tożsamość Tożsamości usługi zarządzanej przypisane do tego zasobu. ManagedServiceIdentity (tożsamość usługi)
rodzaj Metadane używane przez portal/narzędzia/itp. do renderowania różnych środowisk środowiska użytkownika dla zasobów tego samego typu; Np. ApiApps to rodzaj typu Microsoft.Web/sites. Jeśli jest obsługiwana, dostawca zasobów musi zweryfikować i utrwalić tę wartość. struna

Ograniczenia:
Wzorzec = ^[-\w\._,\(\)]+$
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
zarządzanePrzez W pełni kwalifikowany identyfikator zasobu, który zarządza tym zasobem. Wskazuje, czy ten zasób jest zarządzany przez inny zasób platformy Azure. Jeśli jest to obecne, wdrożenie trybu pełnego nie spowoduje usunięcia zasobu, jeśli zostanie usunięty z szablonu, ponieważ jest on zarządzany przez inny zasób. ciąg
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 3
Maksymalna długość = 64
Wzorzec = ^[A-Za-z0-9@.\-_ ]*$ (wymagane)
plan Szczegóły planu zasobów. planu
Właściwości Szczegółowe właściwości grupy aplikacji ApplicationGroupProperties (wymagane)
Numer jednostki magazynowej Jednostka SKU (jednostka przechowywania zapasów) przypisana do tego zasobu. sku
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.DesktopVirtualization/applicationGroups"

Właściwości grupy aplikacji

Nazwa Opis Wartość
applicationGroupType (typ grupyaplikacji) Typ zasobu ApplicationGroup. "Pulpit"
"RemoteApp" (wymagane)
opis Opis grupy aplikacji. ciąg
przyjaznaNazwa Przyjazna nazwa grupy aplikacji. ciąg
hostPoolArmPath (ścieżka ramienia hosta) Ścieżka arm puli hostów grupy aplikacji. ciąg (wymagany)
oboTenantId Dzierżawca, w imieniu którego jest żądany zasób. ciąg
showInFeed Wartość logiczna reprezentująca, czy grupa aplikacji jest wyświetlana w kanale informacyjnym. Bool

ManagedServiceIdentity (tożsamość usługi)

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nazwa Opis Wartość

Planowanie

Nazwa Opis Wartość
nazwa Zdefiniowana przez użytkownika nazwa artefaktu innej firmy, który jest pozyskiwany. ciąg (wymagany)
produkt Artefakt innej firmy, który jest pozyskiwany. Np. NewRelic. Produkt jest mapowy na wartość OfferID określoną dla artefaktu podczas dołączania do usługi Data Market. ciąg (wymagany)
kod podwyższania poziomu Wydawca dostarczył kod podwyższania poziomu jako zaaprowizowany w usłudze Data Market dla podanego produktu/artefaktu. ciąg
wydawca Wydawca zakupionego artefaktu innej firmy. Np. NewRelic ciąg (wymagany)
wersja Wersja żądanego produktu/artefaktu. ciąg

Numer jednostki magazynowej

Nazwa Opis Wartość
dyspozycyjność Jeśli jednostka SKU obsługuje skalowanie w poziomie/w, należy uwzględnić liczbę całkowitą pojemności. Jeśli skalowanie w poziomie/w nie jest możliwe dla zasobu, może to zostać pominięte. Int
rodzina Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. ciąg
nazwa Nazwa jednostki SKU. Np. P3. Zazwyczaj jest to kod z literą i cyfrą ciąg (wymagany)
rozmiar Rozmiar jednostki SKU. Gdy pole nazwy jest kombinacją warstwy i innej wartości, będzie to autonomiczny kod. ciąg
warstwa To pole jest wymagane do zaimplementowania przez dostawcę zasobów, jeśli usługa ma więcej niż jedną warstwę, ale nie jest wymagana w put. "Podstawowa"
"Bezpłatna"
"Premium"
"Standardowa"

Śledzone tagi zasobów

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu applicationGroups można wdrożyć przy użyciu operacji docelowych:

  • Grupy zasobów Listę zmienionych właściwości w każdej wersji API można znaleźć w dzienniku zmian.

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania grupy aplikacji pulpitu wirtualnego.

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

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
grupa aplikacji usługi Azure Virtual Desktop (AVD) Moduł zasobów AVM dla grupy aplikacji usługi Azure Virtual Desktop (AVD)

Format zasobu

Aby utworzyć zasób Microsoft.DesktopVirtualization/applicationGroups, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

Microsoft.DesktopVirtualization/applicationGroups

Nazwa Opis Wartość
tożsamość Tożsamości usługi zarządzanej przypisane do tego zasobu. ManagedServiceIdentity (tożsamość usługi)
rodzaj Metadane używane przez portal/narzędzia/itp. do renderowania różnych środowisk środowiska użytkownika dla zasobów tego samego typu; Np. ApiApps to rodzaj typu Microsoft.Web/sites. Jeśli jest obsługiwana, dostawca zasobów musi zweryfikować i utrwalić tę wartość. struna

Ograniczenia:
Wzorzec = ^[-\w\._,\(\)]+$
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
zarządzanePrzez W pełni kwalifikowany identyfikator zasobu, który zarządza tym zasobem. Wskazuje, czy ten zasób jest zarządzany przez inny zasób platformy Azure. Jeśli jest to obecne, wdrożenie trybu pełnego nie spowoduje usunięcia zasobu, jeśli zostanie usunięty z szablonu, ponieważ jest on zarządzany przez inny zasób. ciąg
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 3
Maksymalna długość = 64
Wzorzec = ^[A-Za-z0-9@.\-_ ]*$ (wymagane)
plan Szczegóły planu zasobów. planu
Właściwości Szczegółowe właściwości grupy aplikacji ApplicationGroupProperties (wymagane)
Numer jednostki magazynowej Jednostka SKU (jednostka przechowywania zapasów) przypisana do tego zasobu. sku
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft. DesktopVirtualization/applicationGroups@2026-04-01-preview"

Właściwości grupy aplikacji

Nazwa Opis Wartość
applicationGroupType (typ grupyaplikacji) Typ zasobu ApplicationGroup. "Pulpit"
"RemoteApp" (wymagane)
opis Opis grupy aplikacji. ciąg
przyjaznaNazwa Przyjazna nazwa grupy aplikacji. ciąg
hostPoolArmPath (ścieżka ramienia hosta) Ścieżka arm puli hostów grupy aplikacji. ciąg (wymagany)
oboTenantId Dzierżawca, w imieniu którego jest żądany zasób. ciąg
showInFeed Wartość logiczna reprezentująca, czy grupa aplikacji jest wyświetlana w kanale informacyjnym. Bool

ManagedServiceIdentity (tożsamość usługi)

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nazwa Opis Wartość

Planowanie

Nazwa Opis Wartość
nazwa Zdefiniowana przez użytkownika nazwa artefaktu innej firmy, który jest pozyskiwany. ciąg (wymagany)
produkt Artefakt innej firmy, który jest pozyskiwany. Np. NewRelic. Produkt jest mapowy na wartość OfferID określoną dla artefaktu podczas dołączania do usługi Data Market. ciąg (wymagany)
kod podwyższania poziomu Wydawca dostarczył kod podwyższania poziomu jako zaaprowizowany w usłudze Data Market dla podanego produktu/artefaktu. ciąg
wydawca Wydawca zakupionego artefaktu innej firmy. Np. NewRelic ciąg (wymagany)
wersja Wersja żądanego produktu/artefaktu. ciąg

Numer jednostki magazynowej

Nazwa Opis Wartość
dyspozycyjność Jeśli jednostka SKU obsługuje skalowanie w poziomie/w, należy uwzględnić liczbę całkowitą pojemności. Jeśli skalowanie w poziomie/w nie jest możliwe dla zasobu, może to zostać pominięte. Int
rodzina Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. ciąg
nazwa Nazwa jednostki SKU. Np. P3. Zazwyczaj jest to kod z literą i cyfrą ciąg (wymagany)
rozmiar Rozmiar jednostki SKU. Gdy pole nazwy jest kombinacją warstwy i innej wartości, będzie to autonomiczny kod. ciąg
warstwa To pole jest wymagane do zaimplementowania przez dostawcę zasobów, jeśli usługa ma więcej niż jedną warstwę, ale nie jest wymagana w put. "Podstawowa"
"Bezpłatna"
"Premium"
"Standardowa"

Śledzone tagi zasobów

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość