Microsoft.DevTestLab labs/virtualmachines 2018-09-15

Artikel
08/13/2023

Bicep-resursdefinition

Resurstypen labs/virtualmachines kan distribueras med åtgärder som mål:

Resursgrupper – Se kommandon för resursgruppsdistribution

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.DevTestLab/labs/virtualmachines-resurs lägger du till följande Bicep i mallen.

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

Egenskapsvärden

labs/virtualmachines

Name	Beskrivning	Värde
name	Resursnamnet Se hur du anger namn och typer för underordnade resurser i Bicep.	sträng (krävs) Teckengräns: 1–15 (Windows) 1–64 (Linux) Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja och sluta med alfanumeriskt. Det kan inte vara alla tal.
location	Platsen för resursen.	sträng
tags	Taggarna för resursen.	Ordlista med taggnamn och värden. Se Taggar i mallar
parent	I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen. Mer information finns i Underordnad resurs utanför överordnad resurs.	Symboliskt namn för resurs av typen: labb
properties	Egenskaperna för resursen.	LabVirtualMachineProperties (krävs)

LabVirtualMachineProperties

Name	Beskrivning	Värde
allowClaim	Anger om en annan användare kan bli ägare till den virtuella datorn	boolesk
Artefakter	Artefakterna som ska installeras på den virtuella datorn.	ArtifactInstallProperties[]
createdDate	Skapandedatumet för den virtuella datorn.	sträng
customImageId	Den virtuella datorns anpassade avbildningsidentifierare.	sträng
dataDiskParameters	Nya eller befintliga datadiskar som ska anslutas till den virtuella datorn när de har skapats	DataDiskProperties[]
tillåt intePublicIpAddress	Anger om den virtuella datorn ska skapas utan en offentlig IP-adress.	boolesk
environmentId	Resurs-ID för miljön som innehåller den här virtuella datorn, om sådan finns.	sträng
expirationDate	Förfallodatum för den virtuella datorn.	sträng
galleryImageReference	Microsoft Azure Marketplace avbildningsreferens för den virtuella datorn.	GalleryImageReference
isAuthenticationWithSshKey	Anger om den här virtuella datorn använder en SSH-nyckel för autentisering.	boolesk
labSubnetName	Namnet på den virtuella datorns labbundernät.	sträng
labVirtualNetworkId	Labb-ID för det virtuella nätverket för den virtuella datorn.	sträng
networkInterface	Egenskaperna för nätverksgränssnittet.	NetworkInterfaceProperties
anteckningar	Anteckningarna för den virtuella datorn.	sträng
ownerObjectId	Objektidentifieraren för den virtuella datorns ägare.	sträng
ownerUserPrincipalName	Användarens huvudnamn för den virtuella datorns ägare.	sträng
password	Lösenordet för den virtuella datoradministratören.	sträng
planId	ID:t för planen som är associerad med avbildningen av den virtuella datorn	sträng
scheduleParameters	Scheman för virtuella datorer som ska skapas	ScheduleCreationParameter[]
ikoner	Storleken på den virtuella datorn.	sträng
sshKey	SSH-nyckeln för den virtuella datoradministratören.	sträng
storageType	Lagringstyp som ska användas för virtuella datorer (t.ex. Standard, Premium).	sträng
userName	Användarnamnet för den virtuella datorn.	sträng

ArtifactInstallProperties

Name	Beskrivning	Värde
artifactId	Artefaktens identifierare.	sträng
artifactTitle	Artefaktens rubrik.	sträng
deploymentStatusMessage	Statusmeddelandet från distributionen.	sträng
installTime	Den tid då artefakten börjar installeras på den virtuella datorn.	sträng
parametrar	Parametrarna för artefakten.	ArtifactParameterProperties[]
status	Artefaktens status.	sträng
vmExtensionStatusMessage	Statusmeddelandet från tillägget för den virtuella datorn.	sträng

ArtifactParameterProperties

Name	Beskrivning	Värde
name	Namnet på artefaktparametern.	sträng
värde	Värdet för artefaktparametern.	sträng

