Microsoft.DevTestLab labs/virtualmachines

Artikel
08/13/2023

Bicep-Ressourcendefinition

Der Ressourcentyp labs/virtualmachines kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen – Siehe Bereitstellungsbefehle für Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevTestLab/labs/virtualmachines-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.

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

Eigenschaftswerte

labs/virtualmachines

Name	Beschreibung	Wert
name	Der Ressourcenname Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in Bicep.	Zeichenfolge (erforderlich) Zeichenlimit: 1-15 (Windows) 1–64 (Linux) Gültige Zeichen: Alphanumerische Zeichen und Bindestriche. Beginnen und enden Sie mit einem alphanumerischen Zeichen. Darf nicht nur aus Zahlen bestehen.
location	Der Speicherort der Ressource.	Zeichenfolge
tags	Die Tags der Ressource.	Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen.
parent	In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird. Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.	Symbolischer Name für Ressource vom Typ Labs
properties	Die Eigenschaften der Ressource.	LabVirtualMachineProperties (erforderlich)

LabVirtualMachineProperties

Name	Beschreibung	Wert
allowClaim	Gibt an, ob ein anderer Benutzer den Besitz des virtuellen Computers übernehmen kann.	bool
artifacts	Die Artefakte, die auf dem virtuellen Computer installiert werden sollen.	ArtifactInstallProperties[]
createdDate	Das Erstellungsdatum des virtuellen Computers.	Zeichenfolge
customImageId	Der benutzerdefinierte Imagebezeichner des virtuellen Computers.	Zeichenfolge
dataDiskParameters	Neue oder vorhandene Datenträger, die nach der Erstellung an den virtuellen Computer angefügt werden sollen	DataDiskProperties[]
disallowPublicIpAddress	Gibt an, ob der virtuelle Computer ohne öffentliche IP-Adresse erstellt werden soll.	bool
environmentId	Die Ressourcen-ID der Umgebung, die diesen virtuellen Computer enthält, sofern vorhanden.	Zeichenfolge
expirationDate	Das Ablaufdatum für den virtuellen Computer.	Zeichenfolge
galleryImageReference	Die Microsoft Azure Marketplace Imagereferenz des virtuellen Computers.	GalleryImageReference
isAuthenticationWithSshKey	Gibt an, ob dieser virtuelle Computer einen SSH-Schlüssel für die Authentifizierung verwendet.	bool
labSubnetName	Der Name des Lab-Subnetzes des virtuellen Computers.	Zeichenfolge
labVirtualNetworkId	Der Lab-VNET-Bezeichner des virtuellen Computers.	Zeichenfolge
networkInterface	Die Netzwerkschnittstelleneigenschaften.	NetworkInterfaceProperties
notes	Die Notizen des virtuellen Computers.	Zeichenfolge
ownerObjectId	Der Objektbezeichner des Besitzers des virtuellen Computers.	Zeichenfolge
ownerUserPrincipalName	Der Benutzerprinzipalname des Besitzers des virtuellen Computers.	Zeichenfolge
password	Das Kennwort des VM-Administrators.	Zeichenfolge
planId	Die ID des Plans, der dem VM-Image zugeordnet ist	Zeichenfolge
scheduleParameters	Zu erstellende VM-Zeitpläne	ScheduleCreationParameter[]
size	Die Größe des virtuellen Computers.	Zeichenfolge
sshKey	Der SSH-Schlüssel des VM-Administrators.	Zeichenfolge
Speichertyp	Speichertyp, der für virtuelle Computer verwendet werden soll (d. h. Standard, Premium).	Zeichenfolge
userName	Der Benutzername des virtuellen Computers.	Zeichenfolge

ArtifactInstallProperties

Name	Beschreibung	Wert
artifactId	Der Bezeichner des Artefakts.	Zeichenfolge
artifactTitle	Titel des Artefakts.	Zeichenfolge
deploymentStatusMessage	Die status Meldung aus der Bereitstellung.	Zeichenfolge
installTime	Die Zeit, zu der das Artefakt auf dem virtuellen Computer installiert wird.	Zeichenfolge
parameters	Die Parameter des Artefakts.	ArtifactParameterProperties[]
status	Die status des Artefakts.	Zeichenfolge
vmExtensionStatusMessage	Die status Nachricht von der VM-Erweiterung.	Zeichenfolge

