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 unter Änderungsprotokoll.

Ressourcenformat

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

resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2018-09-15' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  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'
          timeZoneId: 'string'
          weeklyRecurrence: {
            time: 'string'
            weekdays: [
              'string'
            ]
          }
        }
        tags: {
          {customized property}: 'string'
        }
      }
    ]
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    userName: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

ArtifactInstallProperties

Name Beschreibung Wert
artifactId Der Bezeichner des Artefakts. Schnur
artifactTitle Der Titel des Artefakts. Schnur
deploymentStatusMessage Die Statusmeldung aus der Bereitstellung. Schnur
installTime Die Zeit, zu der das Artefakt auf dem virtuellen Computer installiert wird. Schnur
Parameter Die Parameter des Artefakts. ArtifactParameterProperties[]
Status Der Status des Artefakts. Schnur
vmExtensionStatusMessage Die Statusmeldung aus der Erweiterung des virtuellen Computers. Schnur

ArtifactParameterProperties

Name Beschreibung Wert
Name Der Name des Artefaktparameters. Schnur
Wert Der Wert des Artefaktparameters. Schnur

AttachNewDataDiskOptions

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

DataDiskProperties

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

DayDetails

Name Beschreibung Wert
Zeit Die Tageszeit, zu der der Zeitplan eintritt. Schnur

GalleryImageReference

Name Beschreibung Wert
Angebot Das Angebot des Katalogbilds. Schnur
osType Der Betriebssystemtyp des Katalogimages. Schnur
Verlag Der Herausgeber des Katalogbilds. Schnur
Sku Die SKU des Katalogbilds. Schnur
Version Die Version des Katalogbilds. Schnur

HourDetails

Name Beschreibung Wert
Minute Minuten der Stunde, die der Zeitplan ausgeführt wird. Int

InboundNatRule

Name Beschreibung Wert
backPort Der Port, an den der externe Datenverkehr umgeleitet wird. Int
frontendPort Der externe Endpunktport der eingehenden Verbindung. Mögliche Werte liegen zwischen 1 und 65535 einschließlich. Wenn nicht angegeben, wird automatisch ein Wert zugewiesen. Int
transportProtocol Das Transportprotokoll für den Endpunkt. 'Tcp'
'Udp'

LabVirtualMachineProperties

Name Beschreibung Wert
allowClaim Gibt an, ob ein anderer Benutzer den Besitz des virtuellen Computers übernehmen kann. Bool
artefakte Die Artefakte, die auf dem virtuellen Computer installiert werden sollen. ArtifactInstallProperties[]
createdDate Das Erstellungsdatum des virtuellen Computers. Schnur
customImageId Der benutzerdefinierte Imagebezeichner des virtuellen Computers. Schnur
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. Schnur
expirationDate Das Ablaufdatum für den virtuellen Computer. Schnur
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 Subnetzname des virtuellen Computers. Schnur
labVirtualNetworkId Der virtuelle Netzwerkbezeichner der Übung des virtuellen Computers. Schnur
networkInterface Die Netzwerkschnittstelleneigenschaften. NetworkInterfaceProperties
Notizen Die Notizen des virtuellen Computers. Schnur
ownerObjectId Der Objektbezeichner des Besitzers des virtuellen Computers. Schnur
ownerUserPrincipalName Der Benutzerprinzipalname des Besitzers des virtuellen Computers. Schnur
Passwort Das Kennwort des Administrators des virtuellen Computers. Schnur

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
planId Die ID des Plans, der dem Image des virtuellen Computers zugeordnet ist Schnur
scheduleParameters Erstellungszeitpläne für virtuelle Computer ScheduleCreationParameter-[]
Größe Die Größe des virtuellen Computers. Schnur
sshKey Der SSH-Schlüssel des Administrators des virtuellen Computers. Schnur

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
storageType Speichertyp, der für virtuelle Computer verwendet werden soll (d. h. Standard, Premium). Schnur
Nutzername Der Benutzername des virtuellen Computers. Schnur

Microsoft.DevTestLab/labs/virtualmachines