DataDiskProperties

Name	Beskrivning	Värde
attachNewDataDiskOptions	Anger alternativ för att ansluta en ny disk till den virtuella datorn.	AttachNewDataDiskOptions
existingLabDiskId	Anger det befintliga labbdisk-ID:t som ska anslutas till den virtuella datorn.	sträng
hostCaching	Cachelagringsalternativ för en datadisk (t.ex. Ingen, ReadOnly, ReadWrite).	"Ingen" "ReadOnly" 'ReadWrite'

AttachNewDataDiskOptions

Name	Beskrivning	Värde
diskName	Namnet på den disk som ska anslutas.	sträng
diskSizeGiB	Storleken på disken som ska anslutas i Gibibytes.	int
Disktype	Lagringstypen för disken (t.ex. Standard, Premium).	"Premium" "Standard" "StandardSSD"

GalleryImageReference

Name	Beskrivning	Värde
offer	Galleribildens erbjudande.	sträng
osType	Galleriavbildningens operativsystemtyp.	sträng
utgivare	Utgivaren av galleribilden.	sträng
sku	SKU:n för galleribilden.	sträng
version	Versionen av galleribilden.	sträng

NetworkInterfaceProperties

Name	Beskrivning	Värde
dnsName	DNS-namnet.	sträng
privateIpAddress	Den privata IP-adressen.	sträng
publicIpAddress	Den offentliga IP-adressen.	sträng
publicIpAddressId	Resurs-ID för den offentliga IP-adressen.	sträng
rdpAuthority	Egenskapen RdpAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för RDP (Remote Desktop Protocol).	sträng
sharedPublicIpAddressConfiguration	Konfigurationen för att dela en offentlig IP-adress mellan flera virtuella datorer.	SharedPublicIpAddressConfiguration
sshAuthority	Egenskapen SshAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för SSH.	sträng
subnetId	Resurs-ID för undernätet.	sträng
virtualNetworkId	Resurs-ID för det virtuella nätverket.	sträng

SharedPublicIpAddressConfiguration

Name	Beskrivning	Värde
inboundNatRules	Inkommande NAT-regler	InboundNatRule[]

InboundNatRule

Name	Beskrivning	Värde
backendPort	Porten som den externa trafiken ska omdirigeras till.	int
frontendPort	Den externa slutpunktsporten för den inkommande anslutningen. Möjliga värden mellan 1 och 65535, inklusive. Om det inte anges allokeras ett värde automatiskt.	int
transportProtocol	Transportprotokollet för slutpunkten.	"Tcp" "Udp"

ScheduleCreationParameter

Name	Beskrivning	Värde
name	Namnet på den virtuella datorn eller miljön	sträng
properties	Egenskaperna för schemat.	ScheduleCreationParameterProperties
tags	Taggarna för resursen.	objekt

ScheduleCreationParameterProperties

Name	Beskrivning	Värde
dailyRecurrence	Om schemat ska ske en gång varje dag i veckan anger du den dagliga upprepningen.	DayDetails
hourlyRecurrence	Om schemat ska ske flera gånger om dagen anger du upprepningen varje timme.	HourDetails
notificationSettings	Meddelandeinställningar.	NotificationSettings
status	Status för schemat (t.ex. Aktiverad, Inaktiverad)	"Inaktiverad" "Aktiverad"
targetResourceId	Det resurs-ID som schemat tillhör	sträng
taskType	Uppgiftstypen för schemat (t.ex. LabVmsShutdownTask, LabVmAutoStart).	sträng
weeklyRecurrence	Om schemat bara inträffar några dagar i veckan anger du veckovis upprepning.	WeekDetails

DayDetails

Name	Beskrivning	Värde
time	Den tid på dagen som schemat inträffar.	sträng

HourDetails

Name	Beskrivning	Värde
minut	Minuter av timmen som schemat körs.	int

NotificationSettings

