Microsoft.DevTestLab labs/virtualmachines 2018-09-15

Artículo
12/20/2024

Definición de recursos de Bicep

El tipo de recurso labs/virtualmachines 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.DevTestLab/labs/virtualmachines, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2018-09-15' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  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'
          timeZoneId: 'string'
          weeklyRecurrence: {
            time: 'string'
            weekdays: [
              'string'
            ]
          }
        }
        tags: {
          {customized property}: 'string'
        }
      }
    ]
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    userName: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

ArtifactInstallProperties

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

ArtifactParameterProperties

Nombre	Descripción	Valor
nombre	Nombre del parámetro artifact.	cuerda
valor	Valor del parámetro artifact.	cuerda

AttachNewDataDiskOptions

Nombre	Descripción	Valor
diskName	Nombre del disco que se va a conectar.	cuerda
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"

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.	cuerda
hostCaching	Opción de almacenamiento en caché para un disco de datos (es decir, None, ReadOnly, ReadWrite).	'Ninguno' 'ReadOnly' "ReadWrite"

DayDetails

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

GalleryImageReference

Nombre	Descripción	Valor
ofrecer	Oferta de la imagen de la galería.	cuerda
osType	Tipo de sistema operativo de la imagen de la galería.	cuerda
editor	Publicador de la imagen de la galería.	cuerda
Sku	SKU de la imagen de la galería.	cuerda
Versión	Versión de la imagen de la galería.	cuerda

HourDetails

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

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. Los valores posibles oscilan entre 1 y 65535, ambos incluidos. Si no se especifica, se asignará automáticamente un valor.	Int
transportProtocol	Protocolo de transporte para el punto de conexión.	'Tcp' 'Udp'

LabVirtualMachineProperties

Nombre	Descripción	Valor
allowClaim	Indica si otro usuario puede tomar posesión de la máquina virtual.	Bool
Artefactos	Artefactos que se van a instalar en la máquina virtual.	ArtifactInstallProperties[]
createdDate	Fecha de creación de la máquina virtual.	cuerda
customImageId	Identificador de imagen personalizado de la máquina virtual.	cuerda
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.	cuerda
expirationDate	Fecha de expiración de la máquina virtual.	cuerda
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.	cuerda
labVirtualNetworkId	Identificador de red virtual del laboratorio de la máquina virtual.	cuerda
networkInterface	Propiedades de la interfaz de red.	NetworkInterfaceProperties
Notas	Notas de la máquina virtual.	cuerda
ownerObjectId	Identificador de objeto del propietario de la máquina virtual.	cuerda
ownerUserPrincipalName	Nombre principal de usuario del propietario de la máquina virtual.	cuerda
contraseña	Contraseña del administrador de la máquina virtual.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.
planId	Identificador del plan asociado a la imagen de máquina virtual	cuerda
scheduleParameters	Programaciones de máquina virtual que se van a crear	ScheduleCreationParameter[]
tamaño	Tamaño de la máquina virtual.	cuerda
sshKey	Clave SSH del administrador de la máquina virtual.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.
storageType	Tipo de almacenamiento que se va a usar para la máquina virtual (es decir, Estándar, Premium).	cuerda
nombre de usuario	Nombre de usuario de la máquina virtual.	cuerda

Microsoft.DevTestLab/labs/virtualmachines

Nombre	Descripción	Valor
ubicación	Ubicación del recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
padre	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 obtener más información, consulte recurso secundario fuera del recurso primario.	Nombre simbólico del recurso de tipo: laboratorios
Propiedades	Propiedades del recurso.	LabVirtualMachineProperties (obligatorio)
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

NetworkInterfaceProperties

Nombre	Descripción	Valor
dnsName	Nombre DNS.	cuerda
privateIpAddress	Dirección IP privada.	cuerda
publicIpAddress	Dirección IP pública.	cuerda
publicIpAddressId	Identificador de recurso de la dirección IP pública.	cuerda
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).	cuerda
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.	cuerda
subnetId	Identificador de recurso de la subred.	cuerda
virtualNetworkId	Identificador de recurso de la red virtual.	cuerda

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).	cuerda
notificationLocale	Configuración regional que se va a usar al enviar una notificación (la reserva de idiomas no admitidos es EN).	cuerda
estado	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.	cuerda