ArtifactParameterProperties

Name	Beschreibung	Wert
name	Der Name des Artefaktparameters.	Zeichenfolge
value	Der Wert des Artefaktparameters.	Zeichenfolge

DataDiskProperties

Name	Beschreibung	Wert
attachNewDataDiskOptions	Gibt Optionen zum Anfügen eines neuen Datenträgers an den virtuellen Computer an.	AttachNewDataDiskOptions
existingLabDiskId	Gibt die vorhandene Labdatenträger-ID an, die an einen virtuellen Computer angefügt werden soll.	Zeichenfolge
hostCaching	Zwischenspeicherungsoption für einen Datenträger (d. h. None, ReadOnly, ReadWrite).	"Keine" 'ReadOnly' "ReadWrite"

AttachNewDataDiskOptions

Name	Beschreibung	Wert
diskName	Der Name des anzufügenden Datenträgers.	Zeichenfolge
diskSizeGiB	Größe des Datenträgers, der angefügt werden soll, in Gibibytes.	INT
Disktype	Der Speichertyp für den Datenträger (d. h. Standard, Premium).	"Premium" "Standard" "StandardSSD"

GalleryImageReference

Name	Beschreibung	Wert
offer	Das Angebot des Katalogimages.	Zeichenfolge
osType	Der Betriebssystemtyp des Katalogimages.	Zeichenfolge
publisher	Der Herausgeber des Katalogimages.	Zeichenfolge
sku	Die SKU des Katalogimages.	Zeichenfolge
version	Die Version des Katalogimages.	Zeichenfolge

NetworkInterfaceProperties

Name	Beschreibung	Wert
dnsName	Der DNS-Name.	Zeichenfolge
privateIpAddress	Die private IP-Adresse.	Zeichenfolge
publicIpAddress	Öffentliche IP-Adresse	Zeichenfolge
publicIpAddressId	Die Ressourcen-ID der öffentlichen IP-Adresse.	Zeichenfolge
rdpAuthority	Die RdpAuthority-Eigenschaft ist ein SERVER-DNS-Hostname oder eine IP-Adresse, gefolgt von der Dienstportnummer für RDP (Remotedesktopprotokoll).	Zeichenfolge
sharedPublicIpAddressConfiguration	Die Konfiguration zum Freigeben einer öffentlichen IP-Adresse über mehrere virtuelle Computer hinweg.	SharedPublicIpAddressConfiguration
sshAuthority	Die SshAuthority-Eigenschaft ist ein DNS-Hostname oder eine IP-Adresse des Servers, gefolgt von der Dienstportnummer für SSH.	Zeichenfolge
subnetId	Die Ressourcen-ID des Subnetzes.	Zeichenfolge
virtualNetworkId	Die Ressourcen-ID des virtuellen Netzwerks.	Zeichenfolge

SharedPublicIpAddressConfiguration

Name	Beschreibung	Wert
inboundNatRules	Die eingehenden NAT-Regeln	InboundNatRule[]

InboundNatRule

Name	Beschreibung	Wert
backendPort	Der Port, an den der externe Datenverkehr umgeleitet wird.	INT
frontendPort	Der externe Endpunktport der eingehenden Verbindung. Mögliche Werte liegen zwischen 1 und 65.535 (einschließlich). Wenn nicht angegeben, wird ein Wert automatisch zugeordnet.	INT
transportProtocol	Das Transportprotokoll für den Endpunkt.	"TCP" 'Udp'

ScheduleCreationParameter

Name	Beschreibung	Wert
name	Der Name des virtuellen Computers oder der Umgebung	Zeichenfolge
properties	Die Eigenschaften des Zeitplans.	ScheduleCreationParameterProperties
tags	Die Tags der Ressource.	Objekt (object)

ScheduleCreationParameterProperties