Name	Beskrivning	Värde
emailRecipient	E-postmottagaren att skicka meddelanden till (kan vara en lista över semikolonavgränsade e-postadresser).	sträng
notificationLocale	Språkvarianten som ska användas när du skickar ett meddelande (återställning för språk som inte stöds är EN).	sträng
status	Om meddelanden är aktiverade för det här schemat (t.ex. aktiverat, inaktiverat).	"Inaktiverad" "Aktiverad"
timeInMinutes	Tid i minuter före händelsen då meddelandet skickas.	int
webhookUrl	Webhookens URL som meddelandet ska skickas till.	sträng

WeekDetails

Name	Beskrivning	Värde
time	Den tid på dagen som schemat kommer att ske.	sträng
Vardagar	De veckodagar som schemat anges för (t.ex. söndag, måndag, tisdag osv.).	string[]

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall	Description
Skapar ett labb i Azure DevTest Labs med en virtuell Windows Server-dator	Den här mallen skapar en ny DevTest Lab/DTL-instans med en virtuell Windows Server 2019 Datacenter-dator i den. Fler Azure Resource Manager snabbstartsmallar för Azure DevTest Labs tillgängliga påhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Skapar ett labb i Azure DevTest Labs med en påstådd virtuell dator	Den här mallen skapar en ny DevTest Lab/DTL-instans med en påstådd virtuell Windows Server 2019 Datacenter-dator i den. Fler Azure Resource Manager snabbstartsmallar för Azure DevTest Labs tillgängliga påhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Resursdefinition för ARM-mall

Resurstypen labs/virtualmachines kan distribueras med åtgärder som mål:

Resursgrupper – Se distributionskommandon för resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.DevTestLab/labs/virtualmachines-resurs lägger du till följande JSON i mallen.

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

Egenskapsvärden

labs/virtualmachines

Name	Beskrivning	Värde
typ	Resurstypen	"Microsoft.DevTestLab/labs/virtualmachines"
apiVersion	Resurs-API-versionen	'2018-09-15'
name	Resursnamnet Se hur du anger namn och typer för underordnade resurser i JSON ARM-mallar.	sträng (krävs) Teckengräns: 1–15 (Windows) 1–64 (Linux) Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja och sluta med alfanumeriskt. Det kan inte vara alla siffror.
location	Platsen för resursen.	sträng
tags	Resursens taggar.	Ordlista med taggnamn och värden. Se Taggar i mallar
properties	Egenskaperna för resursen.	LabVirtualMachineEgenskaper (krävs)

LabVirtualMachineEgenskaper

Name	Beskrivning	Värde
allowClaim	Anger om en annan användare kan ta över ägarskapet för den virtuella datorn	boolesk
Artefakter	Artefakterna som ska installeras på den virtuella datorn.	ArtifactInstallProperties[]
createdDate	Skapandedatumet för den virtuella datorn.	sträng
customImageId	Den virtuella datorns anpassade avbildningsidentifierare.	sträng
dataDiskParameters	Nya eller befintliga datadiskar som ska anslutas till den virtuella datorn när de har skapats	DataDiskProperties[]
tillåt intePublicIpAddress	Anger om den virtuella datorn ska skapas utan en offentlig IP-adress.	boolesk
environmentId	Resurs-ID för miljön som innehåller den här virtuella datorn, om sådan finns.	sträng
expirationDate	Förfallodatum för den virtuella datorn.	sträng
galleryImageReference	Microsoft Azure Marketplace avbildningsreferens för den virtuella datorn.	GalleryImageReference
isAuthenticationWithSshKey	Anger om den här virtuella datorn använder en SSH-nyckel för autentisering.	boolesk
labSubnetName	Namnet på den virtuella datorns labbundernät.	sträng
labVirtualNetworkId	Labb-ID för det virtuella nätverket för den virtuella datorn.	sträng
networkInterface	Egenskaperna för nätverksgränssnittet.	NetworkInterfaceProperties
anteckningar	Anteckningarna för den virtuella datorn.	sträng
ownerObjectId	Objektidentifieraren för den virtuella datorns ägare.	sträng
ownerUserPrincipalName	Användarens huvudnamn för den virtuella datorns ägare.	sträng
password	Lösenordet för den virtuella datoradministratören.	sträng
planId	ID:t för planen som är associerad med avbildningen av den virtuella datorn	sträng
scheduleParameters	Scheman för virtuella datorer som ska skapas	ScheduleCreationParameter[]
ikoner	Storleken på den virtuella datorn.	sträng
sshKey	SSH-nyckeln för den virtuella datoradministratören.	sträng
storageType	Lagringstyp som ska användas för virtuella datorer (t.ex. Standard, Premium).	sträng
userName	Användarnamnet för den virtuella datorn.	sträng