ResourceTags

Nombre	Descripción	Valor

ScheduleCreationParameter

Nombre	Descripción	Valor
nombre	El nombre de la máquina virtual o el entorno	cuerda
Propiedades	Propiedades de la programación.	scheduleCreationParameterProperties
Etiquetas	Etiquetas del recurso.	scheduleCreationParameterTags

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 notificaciones.	notificationSettings
estado	Estado de la programación (es decir, Habilitado, Deshabilitado)	'Deshabilitado' 'Habilitado'
targetResourceId	Identificador de recurso al que pertenece la programación	cuerda
taskType	El tipo de tarea de la programación (por ejemplo, LabVmsShutdownTask, LabVmAutoStart).	cuerda
timeZoneId	El identificador de zona horaria (por ejemplo, hora estándar de China, hora estándar de Groenlandia, hora estándar del Pacífico, etc.). Los valores posibles para esta propiedad se pueden encontrar en `IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds` (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)	cuerda
weeklyRecurrence	Si la programación solo se producirá algunos días de la semana, especifique la periodicidad semanal.	WeekDetails

ScheduleCreationParameterTags

Nombre	Descripción	Valor

SharedPublicIpAddressConfiguration

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

WeekDetails

Nombre	Descripción	Valor
Hora	Hora del día en que se producirá la programación.	cuerda
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[]

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep	Descripción
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 en https://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 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.DevTestLab/labs/virtualmachines, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.DevTestLab/labs/virtualmachines",
  "apiVersion": "2018-09-15",
  "name": "string",
  "location": "string",
  "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",
          "timeZoneId": "string",
          "weeklyRecurrence": {
            "time": "string",
            "weekdays": [ "string" ]
          }
        },
        "tags": {
          "{customized property}": "string"
        }
      }
    ],
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "userName": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

ArtifactInstallProperties

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

ArtifactParameterProperties

Nombre	Descripción	Valor
nombre	Nombre del parámetro artifact.	cuerda
valor	Valor del parámetro artifact.	cuerda

AttachNewDataDiskOptions

Nombre	Descripción	Valor
diskName	Nombre del disco que se va a conectar.	cuerda
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"

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.	cuerda
hostCaching	Opción de almacenamiento en caché para un disco de datos (es decir, None, ReadOnly, ReadWrite).	'Ninguno' 'ReadOnly' "ReadWrite"

DayDetails

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

GalleryImageReference

Nombre	Descripción	Valor
ofrecer	Oferta de la imagen de la galería.	cuerda
osType	Tipo de sistema operativo de la imagen de la galería.	cuerda
editor	Publicador de la imagen de la galería.	cuerda
Sku	SKU de la imagen de la galería.	cuerda
Versión	Versión de la imagen de la galería.	cuerda

HourDetails

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

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. Los valores posibles oscilan entre 1 y 65535, ambos incluidos. Si no se especifica, se asignará automáticamente un valor.	Int
transportProtocol	Protocolo de transporte para el punto de conexión.	'Tcp' 'Udp'

LabVirtualMachineProperties

Nombre	Descripción	Valor
allowClaim	Indica si otro usuario puede tomar posesión de la máquina virtual.	Bool
Artefactos	Artefactos que se van a instalar en la máquina virtual.	ArtifactInstallProperties[]
createdDate	Fecha de creación de la máquina virtual.	cuerda
customImageId	Identificador de imagen personalizado de la máquina virtual.	cuerda
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.	cuerda
expirationDate	Fecha de expiración de la máquina virtual.	cuerda
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.	cuerda
labVirtualNetworkId	Identificador de red virtual del laboratorio de la máquina virtual.	cuerda
networkInterface	Propiedades de la interfaz de red.	NetworkInterfaceProperties
Notas	Notas de la máquina virtual.	cuerda
ownerObjectId	Identificador de objeto del propietario de la máquina virtual.	cuerda
ownerUserPrincipalName	Nombre principal de usuario del propietario de la máquina virtual.	cuerda
contraseña	Contraseña del administrador de la máquina virtual.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.
planId	Identificador del plan asociado a la imagen de máquina virtual	cuerda
scheduleParameters	Programaciones de máquina virtual que se van a crear	ScheduleCreationParameter[]
tamaño	Tamaño de la máquina virtual.	cuerda
sshKey	Clave SSH del administrador de la máquina virtual.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.
storageType	Tipo de almacenamiento que se va a usar para la máquina virtual (es decir, Estándar, Premium).	cuerda
nombre de usuario	Nombre de usuario de la máquina virtual.	cuerda

