Microsoft.DevTestLab labs/virtualmachines

Artículo
08/11/2023

Definición de recursos de Bicep

El tipo de recurso labs/virtualmachines se puede implementar con operaciones que tienen como destino:

Grupos de recursos: consulte los comandos de implementación del grupo de recursos.

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

Formato de los recursos

Para crear un recurso Microsoft.DevTestLab/labs/virtualmachines, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2018-09-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    allowClaim: bool
    artifacts: [
      {
        artifactId: 'string'
        artifactTitle: 'string'
        deploymentStatusMessage: 'string'
        installTime: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
        status: 'string'
        vmExtensionStatusMessage: 'string'
      }
    ]
    createdDate: 'string'
    customImageId: 'string'
    dataDiskParameters: [
      {
        attachNewDataDiskOptions: {
          diskName: 'string'
          diskSizeGiB: int
          diskType: 'string'
        }
        existingLabDiskId: 'string'
        hostCaching: 'string'
      }
    ]
    disallowPublicIpAddress: bool
    environmentId: 'string'
    expirationDate: 'string'
    galleryImageReference: {
      offer: 'string'
      osType: 'string'
      publisher: 'string'
      sku: 'string'
      version: 'string'
    }
    isAuthenticationWithSshKey: bool
    labSubnetName: 'string'
    labVirtualNetworkId: 'string'
    networkInterface: {
      dnsName: 'string'
      privateIpAddress: 'string'
      publicIpAddress: 'string'
      publicIpAddressId: 'string'
      rdpAuthority: 'string'
      sharedPublicIpAddressConfiguration: {
        inboundNatRules: [
          {
            backendPort: int
            frontendPort: int
            transportProtocol: 'string'
          }
        ]
      }
      sshAuthority: 'string'
      subnetId: 'string'
      virtualNetworkId: 'string'
    }
    notes: 'string'
    ownerObjectId: 'string'
    ownerUserPrincipalName: 'string'
    password: 'string'
    planId: 'string'
    scheduleParameters: [
      {
        name: 'string'
        properties: {
          dailyRecurrence: {
            time: 'string'
          }
          hourlyRecurrence: {
            minute: int
          }
          notificationSettings: {
            emailRecipient: 'string'
            notificationLocale: 'string'
            status: 'string'
            timeInMinutes: int
            webhookUrl: 'string'
          }
          status: 'string'
          targetResourceId: 'string'
          taskType: 'string'
          weeklyRecurrence: {
            time: 'string'
            weekdays: [
              'string'
            ]
          }
        }
        tags: {}
      }
    ]
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    userName: 'string'
  }
}

Valores de propiedad

labs/virtualmachines

Nombre	Descripción	Value
name	El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.	string (obligatorio) Límite de caracteres: 1-15 (Windows) 1-64 (Linux) Caracteres válidos: Caracteres alfanuméricos y guiones. Comience y termine con un carácter alfanumérico. No puede constar de números en su totalidad.
ubicación	Ubicación del recurso.	string
etiquetas	Las etiquetas del recurso.	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
primario	En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para más información, consulte Recurso secundario fuera del recurso primario.	Nombre simbólico del recurso de tipo: laboratorios
properties	Propiedades del recurso.	LabVirtualMachineProperties (obligatorio)

LabVirtualMachineProperties

