Dela via

Microsoft.DevTestLab labs/virtualmachines 2016-05-15

  • Artikel

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' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  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: {
            {customized property}: 'string'
          }
        }
        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: {
            {customized property}: 'string'
          }
        }
      }
      tags: {
        {customized property}: 'string'
      }
    }
    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'
  }
  tags: {
    {customized property}: 'string'
  }
}

Egenskapsvärden

ApplicableSchedule

Namn Beskrivning Värde
plats Platsen för resursen. sträng
Egenskaper Egenskaperna för resursen. ApplicableScheduleProperties (krävs)
Taggar Taggarna för resursen. ResourceTags

ApplicableScheduleProperties

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

ArtifactDeploymentStatusProperties

Namn Beskrivning Värde
artifactsApplied Det totala antalet artefakter som har tillämpats. Int
deploymentStatus Artefaktens distributionsstatus. sträng
totalArtifacts Det totala antalet artefakter som tillämpades preliminärt. Int

ArtifactInstallProperties

Namn 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 Artefaktens parametrar. ArtifactParameterProperties[]
status Artefaktens status. sträng
vmExtensionStatusMessage Statusmeddelandet från tillägget för den virtuella datorn. sträng

ArtifactParameterEgenskaper

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

ComputeDataDisk

Namn 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 för beräkningsdiskresursen. sträng
Namn Hämtar datadiskens namn. sträng

ComputeVmInstanceViewStatus

Namn 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

ComputeVmProperties

Namn Beskrivning Värde
dataDiskIds Hämtar blob-uri för datadiskar för den virtuella datorn. string[]
dataDiskar 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

DayDetails

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

GalleryImageReference

Namn Beskrivning Värde
erbjudande Galleribildens erbjudande. sträng
osType Operativsystemets typ av galleriavbildning. sträng
förläggare Utgivaren av galleribilden. sträng
Sku SKU:n för galleribilden. sträng
version Versionen av galleribilden. sträng

HourDetails

Namn Beskrivning Värde
minut Minuter i timmen som schemat körs. Int

InboundNatRule

Namn 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 är ospecificerat allokeras ett värde automatiskt. Int
transportProtocol Transportprotokollet för slutpunkten. "Tcp"
"Udp"

LabVirtualMachineProperties

Namn Beskrivning Värde
allowClaim Anger om en annan användare kan ta över ägarskapet för den virtuella datorn Bool
applicableSchedule Tillämpligt schema för den virtuella datorn. ApplicableSchedule
artifactDeploymentStatus Artefaktdistributionsstatus för den virtuella datorn. ArtifactDeploymentStatusEgenskaper
Artefakter Artefakterna som ska installeras på den virtuella datorn. ArtifactInstallProperties[]
computeVm Egenskaperna för den virtuella datorn för beräkning. ComputeVmProperties
createdByUser E-postadressen till skaparen av den virtuella datorn. 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
inte tillåtaPublicIpAddress Anger om den virtuella datorn ska skapas utan en offentlig IP-adress. Bool
environmentId Resurs-ID för miljön som innehåller den här virtuella datorn, om det finns några. 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-avbildningsreferensen för den virtuella datorn. GalleryImageReference
isAuthenticationWithSshKey Anger om den här virtuella datorn använder en SSH-nyckel för autentisering. Bool
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
lösenord Lösenordet för administratören för den virtuella datorn. sträng
provisioningState Resursens etableringsstatus. sträng
storlek 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 Anger källan för skapandet av den virtuella labbdatorn. Endast utdataegenskap. "FromCustomImage"
"FromGalleryImage"

Microsoft.DevTestLab/labs/virtualmachines

Namn Beskrivning Värde
plats Platsen för resursen. sträng
Namn Resursnamnet sträng (krävs)
förälder 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 den överordnade resursen.		 Symboliskt namn för resurs av typen: labb
Egenskaper Egenskaperna för resursen. LabVirtualMachineProperties (krävs)
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar

NetworkInterfaceProperties

Namn 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 SERVER DNS-värdnamn eller IP-adress 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

NotificationSettings

Namn Beskrivning Värde
status Om meddelanden är aktiverade för det här schemat (dvs. Aktiverad, Inaktiverad). "Inaktiverad"
"Aktiverad"
timeInMinutes Tid i minuter före händelsen då meddelandet skickas. Int
webhookUrl Webhook-URL:en som meddelandet ska skickas till. sträng

ResourceTags

Namn Beskrivning Värde

ResourceTags

Namn Beskrivning Värde

ResourceTags

Namn Beskrivning Värde

Schema

Namn Beskrivning Värde
plats Platsen för resursen. sträng
Egenskaper Egenskaperna för resursen. ScheduleProperties (krävs)
Taggar Taggarna för resursen. ResourceTags

ScheduleProperties

Namn 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 upprepning 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

SharedPublicIpAddressConfiguration

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

WeekDetails

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

Användningsexempel

Azure-snabbstartsexempel

Följande Azure-snabbstartsmallar innehålla Bicep-exempel för distribution av den här resurstypen.

