Dela via


Microsoft.DevTestLab labs/virtualmachines 2016-05-15

Bicep-resursdefinition

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

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@2016-05-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    allowClaim: bool
    applicableSchedule: {
      location: 'string'
      properties: {
        labVmsShutdown: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {}
        }
        labVmsStartup: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {}
        }
      }
      tags: {}
      location: 'string'
      properties: {
        labVmsShutdown: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {}
        }
        labVmsStartup: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {}
        }
      }
      tags: {}
    }
    artifactDeploymentStatus: {
      artifactsApplied: int
      deploymentStatus: 'string'
      totalArtifacts: int
    }
    artifacts: [
      {
        artifactId: 'string'
        deploymentStatusMessage: 'string'
        installTime: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
        status: 'string'
        vmExtensionStatusMessage: 'string'
      }
    ]
    computeVm: {
      dataDiskIds: [
        'string'
      ]
      dataDisks: [
        {
          diskSizeGiB: int
          diskUri: 'string'
          managedDiskId: 'string'
          name: 'string'
        }
      ]
      networkInterfaceId: 'string'
      osDiskId: 'string'
      osType: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          message: 'string'
        }
      ]
      vmSize: 'string'
    }
    createdByUser: 'string'
    createdByUserId: 'string'
    createdDate: 'string'
    customImageId: 'string'
    disallowPublicIpAddress: bool
    environmentId: 'string'
    expirationDate: 'string'
    fqdn: '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'
    osType: 'string'
    ownerObjectId: 'string'
    ownerUserPrincipalName: 'string'
    password: 'string'
    provisioningState: 'string'
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    uniqueIdentifier: 'string'
    userName: 'string'
    virtualMachineCreationSource: '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
applicableSchedule Tillämpligt schema för den virtuella datorn. ApplicableSchedule
artifactDeploymentStatus Distributionsstatus för artefakt för den virtuella datorn. ArtifactDeploymentStatusProperties
Artefakter Artefakterna som ska installeras på den virtuella datorn. ArtifactInstallProperties[]
computeVm Egenskaperna för den virtuella beräkningsdatorn. ComputeVmProperties
createdByUser E-postadressen till skaparen av den virtuella datorn. sträng
createdByUserId Objektidentifieraren för den virtuella datorns skapare. sträng
createdDate Skapandedatumet för den virtuella datorn. sträng
customImageId Den virtuella datorns anpassade avbildningsidentifierare. sträng
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
Fqdn Det fullständigt kvalificerade domännamnet 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
osType Operativsystemtypen 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
provisioningState Resursens etableringsstatus. sträng
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
uniqueIdentifier Den unika oföränderliga identifieraren för en resurs (Guid). sträng
userName Användarnamnet för den virtuella datorn. sträng
virtualMachineCreationSource Talar om källan för skapandet av den virtuella labbdatorn. Endast utdataegenskap. "FromCustomImage"
"FromGalleryImage"

ApplicableSchedule

Name Beskrivning Värde
location Platsen för resursen. sträng
properties Egenskaperna för resursen. ApplicableScheduleProperties (krävs)
tags Resursens taggar. objekt
location Platsen för resursen. sträng
properties Egenskaperna för resursen. ApplicableScheduleProperties (krävs)
tags Resursens taggar. objekt

ApplicableScheduleEgenskaper

Name Beskrivning Värde
labVmsShutdown Schemat för automatisk avstängning, om ett har angetts på labb- eller labbresursnivå. Schema
labVmsStartup Schemat för automatisk start, om ett har angetts på labb- eller labbresursnivå. Schema

Schema

Name Beskrivning Värde
location Platsen för resursen. sträng
properties Egenskaperna för resursen. ScheduleProperties (krävs)
tags Resursens taggar. objekt

ScheduleProperties

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
provisioningState Resursens etableringsstatus. sträng
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
timeZoneId Tidszons-ID (t.ex. Pacific Standard-tid). sträng
uniqueIdentifier Den unika oföränderliga identifieraren för en resurs (GUID). 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
status Om meddelanden är aktiverade för det här schemat (t.ex. aktiverat, inaktiverat). "Inaktiverad"
"Aktiverad"
timeInMinutes Tid i minuter innan händelsen då meddelandet skickas. int
webhookUrl Den webhook-URL som meddelandet ska skickas till. sträng

WeekDetails

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

ArtifactDeploymentStatusProperties

Name Beskrivning Värde
artifactsApplied Det totala antalet artefakter som har tillämpats. int
deploymentStatus Distributionsstatus för artefakten. sträng
totalArtifacts Det totala antalet artefakter som tillämpades preliminärt. int

ArtifactInstallProperties

Name Beskrivning Värde
artifactId Artefaktens identifierare. 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

