Áreas de trabajo Microsoft.DesktopVirtualization

Definición de recursos de Bicep

El tipo de recurso workspaces se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DesktopVirtualization/workspaces, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.DesktopVirtualization/workspaces@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: {
    applicationGroupReferences: [
      'string'
    ]
    deploymentScope: 'string'
    description: 'string'
    friendlyName: 'string'
    oboTenantId: 'string'
    publicNetworkAccess: 'string'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

Microsoft.DesktopVirtualization/workspaces

Nombre Descripción Valor
identidad Identidades de servicio administradas asignadas a este recurso. managedServiceIdentity
amable Metadatos utilizados por portal/herramientas/etc para representar diferentes experiencias de experiencia de usuario para los recursos del mismo tipo; Por ejemplo, ApiApps son un tipo de tipo Microsoft.Web/sites. Si se admite, el proveedor de recursos debe validar y conservar este valor. cuerda

Restricciones:
Patrón = ^[-\w\._,\(\)]+$
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
gestionadoPor Identificador de recurso completo del recurso que administra este recurso. Indica si otro recurso de Azure administra este recurso. Si está presente, la implementación del modo completo no eliminará el recurso si se quita de la plantilla, ya que otro recurso lo administra. cuerda
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 64
Patrón = ^[A-Za-z0-9@.\-_ ]*$ (obligatorio)
plan Detalles del plan de recursos. plan de
Propiedades Propiedades detalladas del área de trabajo WorkspaceProperties (Propiedades del espacio de trabajo)
Sku La SKU (unidad de mantenimiento de existencias) asignada a este recurso. Sku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. managedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nombre Descripción Valor

Planificación

Nombre Descripción Valor
nombre Nombre definido por el usuario del artefacto de terceros que se está adquierendo. string (obligatorio)
producto Artefacto de terceros que se está adquierendo. Por ejemplo, NewRelic. El producto se asigna al offerID especificado para el artefacto en el momento de la incorporación de Data Market. string (obligatorio)
promotionCode Un publicador proporcionó código de promoción tal como se aprovisionó en Data Market para dicho producto o artefacto. cuerda
editor Publicador del artefacto de terceros que se está comprando. Por ejemplo, NewRelic string (obligatorio)
Versión Versión del producto o artefacto deseado. cuerda

SKU

Nombre Descripción Valor
capacidad Si la SKU admite el escalado horizontal o horizontal, se debe incluir el entero de capacidad. Si no es posible escalar horizontalmente o reducir horizontalmente el recurso, se puede omitir. Int
familia Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. cuerda
nombre Nombre de la SKU. Por ejemplo, P3. Normalmente es un código de letra y número string (obligatorio)
tamaño Tamaño de la SKU. Cuando el campo de nombre es la combinación de nivel y otro valor, este sería el código independiente. cuerda
nivel El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put. "Básico"
"Gratis"
'Premium'
'Estándar'

TrackedResourceTags

Nombre Descripción Valor

IdentidadAsignadaPorElUsuario

Nombre Descripción Valor

WorkspaceProperties (Propiedades del espacio de trabajo)

Nombre Descripción Valor
applicationGroupReferences Lista de identificadores de recursos de applicationGroup. cadena[]
deploymentScope Tipo DeploymentScope para Workspace. 'Geográfico'
"Regional"
descripción Descripción del área de trabajo. cuerda
nombre amistoso Nombre descriptivo del área de trabajo. cuerda
oboTenantId Inquilino en nombre del cual se solicita el recurso. cuerda
publicNetworkAccess Habilitado permite que se acceda a este recurso desde redes públicas y privadas, Deshabilitado permite que solo se acceda a este recurso a través de puntos de conexión privados. 'Deshabilitado'
'Habilitado'

Ejemplos de uso

Ejemplos de Bicep

Un ejemplo básico de implementación de Virtual Desktop Workspace.

param resourceName string = 'acctest0001'
param location string = 'westus'

resource workspace 'Microsoft.DesktopVirtualization/workspaces@2024-04-03' = {
  name: resourceName
  location: location
  properties: {
    description: ''
    friendlyName: ''
    publicNetworkAccess: 'Enabled'
  }
}

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo Descripción
área de trabajo de Azure Virtual Desktop (AVD) Módulo de recursos de AVM para el área de trabajo de Azure Virtual Desktop (AVD)

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Descripción
crea AVD con el de unión de id. de Entra de Microsoft Esta plantilla le permite crear recursos de Azure Virtual Desktop, como el grupo de hosts, el grupo de aplicaciones, el área de trabajo, un host de sesión de prueba y sus extensiones con la unión a Microsoft Entra ID.

Definición de recursos de plantilla de ARM

El tipo de recurso workspaces se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DesktopVirtualization/workspaces, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.DesktopVirtualization/workspaces",
  "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": {
    "applicationGroupReferences": [ "string" ],
    "deploymentScope": "string",
    "description": "string",
    "friendlyName": "string",
    "oboTenantId": "string",
    "publicNetworkAccess": "string"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

Microsoft.DesktopVirtualization/workspaces

Nombre Descripción Valor
apiVersion La versión de api 'Avance del 01-04-2026'
identidad Identidades de servicio administradas asignadas a este recurso. managedServiceIdentity
amable Metadatos utilizados por portal/herramientas/etc para representar diferentes experiencias de experiencia de usuario para los recursos del mismo tipo; Por ejemplo, ApiApps son un tipo de tipo Microsoft.Web/sites. Si se admite, el proveedor de recursos debe validar y conservar este valor. cuerda

Restricciones:
Patrón = ^[-\w\._,\(\)]+$
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
gestionadoPor Identificador de recurso completo del recurso que administra este recurso. Indica si otro recurso de Azure administra este recurso. Si está presente, la implementación del modo completo no eliminará el recurso si se quita de la plantilla, ya que otro recurso lo administra. cuerda
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 64
Patrón = ^[A-Za-z0-9@.\-_ ]*$ (obligatorio)
plan Detalles del plan de recursos. plan de
Propiedades Propiedades detalladas del área de trabajo WorkspaceProperties (Propiedades del espacio de trabajo)
Sku La SKU (unidad de mantenimiento de existencias) asignada a este recurso. Sku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso "Microsoft.DesktopVirtualization/workspaces"

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. managedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nombre Descripción Valor

Planificación

Nombre Descripción Valor
nombre Nombre definido por el usuario del artefacto de terceros que se está adquierendo. string (obligatorio)
producto Artefacto de terceros que se está adquierendo. Por ejemplo, NewRelic. El producto se asigna al offerID especificado para el artefacto en el momento de la incorporación de Data Market. string (obligatorio)
promotionCode Un publicador proporcionó código de promoción tal como se aprovisionó en Data Market para dicho producto o artefacto. cuerda
editor Publicador del artefacto de terceros que se está comprando. Por ejemplo, NewRelic string (obligatorio)
Versión Versión del producto o artefacto deseado. cuerda

SKU

Nombre Descripción Valor
capacidad Si la SKU admite el escalado horizontal o horizontal, se debe incluir el entero de capacidad. Si no es posible escalar horizontalmente o reducir horizontalmente el recurso, se puede omitir. Int
familia Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. cuerda
nombre Nombre de la SKU. Por ejemplo, P3. Normalmente es un código de letra y número string (obligatorio)
tamaño Tamaño de la SKU. Cuando el campo de nombre es la combinación de nivel y otro valor, este sería el código independiente. cuerda
nivel El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put. "Básico"
"Gratis"
'Premium'
'Estándar'

TrackedResourceTags

Nombre Descripción Valor

IdentidadAsignadaPorElUsuario

Nombre Descripción Valor

WorkspaceProperties (Propiedades del espacio de trabajo)

Nombre Descripción Valor
applicationGroupReferences Lista de identificadores de recursos de applicationGroup. cadena[]
deploymentScope Tipo DeploymentScope para Workspace. 'Geográfico'
"Regional"
descripción Descripción del área de trabajo. cuerda
nombre amistoso Nombre descriptivo del área de trabajo. cuerda
oboTenantId Inquilino en nombre del cual se solicita el recurso. cuerda
publicNetworkAccess Habilitado permite que se acceda a este recurso desde redes públicas y privadas, Deshabilitado permite que solo se acceda a este recurso a través de puntos de conexión privados. 'Deshabilitado'
'Habilitado'

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla Descripción
crea AVD con el de unión de id. de Entra de Microsoft

Implementación en Azure
Esta plantilla le permite crear recursos de Azure Virtual Desktop, como el grupo de hosts, el grupo de aplicaciones, el área de trabajo, un host de sesión de prueba y sus extensiones con la unión a Microsoft Entra ID.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso workspaces se puede implementar con operaciones destinadas a:

  • Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DesktopVirtualization/workspaces, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DesktopVirtualization/workspaces@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 = {
      applicationGroupReferences = [
        "string"
      ]
      deploymentScope = "string"
      description = "string"
      friendlyName = "string"
      oboTenantId = "string"
      publicNetworkAccess = "string"
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Valores de propiedad

Microsoft.DesktopVirtualization/workspaces

Nombre Descripción Valor
identidad Identidades de servicio administradas asignadas a este recurso. managedServiceIdentity
amable Metadatos utilizados por portal/herramientas/etc para representar diferentes experiencias de experiencia de usuario para los recursos del mismo tipo; Por ejemplo, ApiApps son un tipo de tipo Microsoft.Web/sites. Si se admite, el proveedor de recursos debe validar y conservar este valor. cuerda

Restricciones:
Patrón = ^[-\w\._,\(\)]+$
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
gestionadoPor Identificador de recurso completo del recurso que administra este recurso. Indica si otro recurso de Azure administra este recurso. Si está presente, la implementación del modo completo no eliminará el recurso si se quita de la plantilla, ya que otro recurso lo administra. cuerda
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 64
Patrón = ^[A-Za-z0-9@.\-_ ]*$ (obligatorio)
plan Detalles del plan de recursos. plan de
Propiedades Propiedades detalladas del área de trabajo WorkspaceProperties (Propiedades del espacio de trabajo)
Sku La SKU (unidad de mantenimiento de existencias) asignada a este recurso. Sku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft. DesktopVirtualization/workspaces@2026-04-01-preview"

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. managedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nombre Descripción Valor

Planificación

Nombre Descripción Valor
nombre Nombre definido por el usuario del artefacto de terceros que se está adquierendo. string (obligatorio)
producto Artefacto de terceros que se está adquierendo. Por ejemplo, NewRelic. El producto se asigna al offerID especificado para el artefacto en el momento de la incorporación de Data Market. string (obligatorio)
promotionCode Un publicador proporcionó código de promoción tal como se aprovisionó en Data Market para dicho producto o artefacto. cuerda
editor Publicador del artefacto de terceros que se está comprando. Por ejemplo, NewRelic string (obligatorio)
Versión Versión del producto o artefacto deseado. cuerda

SKU

Nombre Descripción Valor
capacidad Si la SKU admite el escalado horizontal o horizontal, se debe incluir el entero de capacidad. Si no es posible escalar horizontalmente o reducir horizontalmente el recurso, se puede omitir. Int
familia Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. cuerda
nombre Nombre de la SKU. Por ejemplo, P3. Normalmente es un código de letra y número string (obligatorio)
tamaño Tamaño de la SKU. Cuando el campo de nombre es la combinación de nivel y otro valor, este sería el código independiente. cuerda
nivel El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put. "Básico"
"Gratis"
'Premium'
'Estándar'

TrackedResourceTags

Nombre Descripción Valor

IdentidadAsignadaPorElUsuario

Nombre Descripción Valor

WorkspaceProperties (Propiedades del espacio de trabajo)

Nombre Descripción Valor
applicationGroupReferences Lista de identificadores de recursos de applicationGroup. cadena[]
deploymentScope Tipo DeploymentScope para Workspace. 'Geográfico'
"Regional"
descripción Descripción del área de trabajo. cuerda
nombre amistoso Nombre descriptivo del área de trabajo. cuerda
oboTenantId Inquilino en nombre del cual se solicita el recurso. cuerda
publicNetworkAccess Habilitado permite que se acceda a este recurso desde redes públicas y privadas, Deshabilitado permite que solo se acceda a este recurso a través de puntos de conexión privados. 'Deshabilitado'
'Habilitado'

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de Virtual Desktop Workspace.

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" "workspace" {
  type      = "Microsoft.DesktopVirtualization/workspaces@2024-04-03"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      description         = ""
      friendlyName        = ""
      publicNetworkAccess = "Enabled"
    }
  }
}

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo Descripción
área de trabajo de Azure Virtual Desktop (AVD) Módulo de recursos de AVM para el área de trabajo de Azure Virtual Desktop (AVD)