Name	Beschreibung	Wert
dailyRecurrence	Wenn der Zeitplan einmal pro Wochentag auftritt, geben Sie die tägliche Wiederholung an.	DayDetails
hourlyRecurrence	Wenn der Zeitplan mehrmals täglich auftritt, geben Sie die stündliche Wiederholung an.	HourDetails
notificationSettings	Benachrichtigungseinstellungen.	NotificationSettings
status	Die status des Zeitplans (d. h. aktiviert, deaktiviert)	"Deaktiviert" "Aktiviert"
targetResourceId	Die Ressourcen-ID, zu der der Zeitplan gehört	Zeichenfolge
taskType	Der Aufgabentyp des Zeitplans (z. B. LabVmsShutdownTask, LabVmAutoStart).	Zeichenfolge
weeklyRecurrence	Wenn der Zeitplan nur an einigen Tagen der Woche auftritt, geben Sie die wöchentliche Wiederholung an.	WeekDetails

DayDetails

Name	Beschreibung	Wert
time	Die Tageszeit, zu der der Zeitplan ausgeführt wird.	Zeichenfolge

HourDetails

Name	Beschreibung	Wert
minute	Minuten der Stunde, die der Zeitplan ausgeführt wird.	INT

NotificationSettings

Name	Beschreibung	Wert
emailRecipient	Der E-Mail-Empfänger, an den Benachrichtigungen gesendet werden sollen (kann eine Liste von durch Semikolon getrennten E-Mail-Adressen sein).	Zeichenfolge
notificationLocale	Das Gebietsschema, das beim Senden einer Benachrichtigung verwendet werden soll (Fallback für nicht unterstützte Sprachen ist EN).	Zeichenfolge
status	Wenn Benachrichtigungen für diesen Zeitplan aktiviert sind (d. h. Aktiviert, Deaktiviert).	"Deaktiviert" "Aktiviert"
timeInMinutes	Zeit in Minuten vor dem Ereignis, zu dem die Benachrichtigung gesendet wird.	INT
webhookUrl	Die Webhook-URL, an die die Benachrichtigung gesendet wird.	Zeichenfolge

WeekDetails

Name	Beschreibung	Wert
time	Die Uhrzeit des Tages, zu dem der Zeitplan auftritt.	Zeichenfolge
Wochentagen	Die Wochentage, für die der Zeitplan festgelegt ist (z. B. Sonntag, Montag, Dienstag usw.).	string[]

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.

Vorlage	Beschreibung
Erstellt ein Lab in Azure DevTest Labs mit einer Windows Server-VM	Diese Vorlage erstellt eine neue DevTest Lab/DTL-instance mit einer Windows Server 2019 Datacenter-VM darin. Weitere Azure Resource Manager-Schnellstartvorlagen für Azure DevTest Labs finden Sie unterhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Erstellt ein Lab in Azure DevTest Labs mit einer beanspruchten VM	Diese Vorlage erstellt eine neue DevTest Lab/DTL-instance mit einer beanspruchten Windows Server 2019 Datacenter-VM darin. Weitere Azure Resource Manager-Schnellstartvorlagen für Azure DevTest Labs finden Sie unterhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Ressourcendefinition mit einer ARM-Vorlage

Der Ressourcentyp labs/virtualmachines kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevTestLab/labs/virtualmachines-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

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

Eigenschaftswerte

labs/virtualmachines

Name	Beschreibung	Wert
type	Ressourcentyp	"Microsoft.DevTestLab/labs/virtualmachines"
apiVersion	Die Ressourcen-API-Version	'2018-09-15'
name	Der Ressourcenname Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen festlegen.	Zeichenfolge (erforderlich) Zeichenlimit: 1-15 (Windows) 1–64 (Linux) Gültige Zeichen: Alphanumerische Zeichen und Bindestriche. Beginnen und enden Sie mit einem alphanumerischen Zeichen. Darf nicht nur aus Zahlen bestehen.
location	Der Speicherort der Ressource.	Zeichenfolge
tags	Die Tags der Ressource.	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
properties	Die Eigenschaften der Ressource.	LabVirtualMachineProperties (erforderlich)

LabVirtualMachineProperties