Nombre	Descripción	Valor
allowClaim	Indica si otro usuario puede tomar posesión de la máquina virtual.	bool
artifacts	Artefactos que se van a instalar en la máquina virtual.	ArtifactInstallProperties[]
createdDate	Fecha de creación de la máquina virtual.	string
customImageId	Identificador de imagen personalizado de la máquina virtual.	string
dataDiskParameters	Discos de datos nuevos o existentes que se van a conectar a la máquina virtual después de la creación	DataDiskProperties[]
disallowPublicIpAddress	Indica si la máquina virtual se va a crear sin una dirección IP pública.	bool
environmentId	Identificador de recurso del entorno que contiene esta máquina virtual, si existe.	string
expirationDate	Fecha de expiración de la máquina virtual.	string
galleryImageReference	La referencia de imagen de Microsoft Azure Marketplace de la máquina virtual.	GalleryImageReference
isAuthenticationWithSshKey	Indica si esta máquina virtual usa una clave SSH para la autenticación.	bool
labSubnetName	El nombre de subred del laboratorio de la máquina virtual.	string
labVirtualNetworkId	Identificador de red virtual del laboratorio de la máquina virtual.	string
networkInterface	Propiedades de la interfaz de red.	NetworkInterfaceProperties
HDInsight	Notas de la máquina virtual.	string
ownerObjectId	Identificador de objeto del propietario de la máquina virtual.	string
ownerUserPrincipalName	Nombre principal de usuario del propietario de la máquina virtual.	string
password	Contraseña del administrador de la máquina virtual.	string
planId	Identificador del plan asociado a la imagen de máquina virtual	string
scheduleParameters	Programaciones de máquina virtual que se van a crear	ScheduleCreationParameter[]
tamaño	Tamaño de la máquina virtual.	string
sshKey	Clave SSH del administrador de la máquina virtual.	string
storageType	Tipo de almacenamiento que se va a usar para la máquina virtual (es decir, Estándar, Premium).	string
userName	Nombre de usuario de la máquina virtual.	string

ArtifactInstallProperties

Nombre	Descripción	Valor
artifactId	Identificador del artefacto.	string
artifactTitle	Título del artefacto.	string
deploymentStatusMessage	Mensaje de estado de la implementación.	string
installTime	Hora a la que el artefacto comienza a instalarse en la máquina virtual.	string
parámetros	Parámetros del artefacto.	ArtifactParameterProperties[]
status	Estado del artefacto.	string
vmExtensionStatusMessage	Mensaje de estado de la extensión de máquina virtual.	string

ArtifactParameterProperties

Nombre	Descripción	Value
name	Nombre del parámetro artifact.	string
value	Valor del parámetro artifact.	string

DataDiskProperties

Nombre	Descripción	Valor
attachNewDataDiskOptions	Especifica las opciones para conectar un nuevo disco a la máquina virtual.	AttachNewDataDiskOptions
existingLabDiskId	Especifica el identificador de disco de laboratorio existente que se va a conectar a la máquina virtual.	string
hostCaching	Opción de almacenamiento en caché para un disco de datos (es decir, None, ReadOnly, ReadWrite).	'Ninguno' 'ReadOnly' "ReadWrite"

AttachNewDataDiskOptions

Nombre	Descripción	Valor
diskName	Nombre del disco que se va a conectar.	string
diskSizeGiB	Tamaño del disco que se va a conectar en Gibibytes.	int
diskType	Tipo de almacenamiento para el disco (es decir, Estándar, Premium).	"Premium" 'Estándar' "StandardSSD"

GalleryImageReference

Nombre	Descripción	Valor
offer	La oferta de la imagen de la galería.	string
osType	El tipo de sistema operativo de la imagen de la galería.	string
publisher	Publicador de la imagen de la galería.	string
sku	SKU de la imagen de la galería.	string
version	La versión de la imagen de la galería.	string

NetworkInterfaceProperties

Nombre	Descripción	Valor
dnsName	Nombre de DNS.	string
privateIpAddress	Dirección IP privada.	string
publicIpAddress	La dirección IP pública.	string
publicIpAddressId	Identificador de recurso de la dirección IP pública.	string
rdpAuthority	La propiedad RdpAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para RDP (Protocolo de escritorio remoto).	string
sharedPublicIpAddressConfiguration	Configuración para compartir una dirección IP pública en varias máquinas virtuales.	SharedPublicIpAddressConfiguration
sshAuthority	La propiedad SshAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para SSH.	string
subnetId	Identificador de recurso de la subred.	string
virtualNetworkId	Identificador de recurso de la red virtual.	string

SharedPublicIpAddressConfiguration

Nombre	Descripción	Valor
inboundNatRules	Reglas NAT entrantes	InboundNatRule[]

InboundNatRule