ComputeVmEgenskaper

Name Beskrivning Värde
dataDiskIds Hämtar blob-uri för datadiskar för den virtuella datorn. string[]
dataDisks Hämtar alla datadiskar som är anslutna till den virtuella datorn. ComputeDataDisk[]
networkInterfaceId Hämtar nätverksgränssnitts-ID för den virtuella datorn. sträng
osDiskId Hämtar URI för OS-diskblob för den virtuella datorn. sträng
osType Hämtar operativsystemtypen för den virtuella datorn. sträng
Status Hämtar status för den virtuella datorn. ComputeVmInstanceViewStatus[]
vmSize Hämtar storleken på den virtuella datorn. sträng

ComputeDataDisk

Name Beskrivning Värde
diskSizeGiB Hämtar datadiskstorlek i GiB. int
diskUri När den backas upp av en blob, URI för underliggande blob. sträng
managedDiskId När den backas upp av en hanterad disk är detta ID:t för beräkningsdiskresursen. sträng
name Hämtar datadiskens namn. sträng

ComputeVmInstanceViewStatus

Name Beskrivning Värde
kod Hämtar statuskoden. sträng
displayStatus Hämtar den korta localizable-etiketten för statusen. sträng
meddelande Hämtar meddelandet som är associerat med statusen. sträng

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"

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Description
Skapar ett labb i Azure DevTest Labs med en virtuell Windows Server-dator

Distribuera till Azure
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 finns påhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Skapar ett labb i Azure DevTest Labs med en begärd virtuell dator

Distribuera till Azure
Den här mallen skapar en ny DevTest Lab/DTL-instans med en begärd virtuell Windows Server 2019 Datacenter-dator i den. Fler Azure Resource Manager-snabbstartsmallar för Azure DevTest Labs finns 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:

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": "2016-05-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "allowClaim": "bool",
    "applicableSchedule": {
      "location": "string",
      "properties": {
        "labVmsShutdown": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {}
        },
        "labVmsStartup": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {}
        }
      },
      "tags": {},
      "location": "string",
      "properties": {
        "labVmsShutdown": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {}
        },
        "labVmsStartup": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {}
        }
      },
      "tags": {}
    },
    "artifactDeploymentStatus": {
      "artifactsApplied": "int",
      "deploymentStatus": "string",
      "totalArtifacts": "int"
    },
    "artifacts": [
      {
        "artifactId": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "computeVm": {
      "dataDiskIds": [ "string" ],
      "dataDisks": [
        {
          "diskSizeGiB": "int",
          "diskUri": "string",
          "managedDiskId": "string",
          "name": "string"
        }
      ],
      "networkInterfaceId": "string",
      "osDiskId": "string",
      "osType": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "message": "string"
        }
      ],
      "vmSize": "string"
    },
    "createdByUser": "string",
    "createdByUserId": "string",
    "createdDate": "string",
    "customImageId": "string",
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "string",
    "fqdn": "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",
    "osType": "string",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "provisioningState": "string",
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "uniqueIdentifier": "string",
    "userName": "string",
    "virtualMachineCreationSource": "string"
  }
}

Egenskapsvärden

labs/virtualmachines

Name Beskrivning Värde
typ Resurstypen "Microsoft.DevTestLab/labs/virtualmachines"
apiVersion Resurs-API-versionen '2016-05-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 tal.
location Platsen för resursen. sträng
tags Taggarna för resursen. Ordlista med taggnamn och värden. Se Taggar i mallar
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
applicableSchedule Tillämpligt schema för den virtuella datorn. ApplicableSchedule
artifactDeploymentStatus Distributionsstatus för artefakt för den virtuella datorn. ArtifactDeploymentStatusProperties
Artefakter Artefakterna som ska installeras på den virtuella datorn. ArtifactInstallProperties[]
computeVm Egenskaperna för den virtuella beräkningsdatorn. ComputeVmProperties
createdByUser E-postadressen till skaparen av den virtuella datorn. sträng
createdByUserId Objektidentifieraren för den virtuella datorns skapare. sträng
createdDate Skapandedatumet för den virtuella datorn. sträng
customImageId Den virtuella datorns anpassade avbildningsidentifierare. sträng
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
Fqdn Det fullständigt kvalificerade domännamnet 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
osType Den virtuella datorns operativsystemtyp. 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
provisioningState Resursens etableringsstatus. sträng
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
uniqueIdentifier Den unika oföränderliga identifieraren för en resurs (GUID). sträng
userName Användarnamnet för den virtuella datorn. sträng
virtualMachineCreationSource Meddelar källan för skapandet av den virtuella labbdatorn. Endast utdataegenskap. "FromCustomImage"
"FromGalleryImage"