Name Beschreibung Wert
Ort Der Speicherort der Ressource. Schnur
Name Der Ressourcenname Zeichenfolge (erforderlich)
Elternteil 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 des Typs: Labs
Eigenschaften Die Eigenschaften der Ressource. LabVirtualMachineProperties (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

NetworkInterfaceProperties

Name Beschreibung Wert
dnsName Der DNS-Name. Schnur
privateIpAddress Die private IP-Adresse. Schnur
publicIpAddress Die öffentliche IP-Adresse. Schnur
publicIpAddressId Die Ressourcen-ID der öffentlichen IP-Adresse. Schnur
rdpAuthority Die RdpAuthority-Eigenschaft ist ein Server-DNS-Hostname oder eine IP-Adresse gefolgt von der Dienstportnummer für RDP (RemoteDesktopprotokoll). Schnur
sharedPublicIpAddressConfiguration Die Konfiguration für die Freigabe einer öffentlichen IP-Adresse auf mehreren virtuellen Computern. SharedPublicIpAddressConfiguration
sshAuthority Die SshAuthority-Eigenschaft ist ein Server-DNS-Hostname oder eine IP-Adresse gefolgt von der Dienstportnummer für SSH. Schnur
subnetz-ID Die Ressourcen-ID des Unternetzes. Schnur
virtualNetworkId Die Ressourcen-ID des virtuellen Netzwerks. Schnur

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). Schnur
notificationLocale Das Gebietsschema, das beim Senden einer Benachrichtigung verwendet werden soll (Fallback für nicht unterstützte Sprachen ist EN). Schnur
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. Schnur

ResourceTags

Name Beschreibung Wert

ScheduleCreationParameter

Name Beschreibung Wert
Name Der Name des virtuellen Computers oder der Umgebung Schnur
Eigenschaften Die Eigenschaften des Zeitplans. ScheduleCreationParameterProperties-
Schilder Die Tags der Ressource. ScheduleCreationParameterTags

ScheduleCreationParameterProperties

Name Beschreibung Wert
dailyRecurrence Wenn der Zeitplan einmal pro Wochentag auftritt, geben Sie die tägliche Serie an. DayDetails-
hourlyRecurrence Wenn der Zeitplan mehrmals pro Tag auftritt, geben Sie die Stündlichkeitsserie an. HourDetails-
notificationSettings Benachrichtigungseinstellungen. NotificationSettings-
Status Der Status des Zeitplans (d. h. aktiviert, deaktiviert) "Deaktiviert"
"Aktiviert"
targetResourceId Die Ressourcen-ID, zu der der Zeitplan gehört Schnur
taskType Der Vorgangstyp des Zeitplans (z. B. LabVmsShutdownTask, LabVmAutoStart). Schnur
timeZoneId Die Zeitzonen-ID (z. B. China Standardzeit, Grönland Standardzeit, Pazifische Standardzeit usw.). Die möglichen Werte für diese Eigenschaft finden Sie in IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) Schnur
weeklyRecurrence Wenn der Zeitplan nur einige Wochentage auftritt, geben Sie die wöchentliche Serie an. WeekDetails-

ScheduleCreationParameterTags

Name Beschreibung Wert

SharedPublicIpAddressConfiguration

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

WeekDetails

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

Schnellstartbeispiele

Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.

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

ARM-Vorlagenressourcendefinition

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 unter Änderungsprotokoll.

Ressourcenformat

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

{
  "type": "Microsoft.DevTestLab/labs/virtualmachines",
  "apiVersion": "2018-09-15",
  "name": "string",
  "location": "string",
  "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",
          "timeZoneId": "string",
          "weeklyRecurrence": {
            "time": "string",
            "weekdays": [ "string" ]
          }
        },
        "tags": {
          "{customized property}": "string"
        }
      }
    ],
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "userName": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

ArtifactInstallProperties

Name Beschreibung Wert
artifactId Der Bezeichner des Artefakts. Schnur
artifactTitle Der Titel des Artefakts. Schnur
deploymentStatusMessage Die Statusmeldung aus der Bereitstellung. Schnur
installTime Die Zeit, zu der das Artefakt auf dem virtuellen Computer installiert wird. Schnur
Parameter Die Parameter des Artefakts. ArtifactParameterProperties[]
Status Der Status des Artefakts. Schnur
vmExtensionStatusMessage Die Statusmeldung aus der Erweiterung des virtuellen Computers. Schnur

ArtifactParameterProperties

Name Beschreibung Wert
Name Der Name des Artefaktparameters. Schnur
Wert Der Wert des Artefaktparameters. Schnur

AttachNewDataDiskOptions

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

DataDiskProperties

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

DayDetails

Name Beschreibung Wert
Zeit Die Tageszeit, zu der der Zeitplan eintritt. Schnur

GalleryImageReference