Microsoft.DevTestLab/labs/virtualmachines

Nombre	Descripción	Valor
apiVersion	La versión de api	'2018-09-15'
ubicación	Ubicación del recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades del recurso.	LabVirtualMachineProperties (obligatorio)
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	'Microsoft.DevTestLab/labs/virtualmachines'

NetworkInterfaceProperties

Nombre	Descripción	Valor
dnsName	Nombre DNS.	cuerda
privateIpAddress	Dirección IP privada.	cuerda
publicIpAddress	Dirección IP pública.	cuerda
publicIpAddressId	Identificador de recurso de la dirección IP pública.	cuerda
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).	cuerda
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.	cuerda
subnetId	Identificador de recurso de la subred.	cuerda
virtualNetworkId	Identificador de recurso de la red virtual.	cuerda

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).	cuerda
notificationLocale	Configuración regional que se va a usar al enviar una notificación (la reserva de idiomas no admitidos es EN).	cuerda
estado	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.	cuerda

ResourceTags

Nombre	Descripción	Valor

ScheduleCreationParameter

Nombre	Descripción	Valor
nombre	El nombre de la máquina virtual o el entorno	cuerda
Propiedades	Propiedades de la programación.	scheduleCreationParameterProperties
Etiquetas	Etiquetas del recurso.	scheduleCreationParameterTags

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 notificaciones.	notificationSettings
estado	Estado de la programación (es decir, Habilitado, Deshabilitado)	'Deshabilitado' 'Habilitado'
targetResourceId	Identificador de recurso al que pertenece la programación	cuerda
taskType	El tipo de tarea de la programación (por ejemplo, LabVmsShutdownTask, LabVmAutoStart).	cuerda
timeZoneId	El identificador de zona horaria (por ejemplo, hora estándar de China, hora estándar de Groenlandia, hora estándar del Pacífico, etc.). Los valores posibles para esta propiedad se pueden encontrar en `IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds` (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)	cuerda
weeklyRecurrence	Si la programación solo se producirá algunos días de la semana, especifique la periodicidad semanal.	WeekDetails

ScheduleCreationParameterTags

Nombre	Descripción	Valor

SharedPublicIpAddressConfiguration

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

WeekDetails

Nombre	Descripción	Valor
Hora	Hora del día en que se producirá la programación.	cuerda
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 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 en https://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 destinadas a:

grupos de recursos de

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.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"
  tags = {
    {customized property} = "string"
  }
  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"
            timeZoneId = "string"
            weeklyRecurrence = {
              time = "string"
              weekdays = [
                "string"
              ]
            }
          }
          tags = {
            {customized property} = "string"
          }
        }
      ]
      size = "string"
      sshKey = "string"
      storageType = "string"
      userName = "string"
    }
  })
}

Valores de propiedad

ArtifactInstallProperties

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

ArtifactParameterProperties

Nombre	Descripción	Valor
nombre	Nombre del parámetro artifact.	cuerda
valor	Valor del parámetro artifact.	cuerda

AttachNewDataDiskOptions

Nombre	Descripción	Valor
diskName	Nombre del disco que se va a conectar.	cuerda
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"

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.	cuerda
hostCaching	Opción de almacenamiento en caché para un disco de datos (es decir, None, ReadOnly, ReadWrite).	'Ninguno' 'ReadOnly' "ReadWrite"

DayDetails

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

GalleryImageReference

Nombre	Descripción	Valor
ofrecer	Oferta de la imagen de la galería.	cuerda
osType	Tipo de sistema operativo de la imagen de la galería.	cuerda
editor	Publicador de la imagen de la galería.	cuerda
Sku	SKU de la imagen de la galería.	cuerda
Versión	Versión de la imagen de la galería.	cuerda