ArtifactInstallProperties

Name	Beskrivning	Värde
artifactId	Artefaktens identifierare.	sträng
artifactTitle	Artefaktens rubrik.	sträng
deploymentStatusMessage	Statusmeddelandet från distributionen.	sträng
installTime	Den tid då artefakten börjar installeras på den virtuella datorn.	sträng
parametrar	Parametrarna för artefakten.	ArtifactParameterProperties[]
status	Artefaktens status.	sträng
vmExtensionStatusMessage	Statusmeddelandet från tillägget för den virtuella datorn.	sträng

ArtifactParameterProperties

Name	Beskrivning	Värde
name	Namnet på artefaktparametern.	sträng
värde	Värdet för artefaktparametern.	sträng

DataDiskProperties

Name	Beskrivning	Värde
attachNewDataDiskOptions	Anger alternativ för att ansluta en ny disk till den virtuella datorn.	AttachNewDataDiskOptions
existingLabDiskId	Anger det befintliga labbdisk-ID:t som ska anslutas till den virtuella datorn.	sträng
hostCaching	Cachelagringsalternativ för en datadisk (t.ex. Ingen, ReadOnly, ReadWrite).	"Ingen" "ReadOnly" "Skriv upp"

AttachNewDataDiskOptions

Name	Beskrivning	Värde
diskName	Namnet på den disk som ska kopplas.	sträng
diskSizeGiB	Storleken på disken som ska anslutas i Gibibytes.	int
Disktype	Lagringstypen för disken (t.ex. Standard, Premium).	"Premium" "Standard" "StandardSSD"

GalleryImageReference

Name	Beskrivning	Värde
offer	Galleribildens erbjudande.	sträng
osType	Galleriavbildningens operativsystemtyp.	sträng
utgivare	Utgivaren av galleribilden.	sträng
sku	SKU:n för galleribilden.	sträng
version	Versionen av galleribilden.	sträng

NetworkInterfaceProperties

Name	Beskrivning	Värde
dnsName	DNS-namnet.	sträng
privateIpAddress	Den privata IP-adressen.	sträng
publicIpAddress	Den offentliga IP-adressen.	sträng
publicIpAddressId	Resurs-ID för den offentliga IP-adressen.	sträng
rdpAuthority	Egenskapen RdpAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för RDP (Remote Desktop Protocol).	sträng
sharedPublicIpAddressConfiguration	Konfigurationen för att dela en offentlig IP-adress mellan flera virtuella datorer.	SharedPublicIpAddressConfiguration
sshAuthority	Egenskapen SshAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för SSH.	sträng
subnetId	Resurs-ID för undernätet.	sträng
virtualNetworkId	Resurs-ID för det virtuella nätverket.	sträng

SharedPublicIpAddressConfiguration

Name	Beskrivning	Värde
inboundNatRules	Inkommande NAT-regler	InboundNatRule[]

InboundNatRule

Name	Beskrivning	Värde
backendPort	Porten som den externa trafiken ska omdirigeras till.	int
frontendPort	Den externa slutpunktsporten för den inkommande anslutningen. Möjliga värden sträcker sig mellan 1 och 65535, inklusive. Om det är ospecificerat allokeras ett värde automatiskt.	int
transportProtocol	Transportprotokollet för slutpunkten.	"Tcp" "Udp"

ScheduleCreationParameter