Name Beschreibung Wert
Angebot Das Angebot des Katalogbilds. Schnur
osType Der Betriebssystemtyp des Katalogimages. Schnur
Verlag Der Herausgeber des Katalogbilds. Schnur
Sku Die SKU des Katalogbilds. Schnur
Version Die Version des Katalogbilds. Schnur

HourDetails

Name Beschreibung Wert
Minute Minuten der Stunde, die der Zeitplan ausgeführt wird. Int

InboundNatRule

Name Beschreibung Wert
backPort Der Port, an den der externe Datenverkehr umgeleitet wird. Int
frontendPort Der externe Endpunktport der eingehenden Verbindung. Mögliche Werte liegen zwischen 1 und 65535 einschließlich. Wenn nicht angegeben, wird automatisch ein Wert zugewiesen. Int
transportProtocol Das Transportprotokoll für den Endpunkt. 'Tcp'
'Udp'

LabVirtualMachineProperties

Name Beschreibung Wert
allowClaim Gibt an, ob ein anderer Benutzer den Besitz des virtuellen Computers übernehmen kann. Bool
artefakte Die Artefakte, die auf dem virtuellen Computer installiert werden sollen. ArtifactInstallProperties[]
createdDate Das Erstellungsdatum des virtuellen Computers. Schnur
customImageId Der benutzerdefinierte Imagebezeichner des virtuellen Computers. Schnur
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. Schnur
expirationDate Das Ablaufdatum für den virtuellen Computer. Schnur
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 Subnetzname des virtuellen Computers. Schnur
labVirtualNetworkId Der virtuelle Netzwerkbezeichner der Übung des virtuellen Computers. Schnur
networkInterface Die Netzwerkschnittstelleneigenschaften. NetworkInterfaceProperties
Notizen Die Notizen des virtuellen Computers. Schnur
ownerObjectId Der Objektbezeichner des Besitzers des virtuellen Computers. Schnur
ownerUserPrincipalName Der Benutzerprinzipalname des Besitzers des virtuellen Computers. Schnur
Passwort Das Kennwort des Administrators des virtuellen Computers. Schnur

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
planId Die ID des Plans, der dem Image des virtuellen Computers zugeordnet ist Schnur
scheduleParameters Erstellungszeitpläne für virtuelle Computer ScheduleCreationParameter-[]
Größe Die Größe des virtuellen Computers. Schnur
sshKey Der SSH-Schlüssel des Administrators des virtuellen Computers. Schnur

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
storageType Speichertyp, der für virtuelle Computer verwendet werden soll (d. h. Standard, Premium). Schnur
Nutzername Der Benutzername des virtuellen Computers. Schnur

Microsoft.DevTestLab/labs/virtualmachines

Name Beschreibung Wert
apiVersion Die API-Version '2018-09-15'
Ort Der Speicherort der Ressource. Schnur
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Die Eigenschaften der Ressource. LabVirtualMachineProperties (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp "Microsoft.DevTestLab/labs/virtualmachines"

NetworkInterfaceProperties

Name Beschreibung Wert
dnsName Der DNS-Name. Schnur
privateIpAddress Die private IP-Adresse. Schnur
publicIpAddress Die öffentliche IP-Adresse. Schnur
publicIpAddressId Die Ressourcen-ID der öffentlichen IP-Adresse. Schnur
rdpAuthority Die RdpAuthority-Eigenschaft ist ein Server-DNS-Hostname oder eine IP-Adresse gefolgt von der Dienstportnummer für RDP (RemoteDesktopprotokoll). Schnur
sharedPublicIpAddressConfiguration Die Konfiguration für die Freigabe einer öffentlichen IP-Adresse auf mehreren virtuellen Computern. SharedPublicIpAddressConfiguration
sshAuthority Die SshAuthority-Eigenschaft ist ein Server-DNS-Hostname oder eine IP-Adresse gefolgt von der Dienstportnummer für SSH. Schnur
subnetz-ID Die Ressourcen-ID des Unternetzes. Schnur
virtualNetworkId Die Ressourcen-ID des virtuellen Netzwerks. Schnur

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). Schnur
notificationLocale Das Gebietsschema, das beim Senden einer Benachrichtigung verwendet werden soll (Fallback für nicht unterstützte Sprachen ist EN). Schnur
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. Schnur

ResourceTags

Name Beschreibung Wert

ScheduleCreationParameter

Name Beschreibung Wert
Name Der Name des virtuellen Computers oder der Umgebung Schnur
Eigenschaften Die Eigenschaften des Zeitplans. ScheduleCreationParameterProperties-
Schilder Die Tags der Ressource. ScheduleCreationParameterTags