Name	Beschreibung	Wert
allowClaim	Gibt an, ob ein anderer Benutzer den Besitz des virtuellen Computers übernehmen kann.	bool
artifacts	Die Artefakte, die auf dem virtuellen Computer installiert werden sollen.	ArtifactInstallProperties[]
createdDate	Das Erstellungsdatum des virtuellen Computers.	Zeichenfolge
customImageId	Der benutzerdefinierte Imagebezeichner des virtuellen Computers.	Zeichenfolge
dataDiskParameters	Neue oder vorhandene Datenträger, die nach der Erstellung an den virtuellen Computer angefügt werden sollen	DataDiskProperties[]
disallowPublicIpAddress	Gibt an, ob der virtuelle Computer ohne öffentliche IP-Adresse erstellt werden soll.	bool
environmentId	Die Ressourcen-ID der Umgebung, die diesen virtuellen Computer enthält, falls vorhanden.	Zeichenfolge
expirationDate	Das Ablaufdatum für den virtuellen Computer.	Zeichenfolge
galleryImageReference	Die Microsoft Azure Marketplace Imagereferenz des virtuellen Computers.	GalleryImageReference
isAuthenticationWithSshKey	Gibt an, ob dieser virtuelle Computer einen SSH-Schlüssel für die Authentifizierung verwendet.	bool
labSubnetName	Der Lab-Subnetzname des virtuellen Computers.	Zeichenfolge
labVirtualNetworkId	Der Lab-Bezeichner des virtuellen Netzwerks des virtuellen Computers.	Zeichenfolge
networkInterface	Die Netzwerkschnittstelleneigenschaften.	NetworkInterfaceProperties
notes	Die Notizen des virtuellen Computers.	Zeichenfolge
ownerObjectId	Der Objektbezeichner des Besitzers des virtuellen Computers.	Zeichenfolge
ownerUserPrincipalName	Der Benutzerprinzipalname des Besitzers des virtuellen Computers.	Zeichenfolge
password	Das Kennwort des VM-Administrators.	Zeichenfolge
planId	Die ID des Plans, der dem VM-Image zugeordnet ist	Zeichenfolge
scheduleParameters	Zu erstellende VM-Zeitpläne	ScheduleCreationParameter[]
size	Die Größe des virtuellen Computers.	Zeichenfolge
sshKey	Der SSH-Schlüssel des VM-Administrators.	Zeichenfolge
Speichertyp	Speichertyp, der für virtuelle Computer verwendet werden soll (d. h. Standard, Premium).	Zeichenfolge
userName	Der Benutzername des virtuellen Computers.	Zeichenfolge

ArtifactInstallProperties

Name	Beschreibung	Wert
artifactId	Der Bezeichner des Artefakts.	Zeichenfolge
artifactTitle	Titel des Artefakts.	Zeichenfolge
deploymentStatusMessage	Die status Meldung aus der Bereitstellung.	Zeichenfolge
installTime	Die Zeit, zu der das Artefakt auf dem virtuellen Computer installiert wird.	Zeichenfolge
parameters	Die Parameter des Artefakts.	ArtifactParameterProperties[]
status	Die status des Artefakts.	Zeichenfolge
vmExtensionStatusMessage	Die status Nachricht von der VM-Erweiterung.	Zeichenfolge

ArtifactParameterProperties

Name	Beschreibung	Wert
name	Der Name des Artefaktparameters.	Zeichenfolge
value	Der Wert des Artefaktparameters.	Zeichenfolge

DataDiskProperties

Name	Beschreibung	Wert
attachNewDataDiskOptions	Gibt Optionen zum Anfügen eines neuen Datenträgers an den virtuellen Computer an.	AttachNewDataDiskOptions
existingLabDiskId	Gibt die vorhandene Labdatenträger-ID an, die an den virtuellen Computer angefügt werden soll.	Zeichenfolge
hostCaching	Zwischenspeicherungsoption für einen Datenträger (d. h. None, ReadOnly, ReadWrite).	"Keine" "ReadOnly" "ReadWrite"

AttachNewDataDiskOptions

Name	Beschreibung	Wert
diskName	Der Name des anzufügenden Datenträgers.	Zeichenfolge
diskSizeGiB	Größe des anzufügenden Datenträgers in Gibibytes.	INT
Disktype	Der Speichertyp für den Datenträger (d. h. Standard, Premium).	"Premium" "Standard" "StandardSSD"

GalleryImageReference