Nombre	Descripción	Valor
backendPort	Puerto al que se redirigirá el tráfico externo.	int
frontendPort	Puerto de punto de conexión externo de la conexión entrante. El intervalo de valores posibles oscila entre 1 y 65535, ambos inclusive. Si no se especifica, se asignará automáticamente un valor.	int
transportProtocol	Protocolo de transporte para el extremo.	'Tcp' 'Udp'

ScheduleCreationParameter

Nombre	Descripción	Value
name	Nombre de la máquina virtual o el entorno	string
properties	Propiedades de la programación.	ScheduleCreationParameterProperties
etiquetas	Etiquetas del recurso.	object

ScheduleCreationParameterProperties

Nombre	Descripción	Valor
dailyRecurrence	Si la programación se producirá una vez cada día de la semana, especifique la periodicidad diaria.	DayDetails
hourlyRecurrence	Si la programación se producirá varias veces al día, especifique la periodicidad por hora.	HourDetails
notificationSettings	Configuración de notificación.	NotificationSettings
status	Estado de la programación (es decir, Habilitado, Deshabilitado)	'Deshabilitado' 'Habilitado'
targetResourceId	Identificador de recurso al que pertenece la programación	string
taskType	Tipo de tarea de la programación (por ejemplo, LabVmsShutdownTask, LabVmAutoStart).	string
weeklyRecurrence	Si la programación se producirá solo algunos días de la semana, especifique la periodicidad semanal.	WeekDetails

DayDetails

Nombre	Descripción	Valor
time	Hora del día en que se producirá la programación.	string

HourDetails

Nombre	Descripción	Valor
minute	Minutos de la hora en que se ejecutará la programación.	int

NotificationSettings

Nombre	Descripción	Valor
emailRecipient	El destinatario del correo electrónico al que enviar notificaciones (puede ser una lista de direcciones de correo electrónico separadas por punto y coma).	string
notificationLocale	La configuración regional que se va a usar al enviar una notificación (la reserva de idiomas no admitidos es EN).	string
status	Si las notificaciones están habilitadas para esta programación (es decir, Habilitada, Deshabilitada).	'Deshabilitado' 'Habilitado'
timeInMinutes	Tiempo en minutos antes del evento en el que se enviará la notificación.	int
webhookUrl	Dirección URL del webhook a la que se enviará la notificación.	string

WeekDetails

Nombre	Descripción	Valor
time	Hora del día en que se producirá la programación.	string
días entre semana	Los días de la semana para los que se establece la programación (por ejemplo, domingo, lunes, martes, etc.).	string[]

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla	Descripción
Crea un laboratorio en Azure DevTest Labs con una máquina virtual Windows Server	Esta plantilla crea una nueva instancia de DevTest Lab/DTL con una máquina virtual de Windows Server 2019 Datacenter en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles enhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Crea un laboratorio en Azure DevTest Labs con una máquina virtual reclamada	Esta plantilla crea una nueva instancia de DevTest Lab/DTL con una máquina virtual de Windows Server 2019 Datacenter reclamada en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles enhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definición de recursos de plantilla de ARM

El tipo de recurso labs/virtualmachines se puede implementar con operaciones destinadas a:

Grupos de recursos: consulte los comandos de implementación del grupo de recursos.

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

Formato de los recursos