ScheduleCreationParameterProperties

Name Beschreibung Wert
dailyRecurrence Wenn der Zeitplan einmal pro Wochentag auftritt, geben Sie die tägliche Serie an. DayDetails-
hourlyRecurrence Wenn der Zeitplan mehrmals pro Tag auftritt, geben Sie die Stündlichkeitsserie an. HourDetails-
notificationSettings Benachrichtigungseinstellungen. NotificationSettings-
Status Der Status des Zeitplans (d. h. aktiviert, deaktiviert) "Deaktiviert"
"Aktiviert"
targetResourceId Die Ressourcen-ID, zu der der Zeitplan gehört Schnur
taskType Der Vorgangstyp des Zeitplans (z. B. LabVmsShutdownTask, LabVmAutoStart). Schnur
timeZoneId Die Zeitzonen-ID (z. B. China Standardzeit, Grönland Standardzeit, Pazifische Standardzeit usw.). Die möglichen Werte für diese Eigenschaft finden Sie in IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) Schnur
weeklyRecurrence Wenn der Zeitplan nur einige Wochentage auftritt, geben Sie die wöchentliche Serie an. WeekDetails-

ScheduleCreationParameterTags

Name Beschreibung Wert

SharedPublicIpAddressConfiguration

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

WeekDetails

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

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
Erstellt ein Lab in Azure DevTest Labs mit einer beanspruchten VM-

Bereitstellen in Azure 		Diese Vorlage erstellt eine neue DevTest Lab/DTL-Instanz mit einer beanspruchten Windows Server 2019 Datacenter-VM darin. Weitere Azure Resource Manager-Schnellstartvorlagen für Azure DevTest Labs finden Sie unter https://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 unter Änderungsprotokoll.

Ressourcenformat

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  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"
            timeZoneId = "string"
            weeklyRecurrence = {
              time = "string"
              weekdays = [
                "string"
              ]
            }
          }
          tags = {
            {customized property} = "string"
          }
        }
      ]
      size = "string"
      sshKey = "string"
      storageType = "string"
      userName = "string"
    }
  })
}

Eigenschaftswerte

ArtifactInstallProperties

Name Beschreibung Wert
artifactId Der Bezeichner des Artefakts. Schnur
artifactTitle Der Titel des Artefakts. Schnur
deploymentStatusMessage Die Statusmeldung aus der Bereitstellung. Schnur
installTime Die Zeit, zu der das Artefakt auf dem virtuellen Computer installiert wird. Schnur
Parameter Die Parameter des Artefakts. ArtifactParameterProperties[]
Status Der Status des Artefakts. Schnur
vmExtensionStatusMessage Die Statusmeldung aus der Erweiterung des virtuellen Computers. Schnur

ArtifactParameterProperties

Name Beschreibung Wert
Name Der Name des Artefaktparameters. Schnur
Wert Der Wert des Artefaktparameters. Schnur

AttachNewDataDiskOptions

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

DataDiskProperties

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

DayDetails

Name Beschreibung Wert
Zeit Die Tageszeit, zu der der Zeitplan eintritt. Schnur

GalleryImageReference

Name Beschreibung Wert
Angebot Das Angebot des Katalogbilds. Schnur
osType Der Betriebssystemtyp des Katalogimages. Schnur
Verlag Der Herausgeber des Katalogbilds. Schnur
Sku Die SKU des Katalogbilds. Schnur
Version Die Version des Katalogbilds. Schnur

HourDetails

Name Beschreibung Wert
Minute Minuten der Stunde, die der Zeitplan ausgeführt wird. Int

InboundNatRule

Name Beschreibung Wert
backPort Der Port, an den der externe Datenverkehr umgeleitet wird. Int
frontendPort Der externe Endpunktport der eingehenden Verbindung. Mögliche Werte liegen zwischen 1 und 65535 einschließlich. Wenn nicht angegeben, wird automatisch ein Wert zugewiesen. Int
transportProtocol Das Transportprotokoll für den Endpunkt. 'Tcp'
'Udp'

LabVirtualMachineProperties