Bicep-fil Beskrivning
Skapar ett labb i Azure DevTest Labs med en påstådd vm- Den här mallen skapar en ny DevTest Lab/DTL-instans med en anspråksbaserad 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",
  "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": {
            "{customized property}": "string"
          }
        },
        "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": {
            "{customized property}": "string"
          }
        }
      },
      "tags": {
        "{customized property}": "string"
      }
    },
    "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"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Egenskapsvärden

ApplicableSchedule

Namn Beskrivning Värde
plats Platsen för resursen. sträng
Egenskaper Egenskaperna för resursen. ApplicableScheduleProperties (krävs)
Taggar Taggarna för resursen. ResourceTags

ApplicableScheduleProperties

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

ArtifactDeploymentStatusProperties

Namn Beskrivning Värde
artifactsApplied Det totala antalet artefakter som har tillämpats. Int
deploymentStatus Artefaktens distributionsstatus. sträng
totalArtifacts Det totala antalet artefakter som tillämpades preliminärt. Int

ArtifactInstallProperties

Namn 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 Artefaktens parametrar. ArtifactParameterProperties[]
status Artefaktens status. sträng
vmExtensionStatusMessage Statusmeddelandet från tillägget för den virtuella datorn. sträng

ArtifactParameterEgenskaper

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

ComputeDataDisk

Namn 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 för beräkningsdiskresursen. sträng
Namn Hämtar datadiskens namn. sträng

ComputeVmInstanceViewStatus

Namn 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

ComputeVmProperties

Namn Beskrivning Värde
dataDiskIds Hämtar blob-uri för datadiskar för den virtuella datorn. string[]
dataDiskar 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

DayDetails

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

GalleryImageReference

Namn Beskrivning Värde
erbjudande Galleribildens erbjudande. sträng
osType Operativsystemets typ av galleriavbildning. sträng
förläggare Utgivaren av galleribilden. sträng
Sku SKU:n för galleribilden. sträng
version Versionen av galleribilden. sträng

HourDetails

Namn Beskrivning Värde
minut Minuter i timmen som schemat körs. Int

InboundNatRule

Namn 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 är ospecificerat allokeras ett värde automatiskt. Int
transportProtocol Transportprotokollet för slutpunkten. "Tcp"
"Udp"

LabVirtualMachineProperties

Namn Beskrivning Värde
allowClaim Anger om en annan användare kan ta över ägarskapet för den virtuella datorn Bool
applicableSchedule Tillämpligt schema för den virtuella datorn. ApplicableSchedule
artifactDeploymentStatus Artefaktdistributionsstatus för den virtuella datorn. ArtifactDeploymentStatusEgenskaper
Artefakter Artefakterna som ska installeras på den virtuella datorn. ArtifactInstallProperties[]
computeVm Egenskaperna för den virtuella datorn för beräkning. ComputeVmProperties
createdByUser E-postadressen till skaparen av den virtuella datorn. 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
inte tillåtaPublicIpAddress Anger om den virtuella datorn ska skapas utan en offentlig IP-adress. Bool
environmentId Resurs-ID för miljön som innehåller den här virtuella datorn, om det finns några. 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-avbildningsreferensen för den virtuella datorn. GalleryImageReference
isAuthenticationWithSshKey Anger om den här virtuella datorn använder en SSH-nyckel för autentisering. Bool
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
lösenord Lösenordet för administratören för den virtuella datorn. sträng
provisioningState Resursens etableringsstatus. sträng
storlek 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 Anger källan för skapandet av den virtuella labbdatorn. Endast utdataegenskap. "FromCustomImage"
"FromGalleryImage"

Microsoft.DevTestLab/labs/virtualmachines

Namn Beskrivning Värde
apiVersion API-versionen '2016-05-15'
plats Platsen för resursen. sträng
Namn Resursnamnet sträng (krävs)
Egenskaper Egenskaperna för resursen. LabVirtualMachineProperties (krävs)
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar
typ Resurstypen "Microsoft.DevTestLab/labs/virtualmachines"

NetworkInterfaceProperties

Namn 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 SERVER DNS-värdnamn eller IP-adress 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

NotificationSettings

Namn Beskrivning Värde
status Om meddelanden är aktiverade för det här schemat (dvs. Aktiverad, Inaktiverad). "Inaktiverad"
"Aktiverad"
timeInMinutes Tid i minuter före händelsen då meddelandet skickas. Int
webhookUrl Webhook-URL:en som meddelandet ska skickas till. sträng

ResourceTags

Namn Beskrivning Värde

ResourceTags

Namn Beskrivning Värde

ResourceTags

Namn Beskrivning Värde

Schema

Namn Beskrivning Värde
plats Platsen för resursen. sträng
Egenskaper Egenskaperna för resursen. ScheduleProperties (krävs)
Taggar Taggarna för resursen. ResourceTags

ScheduleProperties

Namn 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 upprepning 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

SharedPublicIpAddressConfiguration

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

WeekDetails

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

Användningsexempel

Azure-snabbstartsmallar

Följande Azure-snabbstartsmallar distribuera den här resurstypen.