Para crear un recurso Microsoft.DevTestLab/labs/virtualmachines, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.DevTestLab/labs/virtualmachines",
  "apiVersion": "2018-09-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "allowClaim": "bool",
    "artifacts": [
      {
        "artifactId": "string",
        "artifactTitle": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "createdDate": "string",
    "customImageId": "string",
    "dataDiskParameters": [
      {
        "attachNewDataDiskOptions": {
          "diskName": "string",
          "diskSizeGiB": "int",
          "diskType": "string"
        },
        "existingLabDiskId": "string",
        "hostCaching": "string"
      }
    ],
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "string",
    "galleryImageReference": {
      "offer": "string",
      "osType": "string",
      "publisher": "string",
      "sku": "string",
      "version": "string"
    },
    "isAuthenticationWithSshKey": "bool",
    "labSubnetName": "string",
    "labVirtualNetworkId": "string",
    "networkInterface": {
      "dnsName": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "publicIpAddressId": "string",
      "rdpAuthority": "string",
      "sharedPublicIpAddressConfiguration": {
        "inboundNatRules": [
          {
            "backendPort": "int",
            "frontendPort": "int",
            "transportProtocol": "string"
          }
        ]
      },
      "sshAuthority": "string",
      "subnetId": "string",
      "virtualNetworkId": "string"
    },
    "notes": "string",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "planId": "string",
    "scheduleParameters": [
      {
        "name": "string",
        "properties": {
          "dailyRecurrence": {
            "time": "string"
          },
          "hourlyRecurrence": {
            "minute": "int"
          },
          "notificationSettings": {
            "emailRecipient": "string",
            "notificationLocale": "string",
            "status": "string",
            "timeInMinutes": "int",
            "webhookUrl": "string"
          },
          "status": "string",
          "targetResourceId": "string",
          "taskType": "string",
          "weeklyRecurrence": {
            "time": "string",
            "weekdays": [ "string" ]
          }
        },
        "tags": {}
      }
    ],
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "userName": "string"
  }
}

Valores de propiedad

labs/virtualmachines

Nombre	Descripción	Value
type	Tipo de recurso	'Microsoft.DevTestLab/labs/virtualmachines'
apiVersion	La versión de la API de recursos	'2018-09-15'
name	El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON.	string (obligatorio) Límite de caracteres: 1-15 (Windows) 1-64 (Linux) Caracteres válidos: Caracteres alfanuméricos y guiones. Comience y termine con un carácter alfanumérico. No puede constar de números en su totalidad.
ubicación	Ubicación del recurso.	string
etiquetas	Etiquetas del recurso.	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties	Propiedades del recurso.	LabVirtualMachineProperties (obligatorio)

LabVirtualMachineProperties

Nombre	Descripción	Valor
allowClaim	Indica si otro usuario puede tomar posesión de la máquina virtual.	bool
artifacts	Artefactos que se van a instalar en la máquina virtual.	ArtifactInstallProperties[]
createdDate	Fecha de creación de la máquina virtual.	string
customImageId	Identificador de imagen personalizado de la máquina virtual.	string
dataDiskParameters	Discos de datos nuevos o existentes que se van a conectar a la máquina virtual después de la creación	DataDiskProperties[]
no permitirPublicIpAddress	Indica si la máquina virtual se va a crear sin una dirección IP pública.	bool
environmentId	Identificador de recurso del entorno que contiene esta máquina virtual, si existe.	string
expirationDate	Fecha de expiración de la máquina virtual.	string
galleryImageReference	Referencia de imagen de Microsoft Azure Marketplace de la máquina virtual.	GalleryImageReference
isAuthenticationWithSshKey	Indica si esta máquina virtual usa una clave SSH para la autenticación.	bool
labSubnetName	Nombre de subred del laboratorio de la máquina virtual.	string
labVirtualNetworkId	Identificador de red virtual del laboratorio de la máquina virtual.	string
networkInterface	Propiedades de la interfaz de red.	NetworkInterfaceProperties
HDInsight	Notas de la máquina virtual.	string
ownerObjectId	Identificador de objeto del propietario de la máquina virtual.	string
ownerUserPrincipalName	Nombre principal de usuario del propietario de la máquina virtual.	string
password	Contraseña del administrador de la máquina virtual.	string
planId	Identificador del plan asociado a la imagen de máquina virtual	string
scheduleParameters	Programaciones de máquina virtual que se van a crear	ScheduleCreationParameter[]
tamaño	Tamaño de la máquina virtual.	string
sshKey	Clave SSH del administrador de la máquina virtual.	string
storageType	Tipo de almacenamiento que se va a usar para la máquina virtual (es decir, Estándar, Premium).	string
userName	Nombre de usuario de la máquina virtual.	string

ArtifactInstallProperties

Nombre	Descripción	Valor
artifactId	Identificador del artefacto.	string
artifactTitle	Título del artefacto.	string
deploymentStatusMessage	Mensaje de estado de la implementación.	string
installTime	Hora a la que el artefacto comienza a instalarse en la máquina virtual.	string
parámetros	Parámetros del artefacto.	ArtifactParameterProperties[]
status	Estado del artefacto.	string
vmExtensionStatusMessage	Mensaje de estado de la extensión de máquina virtual.	string