Name	Beschreibung	Wert
offer	Das Angebot des Katalogimages.	Zeichenfolge
osType	Der Betriebssystemtyp des Katalogimages.	Zeichenfolge
publisher	Der Herausgeber des Katalogimages.	Zeichenfolge
sku	Die SKU des Katalogimages.	Zeichenfolge
version	Die Version des Katalogimages.	Zeichenfolge

NetworkInterfaceProperties

Name	Beschreibung	Wert
dnsName	Der DNS-Name.	Zeichenfolge
privateIpAddress	Die private IP-Adresse.	Zeichenfolge
publicIpAddress	Öffentliche IP-Adresse	Zeichenfolge
publicIpAddressId	Die Ressourcen-ID der öffentlichen IP-Adresse.	Zeichenfolge
rdpAuthority	Die RdpAuthority-Eigenschaft ist ein DNS-Hostname oder eine IP-Adresse des Servers, gefolgt von der Dienstportnummer für RDP (Remotedesktopprotokoll).	Zeichenfolge
sharedPublicIpAddressConfiguration	Die Konfiguration für die Freigabe einer öffentlichen IP-Adresse über mehrere virtuelle Computer hinweg.	SharedPublicIpAddressConfiguration
sshAuthority	Die SshAuthority-Eigenschaft ist ein DNS-Hostname oder eine IP-Adresse des Servers, gefolgt von der Dienstportnummer für SSH.	Zeichenfolge
subnetId	Die Ressourcen-ID des Subnetzes.	Zeichenfolge
virtualNetworkId	Die Ressourcen-ID des virtuellen Netzwerks.	Zeichenfolge

SharedPublicIpAddressConfiguration

Name	Beschreibung	Wert
inboundNatRules	Die eingehenden NAT-Regeln	InboundNatRule[]

InboundNatRule

Name	Beschreibung	Wert
backendPort	Der Port, an den der externe Datenverkehr umgeleitet wird.	INT
frontendPort	Der port des externen Endpunkts der eingehenden Verbindung. Mögliche Werte liegen zwischen 1 und 65.535 (einschließlich). Wenn keine Angabe erfolgt, wird automatisch ein Wert zugeordnet.	INT
transportProtocol	Das Transportprotokoll für den Endpunkt.	"TCP" "Udp"

ScheduleCreationParameter

Name	Beschreibung	Wert
name	Der Name des virtuellen Computers oder der Umgebung	Zeichenfolge
properties	Die Eigenschaften des Zeitplans.	ScheduleCreationParameterProperties
tags	Die Tags der Ressource.	Objekt (object)

ScheduleCreationParameterProperties

Name	Beschreibung	Wert
dailyRecurrence	Wenn der Zeitplan einmal an jedem Wochentag auftritt, geben Sie die tägliche Wiederholung an.	DayDetails
hourlyRecurrence	Wenn der Zeitplan mehrmals täglich auftritt, geben Sie die stündliche Wiederholung an.	HourDetails
notificationSettings	Benachrichtigungseinstellungen.	NotificationSettings
status	Die status des Zeitplans (d. h. aktiviert, deaktiviert)	"Deaktiviert" "Aktiviert"
targetResourceId	Die Ressourcen-ID, zu der der Zeitplan gehört	Zeichenfolge
taskType	Der Vorgangstyp des Zeitplans (z. B. LabVmsShutdownTask, LabVmAutoStart).	Zeichenfolge
weeklyRecurrence	Wenn der Zeitplan nur an einigen Tagen der Woche auftritt, geben Sie die wöchentliche Wiederholung an.	WeekDetails

DayDetails

Name	Beschreibung	Wert
time	Die Tageszeit, zu der der Zeitplan eintritt.	Zeichenfolge

HourDetails

Name	Beschreibung	Wert
minute	Minuten der Stunde, in der der Zeitplan ausgeführt wird.	INT

NotificationSettings

Name	Beschreibung	Wert
emailRecipient	Der E-Mail-Empfänger, an den Benachrichtigungen gesendet werden sollen (kann eine Liste von durch Semikolons getrennten E-Mail-Adressen sein).	Zeichenfolge
notificationLocale	Das Gebietsschema, das beim Senden einer Benachrichtigung verwendet werden soll (Fallback für nicht unterstützte Sprachen ist EN).	Zeichenfolge
status	Wenn Benachrichtigungen für diesen Zeitplan aktiviert sind (d. h. Aktiviert, Deaktiviert).	"Deaktiviert" "Aktiviert"
timeInMinutes	Zeit in Minuten vor dem Ereignis, zu dem die Benachrichtigung gesendet wird.	INT
webhookUrl	Die Webhook-URL, an die die Benachrichtigung gesendet wird.	Zeichenfolge