Mall Beskrivning
Skapar ett labb i Azure DevTest Labs med en påstådd vm-

Distribuera till Azure 		Den här mallen skapar en ny DevTest Lab/DTL-instans med en anspråksbaserad 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"
  tags = {
    {customized property} = "string"
  }
  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 = {
              {customized property} = "string"
            }
          }
          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 = {
              {customized property} = "string"
            }
          }
        }
        tags = {
          {customized property} = "string"
        }
      }
      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

ApplicableSchedule

Namn Beskrivning Värde
plats Platsen för resursen. sträng
Egenskaper Egenskaperna för resursen. ApplicableScheduleProperties (krävs)
Taggar Taggarna för resursen. ResourceTags

ApplicableScheduleProperties

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

ArtifactDeploymentStatusProperties

Namn Beskrivning Värde
artifactsApplied Det totala antalet artefakter som har tillämpats. Int
deploymentStatus Artefaktens distributionsstatus. sträng
totalArtifacts Det totala antalet artefakter som tillämpades preliminärt. Int

ArtifactInstallProperties

Namn 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 Artefaktens parametrar. ArtifactParameterProperties[]
status Artefaktens status. sträng
vmExtensionStatusMessage Statusmeddelandet från tillägget för den virtuella datorn. sträng

ArtifactParameterEgenskaper

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

ComputeDataDisk

Namn 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 för beräkningsdiskresursen. sträng
Namn Hämtar datadiskens namn. sträng

ComputeVmInstanceViewStatus

Namn 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

ComputeVmProperties

Namn Beskrivning Värde
dataDiskIds Hämtar blob-uri för datadiskar för den virtuella datorn. string[]
dataDiskar 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

DayDetails

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

GalleryImageReference

Namn Beskrivning Värde
erbjudande Galleribildens erbjudande. sträng
osType Operativsystemets typ av galleriavbildning. sträng
förläggare Utgivaren av galleribilden. sträng
Sku SKU:n för galleribilden. sträng
version Versionen av galleribilden. sträng

HourDetails

Namn Beskrivning Värde
minut Minuter i timmen som schemat körs. Int

InboundNatRule

Namn 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 är ospecificerat allokeras ett värde automatiskt. Int
transportProtocol Transportprotokollet för slutpunkten. "Tcp"
"Udp"

LabVirtualMachineProperties

Namn Beskrivning Värde
allowClaim Anger om en annan användare kan ta över ägarskapet för den virtuella datorn Bool
applicableSchedule Tillämpligt schema för den virtuella datorn. ApplicableSchedule
artifactDeploymentStatus Artefaktdistributionsstatus för den virtuella datorn. ArtifactDeploymentStatusEgenskaper
Artefakter Artefakterna som ska installeras på den virtuella datorn. ArtifactInstallProperties[]
computeVm Egenskaperna för den virtuella datorn för beräkning. ComputeVmProperties
createdByUser E-postadressen till skaparen av den virtuella datorn. 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
inte tillåtaPublicIpAddress Anger om den virtuella datorn ska skapas utan en offentlig IP-adress. Bool
environmentId Resurs-ID för miljön som innehåller den här virtuella datorn, om det finns några. 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-avbildningsreferensen för den virtuella datorn. GalleryImageReference
isAuthenticationWithSshKey Anger om den här virtuella datorn använder en SSH-nyckel för autentisering. Bool
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
lösenord Lösenordet för administratören för den virtuella datorn. sträng
provisioningState Resursens etableringsstatus. sträng
storlek 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 Anger källan för skapandet av den virtuella labbdatorn. Endast utdataegenskap. "FromCustomImage"
"FromGalleryImage"

Microsoft.DevTestLab/labs/virtualmachines

Namn Beskrivning Värde
plats Platsen för resursen. sträng
Namn Resursnamnet sträng (krävs)
parent_id ID för resursen som är överordnad för den här resursen. ID för resurs av typen: labb
Egenskaper Egenskaperna för resursen. LabVirtualMachineProperties (krävs)
Taggar Resurstaggar Ordlista med taggnamn och värden.
typ Resurstypen "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"

NetworkInterfaceProperties

Namn 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 SERVER DNS-värdnamn eller IP-adress 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

NotificationSettings

Namn Beskrivning Värde
status Om meddelanden är aktiverade för det här schemat (dvs. Aktiverad, Inaktiverad). "Inaktiverad"
"Aktiverad"
timeInMinutes Tid i minuter före händelsen då meddelandet skickas. Int
webhookUrl Webhook-URL:en som meddelandet ska skickas till. sträng

ResourceTags

Namn Beskrivning Värde

ResourceTags

Namn Beskrivning Värde

ResourceTags

Namn Beskrivning Värde

Schema

Namn Beskrivning Värde
plats Platsen för resursen. sträng
Egenskaper Egenskaperna för resursen. ScheduleProperties (krävs)
Taggar Taggarna för resursen. ResourceTags

ScheduleProperties

Namn 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 upprepning 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

SharedPublicIpAddressConfiguration

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

WeekDetails

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