ArtifactParameterProperties

Nombre	Descripción	Value
name	Nombre del parámetro artifact.	string
value	Valor del parámetro artifact.	string

DataDiskProperties

Nombre	Descripción	Valor
attachNewDataDiskOptions	Especifica opciones para conectar un nuevo disco a la máquina virtual.	AttachNewDataDiskOptions
existingLabDiskId	Especifica el identificador de disco de laboratorio existente que se va a conectar a la máquina virtual.	string
hostCaching	Opción de almacenamiento en caché para un disco de datos (es decir, None, ReadOnly, ReadWrite).	'Ninguno' 'ReadOnly' "ReadWrite"

AttachNewDataDiskOptions

Nombre	Descripción	Valor
diskName	Nombre del disco que se va a conectar.	string
diskSizeGiB	Tamaño del disco que se va a conectar en Gibibytes.	int
diskType	Tipo de almacenamiento para el disco (es decir, Estándar, Premium).	'Premium' 'Estándar' 'StandardSSD'

GalleryImageReference

Nombre	Descripción	Valor
offer	Oferta de la imagen de la galería.	string
osType	Tipo de sistema operativo de la imagen de la galería.	string
publisher	Publicador de la imagen de la galería.	string
sku	SKU de la imagen de la galería.	string
version	Versión de la imagen de la galería.	string

NetworkInterfaceProperties

Nombre	Descripción	Valor
dnsName	Nombre de DNS.	string
privateIpAddress	Dirección IP privada.	string
publicIpAddress	La dirección IP pública.	string
publicIpAddressId	Identificador de recurso de la dirección IP pública.	string
rdpAuthority	La propiedad RdpAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para RDP (Protocolo de escritorio remoto).	string
sharedPublicIpAddressConfiguration	Configuración para compartir una dirección IP pública en varias máquinas virtuales.	SharedPublicIpAddressConfiguration
sshAuthority	La propiedad SshAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para SSH.	string
subnetId	Identificador de recurso de la subred.	string
virtualNetworkId	Identificador de recurso de la red virtual.	string

SharedPublicIpAddressConfiguration

Nombre	Descripción	Valor
inboundNatRules	Reglas NAT entrantes	InboundNatRule[]

InboundNatRule

Nombre	Descripción	Valor
backendPort	Puerto al que se redirigirá el tráfico externo.	int
frontendPort	Puerto de punto de conexión externo de la conexión entrante. El intervalo de valores posibles oscila entre 1 y 65535, ambos inclusive. Si no se especifica, se asignará automáticamente un valor.	int
transportProtocol	Protocolo de transporte para el extremo.	'Tcp' 'Udp'

ScheduleCreationParameter

Nombre	Descripción	Value
name	Nombre de la máquina virtual o el entorno	string
properties	Propiedades de la programación.	ScheduleCreationParameterProperties
etiquetas	Las etiquetas del recurso.	object

ScheduleCreationParameterProperties

Nombre	Descripción	Valor
dailyRecurrence	Si la programación se producirá una vez cada día de la semana, especifique la periodicidad diaria.	DayDetails
hourlyRecurrence	Si la programación se producirá varias veces al día, especifique la periodicidad horaria.	HourDetails
notificationSettings	Configuración de notificación.	NotificationSettings
status	Estado de la programación (es decir, Habilitado, Deshabilitado)	'Deshabilitado' 'Habilitado'
targetResourceId	Identificador de recurso al que pertenece la programación	string
taskType	Tipo de tarea de la programación (por ejemplo, LabVmsShutdownTask, LabVmAutoStart).	string
weeklyRecurrence	Si la programación solo se producirá algunos días de la semana, especifique la periodicidad semanal.	WeekDetails

DayDetails

Nombre	Descripción	Valor
time	La hora del día en que se producirá la programación.	string

HourDetails

Nombre	Descripción	Valor
minute	Minutos de la hora en que se ejecutará la programación.	int