WeekDetails

Name	Beschreibung	Wert
time	Die Uhrzeit des Tages, zu dem der Zeitplan eintritt.	Zeichenfolge
Wochentagen	Die Wochentage, für die der Zeitplan festgelegt ist (z. B. Sonntag, Montag, Dienstag usw.).	string[]

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage	Beschreibung
Erstellt ein Lab in Azure DevTest Labs mit einer Windows Server-VM	Mit dieser Vorlage wird eine neue DevTest Lab/DTL-instance erstellt, in der eine Windows Server 2019 Datacenter-VM enthalten ist. Weitere Azure Resource Manager-Schnellstartvorlagen für Azure DevTest Labs finden Sie unterhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Erstellt ein Lab in Azure DevTest Labs mit einer beanspruchten VM	Mit dieser Vorlage wird eine neue DevTest Lab/DTL-instance erstellt, in der eine beanspruchte Windows Server 2019 Datacenter-VM enthalten ist. Weitere Azure Resource Manager-Schnellstartvorlagen für Azure DevTest Labs finden Sie unterhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Terraform-Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp labs/virtualmachines kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.DevTestLab/labs/virtualmachines" zu erstellen, fügen Sie Der Vorlage die folgende Terraform-Ressource hinzu.

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

Eigenschaftswerte

labs/virtualmachines

Name	Beschreibung	Wert
type	Der Ressourcentyp	"Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
name	Der Ressourcenname	Zeichenfolge (erforderlich) Zeichenlimit: 1-15 (Windows) 1–64 (Linux) Gültige Zeichen: Alphanumerische Zeichen und Bindestriche. Beginnen und enden Sie mit einem alphanumerischen Zeichen. Darf nicht nur aus Zahlen bestehen.
location	Der Speicherort der Ressource.	Zeichenfolge
parent_id	Die ID der Ressource, die das übergeordnete Element für diese Ressource ist.	ID für Ressource vom Typ Labs
tags	Die Tags der Ressource.	Wörterbuch der Tagnamen und -werte.
properties	Die Eigenschaften der Ressource.	LabVirtualMachineProperties (erforderlich)

LabVirtualMachineProperties

Name	Beschreibung	Wert
allowClaim	Gibt an, ob ein anderer Benutzer den Besitz des virtuellen Computers übernehmen kann.	bool
artifacts	Die Artefakte, die auf dem virtuellen Computer installiert werden sollen.	ArtifactInstallProperties[]
createdDate	Das Erstellungsdatum des virtuellen Computers.	Zeichenfolge
customImageId	Der benutzerdefinierte Imagebezeichner des virtuellen Computers.	Zeichenfolge
dataDiskParameters	Neue oder vorhandene Datenträger, die nach der Erstellung an den virtuellen Computer angefügt werden sollen	DataDiskProperties[]
disallowPublicIpAddress	Gibt an, ob der virtuelle Computer ohne öffentliche IP-Adresse erstellt werden soll.	bool
environmentId	Die Ressourcen-ID der Umgebung, die diesen virtuellen Computer enthält, sofern vorhanden.	Zeichenfolge
expirationDate	Das Ablaufdatum für den virtuellen Computer.	Zeichenfolge
galleryImageReference	Die Microsoft Azure Marketplace Imagereferenz des virtuellen Computers.	GalleryImageReference
isAuthenticationWithSshKey	Gibt an, ob dieser virtuelle Computer einen SSH-Schlüssel für die Authentifizierung verwendet.	bool
labSubnetName	Der Name des Lab-Subnetzes des virtuellen Computers.	Zeichenfolge
labVirtualNetworkId	Der Lab-VNET-Bezeichner des virtuellen Computers.	Zeichenfolge
networkInterface	Die Netzwerkschnittstelleneigenschaften.	NetworkInterfaceProperties
notes	Die Notizen des virtuellen Computers.	Zeichenfolge
ownerObjectId	Der Objektbezeichner des Besitzers des virtuellen Computers.	Zeichenfolge
ownerUserPrincipalName	Der Benutzerprinzipalname des Besitzers des virtuellen Computers.	Zeichenfolge
password	Das Kennwort des VM-Administrators.	Zeichenfolge
planId	Die ID des Plans, der dem Vm-Image zugeordnet ist	Zeichenfolge
scheduleParameters	Zu erstellende VM-Zeitpläne	ScheduleCreationParameter[]
size	Die Größe des virtuellen Computers.	Zeichenfolge
sshKey	Der SSH-Schlüssel des VM-Administrators.	Zeichenfolge
Speichertyp	Speichertyp, der für virtuelle Computer verwendet werden soll (d. h. Standard, Premium).	Zeichenfolge
userName	Der Benutzername des virtuellen Computers.	Zeichenfolge