Name	Beskrivning	Värde
name	Namnet på den virtuella datorn eller miljön	sträng
properties	Egenskaperna för schemat.	ScheduleCreationParameterEgenskaper
tags	Resursens taggar.	objekt

ScheduleCreationParameterEgenskaper

Name	Beskrivning	Värde
dailyRecurrence	Om schemat inträffar en gång varje dag i veckan anger du den dagliga upprepningen.	DayDetails
hourlyRecurrence	Om schemat inträffar flera gånger om dagen anger du upprepningen varje timme.	HourDetails
notificationSettings	Meddelandeinställningar.	NotificationSettings
status	Status för schemat (dvs. Aktiverad, Inaktiverad)	"Inaktiverad" "Aktiverad"
targetResourceId	Det resurs-ID som schemat tillhör	sträng
taskType	Uppgiftstypen för schemat (t.ex. LabVmsShutdownTask, LabVmAutoStart).	sträng
weeklyRecurrence	Om schemat bara inträffar några dagar i veckan anger du veckovis upprepning.	WeekDetails

DayDetails

Name	Beskrivning	Värde
time	Tid på dagen schemat kommer att ske.	sträng

HourDetails

Name	Beskrivning	Värde
minut	Minuter av timmen som schemat körs.	int

NotificationSettings

Name	Beskrivning	Värde
emailRecipient	E-postmottagaren att skicka meddelanden till (kan vara en lista över semikolonavgränsade e-postadresser).	sträng
notificationLocale	Språkvarianten som ska användas när du skickar ett meddelande (återställning för språk som inte stöds är EN).	sträng
status	Om meddelanden är aktiverade för det här schemat (t.ex. aktiverat, inaktiverat).	"Inaktiverad" "Aktiverad"
timeInMinutes	Tid i minuter före händelsen då meddelandet skickas.	int
webhookUrl	Webhookens URL som meddelandet ska skickas till.	sträng

WeekDetails

Name	Beskrivning	Värde
time	Den tid på dagen som schemat kommer att ske.	sträng
Vardagar	De veckodagar som schemat anges för (t.ex. söndag, måndag, tisdag osv.).	string[]

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall	Description
Skapar ett labb i Azure DevTest Labs med en virtuell Windows Server-dator	Den här mallen skapar en ny DevTest Lab/DTL-instans med en virtuell Windows Server 2019 Datacenter-dator i den. Fler Azure Resource Manager snabbstartsmallar för Azure DevTest Labs tillgängliga påhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Skapar ett labb i Azure DevTest Labs med en påstådd virtuell dator	Den här mallen skapar en ny DevTest Lab/DTL-instans med en påstådd virtuell Windows Server 2019 Datacenter-dator i den. Fler Azure Resource Manager snabbstartsmallar för Azure DevTest Labs tillgängliga påhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen labs/virtualmachines kan distribueras med åtgärder som mål:

Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.DevTestLab/labs/virtualmachines-resurs lägger du till följande Terraform i mallen.

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

Egenskapsvärden

labs/virtualmachines

Name	Beskrivning	Värde
typ	Resurstypen	"Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
name	Resursnamnet	sträng (krävs) Teckengräns: 1–15 (Windows) 1–64 (Linux) Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja och sluta med alfanumeriskt. Det kan inte vara alla siffror.
location	Platsen för resursen.	sträng
parent_id	ID:t för resursen som är överordnad för den här resursen.	ID för resurs av typen: labb
tags	Resursens taggar.	Ordlista med taggnamn och värden.
properties	Egenskaperna för resursen.	LabVirtualMachineEgenskaper (krävs)

LabVirtualMachineEgenskaper