ApplicableSchedule

Name Beskrivning Värde
location Platsen för resursen. sträng
properties Egenskaperna för resursen. ApplicableScheduleProperties (krävs)
tags Taggarna för resursen. objekt
location Platsen för resursen. sträng
properties Egenskaperna för resursen. ApplicableScheduleProperties (krävs)
tags Taggarna för resursen. objekt

ApplicableScheduleProperties

Name Beskrivning Värde
labVmsShutdown Schemat för automatisk avstängning, om ett har angetts på labb- eller labbresursnivå. Schema
labVmsStartup Schemat för automatisk start, om ett har angetts på labb- eller labbresursnivå. Schema

Schema

Name Beskrivning Värde
location Platsen för resursen. sträng
properties Egenskaperna för resursen. ScheduleProperties (krävs)
tags Resursens taggar. objekt

ScheduleProperties

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
provisioningState Resursens etableringsstatus. sträng
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
timeZoneId Tidszons-ID (t.ex. Pacific Standard-tid). sträng
uniqueIdentifier Den unika oföränderliga identifieraren för en resurs (Guid). 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
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[]

ArtifactDeploymentStatusProperties

Name Beskrivning Värde
artifactsApplied Det totala antalet artefakter som har tillämpats. int
deploymentStatus Distributionsstatus för artefakten. sträng
totalArtifacts Det totala antalet artefakter som tillämpades preliminärt. int

ArtifactInstallProperties

Name Beskrivning Värde
artifactId Artefaktens identifierare. 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

ComputeVmProperties

Name Beskrivning Värde
dataDiskIds Hämtar blob-URI för datadiskar för den virtuella datorn. string[]
dataDisks Hämtar alla datadiskar som är anslutna till den virtuella datorn. ComputeDataDisk[]
networkInterfaceId Hämtar nätverksgränssnitts-ID för den virtuella datorn. sträng
osDiskId Hämtar OS-diskblob-URI för den virtuella datorn. sträng
osType Hämtar operativsystemtypen för den virtuella datorn. sträng
Status Hämtar status för den virtuella datorn. ComputeVmInstanceViewStatus[]
vmSize Hämtar storleken på den virtuella datorn. sträng

ComputeDataDisk

Name Beskrivning Värde
diskSizeGiB Hämtar datadiskens storlek i GiB. int
diskUri När den backas upp av en blob, URI för den underliggande bloben. sträng
managedDiskId När den backas upp av en hanterad disk är detta ID:t för beräkningsdiskresursen. sträng
name Hämtar datadiskens namn. sträng

ComputeVmInstanceViewStatus

Name Beskrivning Värde
kod Hämtar statuskoden. sträng
displayStatus Hämtar den korta localizable-etiketten för statusen. sträng
meddelande Hämtar meddelandet som är associerat med statusen. sträng

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"

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Description
Skapar ett labb i Azure DevTest Labs med en virtuell Windows Server-dator

Distribuera till Azure
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 finns påhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Skapar ett labb i Azure DevTest Labs med en begärd virtuell dator

Distribuera till Azure
Den här mallen skapar en ny DevTest Lab/DTL-instans med en begärd virtuell Windows Server 2019 Datacenter-dator i den. Fler Azure Resource Manager-snabbstartsmallar för Azure DevTest Labs finns 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@2016-05-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      allowClaim = bool
      applicableSchedule = {
        location = "string"
        properties = {
          labVmsShutdown = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {}
          }
          labVmsStartup = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {}
          }
        }
        tags = {}
        location = "string"
        properties = {
          labVmsShutdown = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {}
          }
          labVmsStartup = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {}
          }
        }
        tags = {}
      }
      artifactDeploymentStatus = {
        artifactsApplied = int
        deploymentStatus = "string"
        totalArtifacts = int
      }
      artifacts = [
        {
          artifactId = "string"
          deploymentStatusMessage = "string"
          installTime = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
          status = "string"
          vmExtensionStatusMessage = "string"
        }
      ]
      computeVm = {
        dataDiskIds = [
          "string"
        ]
        dataDisks = [
          {
            diskSizeGiB = int
            diskUri = "string"
            managedDiskId = "string"
            name = "string"
          }
        ]
        networkInterfaceId = "string"
        osDiskId = "string"
        osType = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            message = "string"
          }
        ]
        vmSize = "string"
      }
      createdByUser = "string"
      createdByUserId = "string"
      createdDate = "string"
      customImageId = "string"
      disallowPublicIpAddress = bool
      environmentId = "string"
      expirationDate = "string"
      fqdn = "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"
      osType = "string"
      ownerObjectId = "string"
      ownerUserPrincipalName = "string"
      password = "string"
      provisioningState = "string"
      size = "string"
      sshKey = "string"
      storageType = "string"
      uniqueIdentifier = "string"
      userName = "string"
      virtualMachineCreationSource = "string"
    }
  })
}