ArtifactInstallProperties

Name	Beschreibung	Wert
artifactId	Der Bezeichner des Artefakts.	Zeichenfolge
artifactTitle	Der Titel des Artefakts.	Zeichenfolge
deploymentStatusMessage	Die status Meldung aus der Bereitstellung.	Zeichenfolge
installTime	Die Zeit, zu der das Artefakt auf dem virtuellen Computer installiert wird.	Zeichenfolge
parameters	Die Parameter des Artefakts.	ArtifactParameterProperties[]
status	Die status des Artefakts.	Zeichenfolge
vmExtensionStatusMessage	Die status Meldung der VM-Erweiterung.	Zeichenfolge

ArtifactParameterProperties

Name	Beschreibung	Wert
name	Der Name des Artefaktparameters.	Zeichenfolge
value	Der Wert des Artefaktparameters.	Zeichenfolge

DataDiskProperties

Name	Beschreibung	Wert
attachNewDataDiskOptions	Gibt Optionen zum Anfügen eines neuen Datenträgers an den virtuellen Computer an.	AttachNewDataDiskOptions
existingLabDiskId	Gibt die vorhandene Labdatenträger-ID an, die an den virtuellen Computer angefügt werden soll.	Zeichenfolge
hostCaching	Zwischenspeicherungsoption für einen Datenträger (d. h. None, ReadOnly, ReadWrite).	"None" "ReadOnly" "ReadWrite"

AttachNewDataDiskOptions

Name	Beschreibung	Wert
diskName	Der Name des anzufügenden Datenträgers.	Zeichenfolge
diskSizeGiB	Größe des anzufügenden Datenträgers in Gibibytes.	INT
Disktype	Der Speichertyp für den Datenträger (d. h. Standard, Premium).	"Premium" „Standard“ "StandardSSD"

GalleryImageReference

Name	Beschreibung	Wert
offer	Das Angebot des Katalogimages.	Zeichenfolge
osType	Der Betriebssystemtyp des Katalogimages.	Zeichenfolge
publisher	Der Herausgeber des Katalogimages.	Zeichenfolge
sku	Die SKU des Katalogimages.	Zeichenfolge
version	Die Version des Katalogimages.	Zeichenfolge

NetworkInterfaceProperties

Name	Beschreibung	Wert
dnsName	Der DNS-Name.	Zeichenfolge
privateIpAddress	Die private IP-Adresse.	Zeichenfolge
publicIpAddress	Öffentliche IP-Adresse	Zeichenfolge
publicIpAddressId	Die Ressourcen-ID der öffentlichen IP-Adresse.	Zeichenfolge
rdpAuthority	Die RdpAuthority-Eigenschaft ist ein SERVER-DNS-Hostname oder eine IP-Adresse, gefolgt von der Dienstportnummer für RDP (Remotedesktopprotokoll).	Zeichenfolge
sharedPublicIpAddressConfiguration	Die Konfiguration zum Freigeben einer öffentlichen IP-Adresse über mehrere virtuelle Computer hinweg.	SharedPublicIpAddressConfiguration
sshAuthority	Die SshAuthority-Eigenschaft ist ein DNS-Hostname oder eine IP-Adresse des Servers, gefolgt von der Dienstportnummer für SSH.	Zeichenfolge
subnetId	Die Ressourcen-ID des Subnetzes.	Zeichenfolge
virtualNetworkId	Die Ressourcen-ID des virtuellen Netzwerks.	Zeichenfolge