Name	Beskrivning	Värde
allowClaim	Anger om en annan användare kan ta över ägarskapet för den virtuella datorn	boolesk
Artefakter	Artefakterna som ska installeras på den virtuella datorn.	ArtifactInstallProperties[]
createdDate	Skapandedatumet för den virtuella datorn.	sträng
customImageId	Den virtuella datorns anpassade avbildningsidentifierare.	sträng
dataDiskParameters	Nya eller befintliga datadiskar som ska anslutas till den virtuella datorn när de har skapats	DataDiskProperties[]
disallowPublicIpAddress	Anger om den virtuella datorn ska skapas utan en offentlig IP-adress.	boolesk
environmentId	Resurs-ID för miljön som innehåller den här virtuella datorn, om sådan finns.	sträng
expirationDate	Förfallodatumet för den virtuella datorn.	sträng
galleryImageReference	Microsoft Azure Marketplace avbildningsreferens för den virtuella datorn.	GalleryImageReference
isAuthenticationWithSshKey	Anger om den här virtuella datorn använder en SSH-nyckel för autentisering.	boolesk
labSubnetName	Labbundernätets namn på den virtuella datorn.	sträng
labVirtualNetworkId	Labbidentifieraren för det virtuella nätverket för den virtuella datorn.	sträng
networkInterface	Egenskaperna för nätverksgränssnittet.	NetworkInterfaceProperties
anteckningar	Anteckningarna för den virtuella datorn.	sträng
ownerObjectId	Objektidentifieraren för den virtuella datorns ägare.	sträng
ownerUserPrincipalName	Användarens huvudnamn för den virtuella datorns ägare.	sträng
password	Lösenordet för den virtuella datoradministratören.	sträng
planId	ID för planen som är associerad med avbildningen av den virtuella datorn	sträng
scheduleParameters	Scheman för virtuella datorer som ska skapas	ScheduleCreationParameter[]
ikoner	Storleken på den virtuella datorn.	sträng
sshKey	SSH-nyckeln för den virtuella datoradministratören.	sträng
storageType	Lagringstyp som ska användas för virtuella datorer (t.ex. Standard, Premium).	sträng
userName	Användarnamnet för den virtuella datorn.	sträng

ArtifactInstallProperties

Name	Beskrivning	Värde
artifactId	Artefaktens identifierare.	sträng
artifactTitle	Artefaktens rubrik.	sträng
deploymentStatusMessage	Statusmeddelandet från distributionen.	sträng
installTime	Den tid då artefakten börjar installeras på den virtuella datorn.	sträng
parametrar	Parametrarna för artefakten.	ArtifactParameterProperties[]
status	Artefaktens status.	sträng
vmExtensionStatusMessage	Statusmeddelandet från tillägget för den virtuella datorn.	sträng

ArtifactParameterProperties

Name	Beskrivning	Värde
name	Namnet på artefaktparametern.	sträng
värde	Värdet för artefaktparametern.	sträng

DataDiskProperties

Name	Beskrivning	Värde
attachNewDataDiskOptions	Anger alternativ för att ansluta en ny disk till den virtuella datorn.	AttachNewDataDiskOptions
existingLabDiskId	Anger det befintliga labbdisk-ID:t som ska anslutas till den virtuella datorn.	sträng
hostCaching	Cachelagringsalternativ för en datadisk (t.ex. Ingen, ReadOnly, ReadWrite).	"Ingen" "ReadOnly" "ReadWrite"

AttachNewDataDiskOptions

Name	Beskrivning	Värde
diskName	Namnet på den disk som ska anslutas.	sträng
diskSizeGiB	Storleken på disken som ska anslutas i Gibibytes.	int
Disktype	Lagringstypen för disken (t.ex. Standard, Premium).	"Premium" "Standard" "StandardSSD"

GalleryImageReference

Name	Beskrivning	Värde
offer	Galleribildens erbjudande.	sträng
osType	Galleriavbildningens operativsystemtyp.	sträng
utgivare	Utgivaren av galleribilden.	sträng
sku	SKU:n för galleribilden.	sträng
version	Versionen av galleribilden.	sträng

NetworkInterfaceProperties