NotificationSettings

Nombre	Descripción	Valor
emailRecipient	El destinatario de correo electrónico al que enviar notificaciones (puede ser una lista de direcciones de correo electrónico separadas por punto y coma).	string
notificationLocale	Configuración regional que se va a usar al enviar una notificación (la reserva para idiomas no admitidos es EN).	string
status	Si las notificaciones están habilitadas para esta programación (es decir, Habilitada, Deshabilitada).	'Deshabilitado' 'Habilitado'
timeInMinutes	Tiempo en minutos antes del evento en el que se enviará la notificación.	int
webhookUrl	Dirección URL del webhook a la que se enviará la notificación.	string

WeekDetails

Nombre	Descripción	Valor
time	Hora del día en que se producirá la programación.	string
días entre semana	Días de la semana para los que se establece la programación (por ejemplo, domingo, lunes, martes, etc.).	string[]

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla	Descripción
Crea un laboratorio en Azure DevTest Labs con una máquina virtual Windows Server	Esta plantilla crea una nueva instancia de DevTest Lab/DTL con una máquina virtual de Windows Server 2019 Datacenter en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles enhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Crea un laboratorio en Azure DevTest Labs con una máquina virtual reclamada	Esta plantilla crea una nueva instancia de DevTest Lab/DTL con una máquina virtual de Windows Server 2019 Datacenter reclamada en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles enhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso labs/virtualmachines se puede implementar con operaciones que tienen como destino:

Grupos de recursos

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

Formato de los recursos

Para crear un recurso Microsoft.DevTestLab/labs/virtualmachines, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      allowClaim = bool
      artifacts = [
        {
          artifactId = "string"
          artifactTitle = "string"
          deploymentStatusMessage = "string"
          installTime = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
          status = "string"
          vmExtensionStatusMessage = "string"
        }
      ]
      createdDate = "string"
      customImageId = "string"
      dataDiskParameters = [
        {
          attachNewDataDiskOptions = {
            diskName = "string"
            diskSizeGiB = int
            diskType = "string"
          }
          existingLabDiskId = "string"
          hostCaching = "string"
        }
      ]
      disallowPublicIpAddress = bool
      environmentId = "string"
      expirationDate = "string"
      galleryImageReference = {
        offer = "string"
        osType = "string"
        publisher = "string"
        sku = "string"
        version = "string"
      }
      isAuthenticationWithSshKey = bool
      labSubnetName = "string"
      labVirtualNetworkId = "string"
      networkInterface = {
        dnsName = "string"
        privateIpAddress = "string"
        publicIpAddress = "string"
        publicIpAddressId = "string"
        rdpAuthority = "string"
        sharedPublicIpAddressConfiguration = {
          inboundNatRules = [
            {
              backendPort = int
              frontendPort = int
              transportProtocol = "string"
            }
          ]
        }
        sshAuthority = "string"
        subnetId = "string"
        virtualNetworkId = "string"
      }
      notes = "string"
      ownerObjectId = "string"
      ownerUserPrincipalName = "string"
      password = "string"
      planId = "string"
      scheduleParameters = [
        {
          name = "string"
          properties = {
            dailyRecurrence = {
              time = "string"
            }
            hourlyRecurrence = {
              minute = int
            }
            notificationSettings = {
              emailRecipient = "string"
              notificationLocale = "string"
              status = "string"
              timeInMinutes = int
              webhookUrl = "string"
            }
            status = "string"
            targetResourceId = "string"
            taskType = "string"
            weeklyRecurrence = {
              time = "string"
              weekdays = [
                "string"
              ]
            }
          }
          tags = {}
        }
      ]
      size = "string"
      sshKey = "string"
      storageType = "string"
      userName = "string"
    }
  })
}

Valores de propiedad

labs/virtualmachines