Egenskapsvärden

labs/virtualmachines

Name Beskrivning Värde
typ Resurstypen "Microsoft.DevTestLab/labs/virtualmachines@2016-05-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 tal.
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
applicableSchedule Tillämpligt schema för den virtuella datorn. ApplicableSchedule
artifactDeploymentStatus Artefaktdistributionsstatus för den virtuella datorn. ArtifactDeploymentStatusProperties
Artefakter Artefakterna som ska installeras på den virtuella datorn. ArtifactInstallProperties[]
computeVm Egenskaperna för den virtuella datorn för beräkning. ComputeVmEgenskaper
createdByUser E-postadressen till den virtuella datorns skapare. sträng
createdByUserId Objektidentifieraren för skaparen av den virtuella datorn. sträng
createdDate Skapandedatumet för den virtuella datorn. sträng
customImageId Den virtuella datorns anpassade avbildningsidentifierare. sträng
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
Fqdn Det fullständigt kvalificerade domännamnet 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
osType Operativsystemtypen 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
provisioningState Resursens etableringsstatus. sträng
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
uniqueIdentifier Den unika oföränderliga identifieraren för en resurs (Guid). sträng
userName Användarnamnet för den virtuella datorn. sträng
virtualMachineCreationSource Talar om källan för skapandet av den virtuella labbdatorn. Endast utdataegenskap. "FromCustomImage"
"FromGalleryImage"

ApplicableSchedule

Name Beskrivning Värde
location Platsen för resursen. sträng
properties Egenskaperna för resursen. ApplicableScheduleProperties (krävs)
tags Resursens taggar. objekt
location Platsen för resursen. sträng
properties Egenskaperna för resursen. ApplicableScheduleProperties (krävs)
tags Resursens taggar. objekt

ApplicableScheduleEgenskaper

Name Beskrivning Värde
labVmsShutdown Schemat för automatisk avstängning, om ett har angetts på labb- eller labbresursnivå. Schema
labVmsStartup Schemat för automatisk start, om ett har angetts på labb- eller labbresursnivå. Schema

Schema

Name Beskrivning Värde
location Platsen för resursen. sträng
properties Egenskaperna för resursen. ScheduleProperties (krävs)
tags Resursens taggar. objekt

ScheduleProperties

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
provisioningState Resursens etableringsstatus. sträng
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
timeZoneId Tidszons-ID (t.ex. Pacific Standard-tid). sträng
uniqueIdentifier Den unika oföränderliga identifieraren för en resurs (Guid). 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
status Om meddelanden är aktiverade för det här schemat (t.ex. aktiverat, inaktiverat). "Inaktiverad"
"Aktiverad"
timeInMinutes Tid i minuter innan händelsen då meddelandet skickas. int
webhookUrl Den webhook-URL som meddelandet ska skickas till. sträng

WeekDetails

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

ArtifactDeploymentStatusProperties

Name Beskrivning Värde
artifactsApplied Det totala antalet artefakter som har tillämpats. int
deploymentStatus Distributionsstatus för artefakten. sträng
totalArtifacts Det totala antalet artefakter som tillämpades preliminärt. int

ArtifactInstallProperties

Name Beskrivning Värde
artifactId Artefaktens identifierare. 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

ComputeVmProperties

Name Beskrivning Värde
dataDiskIds Hämtar blob-URI för datadiskar för den virtuella datorn. string[]
dataDisks Hämtar alla datadiskar som är anslutna till den virtuella datorn. ComputeDataDisk[]
networkInterfaceId Hämtar nätverksgränssnitts-ID för den virtuella datorn. sträng
osDiskId Hämtar OS-diskblob-URI för den virtuella datorn. sträng
osType Hämtar operativsystemtypen för den virtuella datorn. sträng
Status Hämtar status för den virtuella datorn. ComputeVmInstanceViewStatus[]
vmSize Hämtar storleken på den virtuella datorn. sträng

ComputeDataDisk

Name Beskrivning Värde
diskSizeGiB Hämtar datadiskstorlek i GiB. int
diskUri När den backas upp av en blob, URI för underliggande blob. sträng
managedDiskId När den backas upp av en hanterad disk är detta ID:t för beräkningsdiskresursen. sträng
name Hämtar datadiskens namn. sträng

ComputeVmInstanceViewStatus

Name Beskrivning Värde
kod Hämtar statuskoden. sträng
displayStatus Hämtar den korta localizable-etiketten för statusen. sträng
meddelande Hämtar meddelandet som är associerat med statusen. sträng

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"