Name Beschreibung Wert
allowClaim Gibt an, ob ein anderer Benutzer den Besitz des virtuellen Computers übernehmen kann. Bool
artefakte Die Artefakte, die auf dem virtuellen Computer installiert werden sollen. ArtifactInstallProperties[]
createdDate Das Erstellungsdatum des virtuellen Computers. Schnur
customImageId Der benutzerdefinierte Imagebezeichner des virtuellen Computers. Schnur
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. Schnur
expirationDate Das Ablaufdatum für den virtuellen Computer. Schnur
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 Subnetzname des virtuellen Computers. Schnur
labVirtualNetworkId Der virtuelle Netzwerkbezeichner der Übung des virtuellen Computers. Schnur
networkInterface Die Netzwerkschnittstelleneigenschaften. NetworkInterfaceProperties
Notizen Die Notizen des virtuellen Computers. Schnur
ownerObjectId Der Objektbezeichner des Besitzers des virtuellen Computers. Schnur
ownerUserPrincipalName Der Benutzerprinzipalname des Besitzers des virtuellen Computers. Schnur
Passwort Das Kennwort des Administrators des virtuellen Computers. Schnur

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
planId Die ID des Plans, der dem Image des virtuellen Computers zugeordnet ist Schnur
scheduleParameters Erstellungszeitpläne für virtuelle Computer ScheduleCreationParameter-[]
Größe Die Größe des virtuellen Computers. Schnur
sshKey Der SSH-Schlüssel des Administrators des virtuellen Computers. Schnur

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
storageType Speichertyp, der für virtuelle Computer verwendet werden soll (d. h. Standard, Premium). Schnur
Nutzername Der Benutzername des virtuellen Computers. Schnur

Microsoft.DevTestLab/labs/virtualmachines

Name Beschreibung Wert
Ort Der Speicherort der Ressource. Schnur
Name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: Labs
Eigenschaften Die Eigenschaften der Ressource. LabVirtualMachineProperties (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"

NetworkInterfaceProperties

Name Beschreibung Wert
dnsName Der DNS-Name. Schnur
privateIpAddress Die private IP-Adresse. Schnur
publicIpAddress Die öffentliche IP-Adresse. Schnur
publicIpAddressId Die Ressourcen-ID der öffentlichen IP-Adresse. Schnur
rdpAuthority Die RdpAuthority-Eigenschaft ist ein Server-DNS-Hostname oder eine IP-Adresse gefolgt von der Dienstportnummer für RDP (RemoteDesktopprotokoll). Schnur
sharedPublicIpAddressConfiguration Die Konfiguration für die Freigabe einer öffentlichen IP-Adresse auf mehreren virtuellen Computern. SharedPublicIpAddressConfiguration
sshAuthority Die SshAuthority-Eigenschaft ist ein Server-DNS-Hostname oder eine IP-Adresse gefolgt von der Dienstportnummer für SSH. Schnur
subnetz-ID Die Ressourcen-ID des Unternetzes. Schnur
virtualNetworkId Die Ressourcen-ID des virtuellen Netzwerks. Schnur

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). Schnur
notificationLocale Das Gebietsschema, das beim Senden einer Benachrichtigung verwendet werden soll (Fallback für nicht unterstützte Sprachen ist EN). Schnur
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. Schnur

ResourceTags

Name Beschreibung Wert

ScheduleCreationParameter

Name Beschreibung Wert
Name Der Name des virtuellen Computers oder der Umgebung Schnur
Eigenschaften Die Eigenschaften des Zeitplans. ScheduleCreationParameterProperties-
Schilder Die Tags der Ressource. ScheduleCreationParameterTags

ScheduleCreationParameterProperties

Name Beschreibung Wert
dailyRecurrence Wenn der Zeitplan einmal pro Wochentag auftritt, geben Sie die tägliche Serie an. DayDetails-
hourlyRecurrence Wenn der Zeitplan mehrmals pro Tag auftritt, geben Sie die Stündlichkeitsserie an. HourDetails-
notificationSettings Benachrichtigungseinstellungen. NotificationSettings-
Status Der Status des Zeitplans (d. h. aktiviert, deaktiviert) "Deaktiviert"
"Aktiviert"
targetResourceId Die Ressourcen-ID, zu der der Zeitplan gehört Schnur
taskType Der Vorgangstyp des Zeitplans (z. B. LabVmsShutdownTask, LabVmAutoStart). Schnur
timeZoneId Die Zeitzonen-ID (z. B. China Standardzeit, Grönland Standardzeit, Pazifische Standardzeit usw.). Die möglichen Werte für diese Eigenschaft finden Sie in IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) Schnur
weeklyRecurrence Wenn der Zeitplan nur einige Wochentage auftritt, geben Sie die wöchentliche Serie an. WeekDetails-

ScheduleCreationParameterTags

Name Beschreibung Wert

SharedPublicIpAddressConfiguration

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

WeekDetails

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