Nombre	Descripción	Value
type	Tipo de recurso	"Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 1-15 (Windows) 1-64 (Linux) Caracteres válidos: Caracteres alfanuméricos y guiones. Comience y termine con un carácter alfanumérico. No puede constar de números en su totalidad.
ubicación	Ubicación del recurso.	string
parent_id	Identificador del recurso que es el elemento primario de este recurso.	Identificador del recurso de tipo: laboratorios
etiquetas	Las etiquetas del recurso.	Diccionario de nombres y valores de etiqueta.
properties	Propiedades del recurso.	LabVirtualMachineProperties (obligatorio)

LabVirtualMachineProperties

Nombre	Descripción	Valor
allowClaim	Indica si otro usuario puede tomar posesión de la máquina virtual.	bool
artifacts	Artefactos que se van a instalar en la máquina virtual.	ArtifactInstallProperties[]
createdDate	Fecha de creación de la máquina virtual.	string
customImageId	Identificador de imagen personalizado de la máquina virtual.	string
dataDiskParameters	Discos de datos nuevos o existentes que se van a conectar a la máquina virtual después de la creación	DataDiskProperties[]
disallowPublicIpAddress	Indica si la máquina virtual se va a crear sin una dirección IP pública.	bool
environmentId	Identificador de recurso del entorno que contiene esta máquina virtual, si existe.	string
expirationDate	Fecha de expiración de la máquina virtual.	string
galleryImageReference	La referencia de imagen de Microsoft Azure Marketplace de la máquina virtual.	GalleryImageReference
isAuthenticationWithSshKey	Indica si esta máquina virtual usa una clave SSH para la autenticación.	bool
labSubnetName	El nombre de subred del laboratorio de la máquina virtual.	string
labVirtualNetworkId	Identificador de red virtual del laboratorio de la máquina virtual.	string
networkInterface	Propiedades de la interfaz de red.	NetworkInterfaceProperties
HDInsight	Notas de la máquina virtual.	string
ownerObjectId	Identificador de objeto del propietario de la máquina virtual.	string
ownerUserPrincipalName	Nombre principal de usuario del propietario de la máquina virtual.	string
password	Contraseña del administrador de la máquina virtual.	string
planId	Identificador del plan asociado a la imagen de máquina virtual	string
scheduleParameters	Programaciones de máquina virtual que se van a crear	ScheduleCreationParameter[]
tamaño	Tamaño de la máquina virtual.	string
sshKey	Clave SSH del administrador de la máquina virtual.	string
storageType	Tipo de almacenamiento que se va a usar para la máquina virtual (es decir, Estándar, Premium).	string
userName	Nombre de usuario de la máquina virtual.	string

ArtifactInstallProperties

Nombre	Descripción	Valor
artifactId	Identificador del artefacto.	string
artifactTitle	Título del artefacto.	string
deploymentStatusMessage	Mensaje de estado de la implementación.	string
installTime	Hora a la que el artefacto comienza a instalarse en la máquina virtual.	string
parámetros	Parámetros del artefacto.	ArtifactParameterProperties[]
status	Estado del artefacto.	string
vmExtensionStatusMessage	Mensaje de estado de la extensión de máquina virtual.	string

ArtifactParameterProperties

Nombre	Descripción	Value
name	Nombre del parámetro artifact.	string
value	Valor del parámetro artifact.	string

DataDiskProperties

Nombre	Descripción	Valor
attachNewDataDiskOptions	Especifica las opciones para conectar un nuevo disco a la máquina virtual.	AttachNewDataDiskOptions
existingLabDiskId	Especifica el identificador de disco de laboratorio existente que se va a conectar a la máquina virtual.	string
hostCaching	Opción de almacenamiento en caché para un disco de datos (es decir, None, ReadOnly, ReadWrite).	"None" "ReadOnly" "ReadWrite"

AttachNewDataDiskOptions

Nombre	Descripción	Valor
diskName	Nombre del disco que se va a conectar.	string
diskSizeGiB	Tamaño del disco que se va a conectar en Gibibytes.	int
diskType	Tipo de almacenamiento para el disco (es decir, Estándar, Premium).	"Premium" "Estándar" "StandardSSD"

GalleryImageReference

Nombre	Descripción	Valor
offer	La oferta de la imagen de la galería.	string
osType	El tipo de sistema operativo de la imagen de la galería.	string
publisher	Publicador de la imagen de la galería.	string
sku	SKU de la imagen de la galería.	string
version	La versión de la imagen de la galería.	string

