Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
- más reciente
- Vista previa del 01-04-2026
- Avance del 01-03-2026
- Avance del 01-01-2026
- 2025-11-01-vista previa
- 2025-10-10
- 2025-09-01-vista previa
- 2025-08-01-preview
- 2025-04-01-preview
- 2025-03-01-vista previa
- 2024-11-01-vista previa
- 2024-08-08-vista previa
- 2024-04-08-vista previa
- 2024-04-03
- 2024-03-06-avance
- 2024-01-16-vista previa
- 2023-11-01-vista previa
- 2023-10-04-vista previa
- 2023-09-05
- 2022-10-14-vista previa
- 2022-09-09
- 2022-04-01-vista previa
- 2022-02-10-vista previa
- 2021-09-03-vista previa
- 2021-07-12
- 2021-04-01-vista previa
- 2021-03-09-vista previa
- 2021-02-01-vista previa
- 2021-01-14-vista previa
- 2020-11-10-vista previa
- 2020-11-02-vista previa
- 2020-10-19-vista previa
- 2020-09-21-vista previa
- 2019-12-10-vista previa
- 2019-09-24-vista previa
- 2019-01-23-vista previa
Definición de recursos de Bicep
El tipo de recurso workspaces se puede implementar con operaciones destinadas a:
- grupos de recursos: consulte comandos de implementación de 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 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:
- grupos de recursos: consulte comandos de implementación de 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 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 |
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) |