SharedPublicIpAddressConfiguration

Name	Beschreibung	Wert
inboundNatRules	Die eingehenden NAT-Regeln	InboundNatRule[]

InboundNatRule

Name	Beschreibung	Wert
backendPort	Der Port, an den der externe Datenverkehr umgeleitet wird.	INT
frontendPort	Der externe Endpunktport der eingehenden Verbindung. Mögliche Werte liegen zwischen 1 und 65.535 (einschließlich). Wenn nicht angegeben, wird ein Wert automatisch zugeordnet.	INT
transportProtocol	Das Transportprotokoll für den Endpunkt.	"TCP" "Udp"

ScheduleCreationParameter

Name	Beschreibung	Wert
name	Der Name des virtuellen Computers oder der Umgebung	Zeichenfolge
properties	Die Eigenschaften des Zeitplans.	ScheduleCreationParameterProperties
tags	Die Tags der Ressource.	Objekt (object)

ScheduleCreationParameterProperties

Name	Beschreibung	Wert
dailyRecurrence	Wenn der Zeitplan einmal pro Wochentag auftritt, geben Sie die tägliche Wiederholung an.	DayDetails
hourlyRecurrence	Wenn der Zeitplan mehrmals täglich auftritt, geben Sie die stündliche Wiederholung an.	HourDetails
notificationSettings	Benachrichtigungseinstellungen.	NotificationSettings
status	Die status des Zeitplans (d. h. aktiviert, deaktiviert)	"Deaktiviert" "Aktiviert"
targetResourceId	Die Ressourcen-ID, zu der der Zeitplan gehört	Zeichenfolge
taskType	Der Aufgabentyp des Zeitplans (z. B. LabVmsShutdownTask, LabVmAutoStart).	Zeichenfolge
weeklyRecurrence	Wenn der Zeitplan nur an einigen Tagen der Woche auftritt, geben Sie die wöchentliche Wiederholung an.	WeekDetails

DayDetails

Name	Beschreibung	Wert
time	Die Tageszeit, zu der der Zeitplan ausgeführt wird.	Zeichenfolge

HourDetails

Name	Beschreibung	Wert
minute	Minuten der Stunde, die der Zeitplan ausgeführt wird.	INT

NotificationSettings

Name	Beschreibung	Wert
emailRecipient	Der E-Mail-Empfänger, an den Benachrichtigungen gesendet werden sollen (kann eine Liste von durch Semikolon getrennten E-Mail-Adressen sein).	Zeichenfolge
notificationLocale	Das Gebietsschema, das beim Senden einer Benachrichtigung verwendet werden soll (Fallback für nicht unterstützte Sprachen ist EN).	Zeichenfolge
status	Wenn Benachrichtigungen für diesen Zeitplan aktiviert sind (d. h. Aktiviert, Deaktiviert).	"Deaktiviert" "Aktiviert"
timeInMinutes	Zeit in Minuten vor dem Ereignis, zu dem die Benachrichtigung gesendet wird.	INT
webhookUrl	Die Webhook-URL, an die die Benachrichtigung gesendet wird.	Zeichenfolge

WeekDetails

Name	Beschreibung	Wert
time	Die Uhrzeit des Tages, zu dem der Zeitplan auftritt.	Zeichenfolge
Wochentagen	Die Wochentage, für die der Zeitplan festgelegt ist (z. B. Sonntag, Montag, Dienstag usw.).	string[]

Freigeben über

Microsoft.DevTestLab labs/virtualmachines

Bicep-Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

labs/virtualmachines

LabVirtualMachineProperties

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Schnellstartvorlagen

Ressourcendefinition mit einer ARM-Vorlage

Ressourcenformat

Eigenschaftswerte

labs/virtualmachines

LabVirtualMachineProperties

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Schnellstartvorlagen

Terraform-Ressourcendefinition (AzAPI-Anbieter)

Ressourcenformat

Eigenschaftswerte

labs/virtualmachines

LabVirtualMachineProperties

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Feedback

Zusätzliche Ressourcen