NetworkInterfaceProperties

Nombre	Descripción	Valor
dnsName	Nombre de DNS.	string
privateIpAddress	La dirección IP privada.	string
publicIpAddress	La dirección IP pública.	string
publicIpAddressId	Identificador de recurso de la dirección IP pública.	string
rdpAuthority	La propiedad RdpAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para RDP (Protocolo de escritorio remoto).	string
sharedPublicIpAddressConfiguration	Configuración para compartir una dirección IP pública en varias máquinas virtuales.	SharedPublicIpAddressConfiguration
sshAuthority	La propiedad SshAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para SSH.	string
subnetId	Identificador de recurso de la subred.	string
virtualNetworkId	Identificador de recurso de la red virtual.	string

SharedPublicIpAddressConfiguration

Nombre	Descripción	Valor
inboundNatRules	Reglas NAT entrantes	InboundNatRule[]

InboundNatRule

Nombre	Descripción	Valor
backendPort	Puerto al que se redirigirá el tráfico externo.	int
frontendPort	Puerto de punto de conexión externo de la conexión de entrada. El intervalo de valores posibles oscila entre 1 y 65535, ambos inclusive. Si no se especifica, se asignará automáticamente un valor.	int
transportProtocol	Protocolo de transporte para el extremo.	"Tcp" "Udp"

ScheduleCreationParameter

Nombre	Descripción	Value
name	Nombre de la máquina virtual o el entorno	string
properties	Propiedades de la programación.	ScheduleCreationParameterProperties
etiquetas	Las etiquetas del recurso.	object

ScheduleCreationParameterProperties

Nombre	Descripción	Valor
dailyRecurrence	Si la programación se producirá una vez cada día de la semana, especifique la periodicidad diaria.	DayDetails
hourlyRecurrence	Si la programación se producirá varias veces al día, especifique la periodicidad horaria.	HourDetails
notificationSettings	Configuración de notificación.	NotificationSettings
status	Estado de la programación (es decir, Habilitado, Deshabilitado)	"Deshabilitado" "Habilitado"
targetResourceId	Identificador de recurso al que pertenece la programación	string
taskType	Tipo de tarea de la programación (por ejemplo, LabVmsShutdownTask, LabVmAutoStart).	string
weeklyRecurrence	Si la programación solo se producirá algunos días de la semana, especifique la periodicidad semanal.	WeekDetails

DayDetails

Nombre	Descripción	Valor
time	La hora del día en que se producirá la programación.	string

HourDetails

Nombre	Descripción	Valor
minute	Minutos de la hora en que se ejecutará la programación.	int

NotificationSettings

Nombre	Descripción	Valor
emailRecipient	El destinatario de correo electrónico al que enviar notificaciones (puede ser una lista de direcciones de correo electrónico separadas por punto y coma).	string
notificationLocale	Configuración regional que se va a usar al enviar una notificación (la reserva para idiomas no admitidos es EN).	string
status	Si las notificaciones están habilitadas para esta programación (es decir, Habilitada, Deshabilitada).	"Deshabilitado" "Habilitado"
timeInMinutes	Tiempo en minutos antes del evento en el que se enviará la notificación.	int
webhookUrl	Dirección URL del webhook a la que se enviará la notificación.	string

WeekDetails

Nombre	Descripción	Valor
time	Hora del día en que se producirá la programación.	string
días entre semana	Días de la semana para los que se establece la programación (por ejemplo, domingo, lunes, martes, etc.).	string[]

Compartir a través de

Microsoft.DevTestLab labs/virtualmachines

Definición de recursos de Bicep

Formato de los recursos

Valores de propiedad

labs/virtualmachines

LabVirtualMachineProperties

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Plantillas de inicio rápido

Definición de recursos de plantilla de ARM

Formato de los recursos

Valores de propiedad

labs/virtualmachines

LabVirtualMachineProperties

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de los recursos

Valores de propiedad

labs/virtualmachines

LabVirtualMachineProperties

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Comentarios

Recursos adicionales