Name	Beskrivning	Värde
dnsName	DNS-namnet.	sträng
privateIpAddress	Den privata IP-adressen.	sträng
publicIpAddress	Den offentliga IP-adressen.	sträng
publicIpAddressId	Resurs-ID för den offentliga IP-adressen.	sträng
rdpAuthority	Egenskapen RdpAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för RDP (Remote Desktop Protocol).	sträng
sharedPublicIpAddressConfiguration	Konfigurationen för att dela en offentlig IP-adress mellan flera virtuella datorer.	SharedPublicIpAddressConfiguration
sshAuthority	Egenskapen SshAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för SSH.	sträng
subnetId	Resurs-ID för undernätet.	sträng
virtualNetworkId	Resurs-ID för det virtuella nätverket.	sträng

SharedPublicIpAddressConfiguration

Name	Beskrivning	Värde
inboundNatRules	Inkommande NAT-regler	InboundNatRule[]

InboundNatRule

Name	Beskrivning	Värde
backendPort	Porten som den externa trafiken ska omdirigeras till.	int
frontendPort	Den externa slutpunktsporten för den inkommande anslutningen. Möjliga värden mellan 1 och 65535, inklusive. Om det inte anges allokeras ett värde automatiskt.	int
transportProtocol	Transportprotokollet för slutpunkten.	"Tcp" "Udp"

ScheduleCreationParameter

Name	Beskrivning	Värde
name	Namnet på den virtuella datorn eller miljön	sträng
properties	Egenskaperna för schemat.	ScheduleCreationParameterProperties
tags	Taggarna för resursen.	objekt

ScheduleCreationParameterProperties

Name	Beskrivning	Värde
dailyRecurrence	Om schemat ska ske en gång varje dag i veckan anger du den dagliga upprepningen.	DayDetails
hourlyRecurrence	Om schemat ska ske flera gånger om dagen anger du upprepningen varje timme.	HourDetails
notificationSettings	Meddelandeinställningar.	NotificationSettings
status	Status för schemat (t.ex. Aktiverad, Inaktiverad)	"Inaktiverad" "Aktiverad"
targetResourceId	Det resurs-ID som schemat tillhör	sträng
taskType	Uppgiftstypen för schemat (t.ex. LabVmsShutdownTask, LabVmAutoStart).	sträng
weeklyRecurrence	Om schemat bara inträffar några dagar i veckan anger du veckovis upprepning.	WeekDetails

DayDetails

Name	Beskrivning	Värde
time	Den tid på dagen som schemat inträffar.	sträng

HourDetails

Name	Beskrivning	Värde
minut	Minuter av timmen som schemat körs.	int

NotificationSettings

Name	Beskrivning	Värde
emailRecipient	E-postmottagaren att skicka meddelanden till (kan vara en lista med semikolonavgränsade e-postadresser).	sträng
notificationLocale	Språkvarianten som ska användas när du skickar ett meddelande (återställning för språk som inte stöds är EN).	sträng
status	Om meddelanden är aktiverade för det här schemat (t.ex. aktiverat, inaktiverat).	"Inaktiverad" "Aktiverad"
timeInMinutes	Tid i minuter före händelsen då meddelandet skickas.	int
webhookUrl	Webhookens URL som meddelandet ska skickas till.	sträng

WeekDetails

Name	Beskrivning	Värde
time	Den tid på dagen som schemat kommer att ske.	sträng
Vardagar	De veckodagar som schemat anges för (t.ex. söndag, måndag, tisdag osv.).	string[]

Dela via

Microsoft.DevTestLab labs/virtualmachines 2018-09-15

Bicep-resursdefinition

Resursformat

Egenskapsvärden

labs/virtualmachines

LabVirtualMachineProperties

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Snabbstartsmallar

Resursdefinition för ARM-mall

Resursformat

Egenskapsvärden

labs/virtualmachines

LabVirtualMachineEgenskaper

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterEgenskaper

DayDetails

HourDetails

NotificationSettings

WeekDetails

Snabbstartsmallar

Resursdefinition för Terraform (AzAPI-provider)

Resursformat

Egenskapsvärden

labs/virtualmachines

LabVirtualMachineEgenskaper

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Feedback

Ytterligare resurser