Freigeben über

Microsoft.DevTestLab labs/virtualmachines 2018-09-15

  • Artikel

Bicep-Ressourcendefinition

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

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, 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

In Azure bereitstellen		 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

In Azure bereitstellen		 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

Ressourcendefinition mit einer ARM-Vorlage

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

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 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 Der Ressourcentyp "Microsoft.DevTestLab/labs/virtualmachines"
apiVersion Die Version der Ressourcen-API '2018-09-15'
name Der Ressourcenname

Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen.		 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.
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 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

In Azure bereitstellen		 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

In Azure bereitstellen		 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

Terraform (AzAPI-Anbieter) Ressourcendefinition

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

  • Ressourcengruppen

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 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 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[]