HourDetails

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

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. Los valores posibles oscilan entre 1 y 65535, ambos incluidos. Si no se especifica, se asignará automáticamente un valor.	Int
transportProtocol	Protocolo de transporte para el punto de conexión.	'Tcp' 'Udp'

LabVirtualMachineProperties

Nombre	Descripción	Valor
allowClaim	Indica si otro usuario puede tomar posesión de la máquina virtual.	Bool
Artefactos	Artefactos que se van a instalar en la máquina virtual.	ArtifactInstallProperties[]
createdDate	Fecha de creación de la máquina virtual.	cuerda
customImageId	Identificador de imagen personalizado de la máquina virtual.	cuerda
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.	cuerda
expirationDate	Fecha de expiración de la máquina virtual.	cuerda
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.	cuerda
labVirtualNetworkId	Identificador de red virtual del laboratorio de la máquina virtual.	cuerda
networkInterface	Propiedades de la interfaz de red.	NetworkInterfaceProperties
Notas	Notas de la máquina virtual.	cuerda
ownerObjectId	Identificador de objeto del propietario de la máquina virtual.	cuerda
ownerUserPrincipalName	Nombre principal de usuario del propietario de la máquina virtual.	cuerda
contraseña	Contraseña del administrador de la máquina virtual.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.
planId	Identificador del plan asociado a la imagen de máquina virtual	cuerda
scheduleParameters	Programaciones de máquina virtual que se van a crear	ScheduleCreationParameter[]
tamaño	Tamaño de la máquina virtual.	cuerda
sshKey	Clave SSH del administrador de la máquina virtual.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.
storageType	Tipo de almacenamiento que se va a usar para la máquina virtual (es decir, Estándar, Premium).	cuerda
nombre de usuario	Nombre de usuario de la máquina virtual.	cuerda

Microsoft.DevTestLab/labs/virtualmachines

Nombre	Descripción	Valor
ubicación	Ubicación del recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
parent_id	Identificador del recurso que es el elemento primario de este recurso.	Identificador del recurso de tipo: laboratorios
Propiedades	Propiedades del recurso.	LabVirtualMachineProperties (obligatorio)
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"

NetworkInterfaceProperties

Nombre	Descripción	Valor
dnsName	Nombre DNS.	cuerda
privateIpAddress	Dirección IP privada.	cuerda
publicIpAddress	Dirección IP pública.	cuerda
publicIpAddressId	Identificador de recurso de la dirección IP pública.	cuerda
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).	cuerda
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.	cuerda
subnetId	Identificador de recurso de la subred.	cuerda
virtualNetworkId	Identificador de recurso de la red virtual.	cuerda

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).	cuerda
notificationLocale	Configuración regional que se va a usar al enviar una notificación (la reserva de idiomas no admitidos es EN).	cuerda
estado	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.	cuerda

ResourceTags

Nombre	Descripción	Valor

ScheduleCreationParameter

Nombre	Descripción	Valor
nombre	El nombre de la máquina virtual o el entorno	cuerda
Propiedades	Propiedades de la programación.	scheduleCreationParameterProperties
Etiquetas	Etiquetas del recurso.	scheduleCreationParameterTags

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 notificaciones.	notificationSettings
estado	Estado de la programación (es decir, Habilitado, Deshabilitado)	'Deshabilitado' 'Habilitado'
targetResourceId	Identificador de recurso al que pertenece la programación	cuerda
taskType	El tipo de tarea de la programación (por ejemplo, LabVmsShutdownTask, LabVmAutoStart).	cuerda
timeZoneId	El identificador de zona horaria (por ejemplo, hora estándar de China, hora estándar de Groenlandia, hora estándar del Pacífico, etc.). Los valores posibles para esta propiedad se pueden encontrar en `IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds` (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)	cuerda
weeklyRecurrence	Si la programación solo se producirá algunos días de la semana, especifique la periodicidad semanal.	WeekDetails

ScheduleCreationParameterTags

Nombre	Descripción	Valor

SharedPublicIpAddressConfiguration

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

WeekDetails

Nombre	Descripción	Valor
Hora	Hora del día en que se producirá la programación.	cuerda
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[]

Compartir a través de

Microsoft.DevTestLab labs/virtualmachines 2018-09-15

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Ejemplos de inicio rápido

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Comentarios

Recursos adicionales