Freigeben über


Microsoft.DevTestLab Labs/virtualmachines 2016-05-15

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@2016-05-15' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    allowClaim: bool
    applicableSchedule: {
      location: 'string'
      properties: {
        labVmsShutdown: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {
            {customized property}: 'string'
          }
        }
        labVmsStartup: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {
            {customized property}: 'string'
          }
        }
      }
      tags: {
        {customized property}: 'string'
      }
    }
    artifactDeploymentStatus: {
      artifactsApplied: int
      deploymentStatus: 'string'
      totalArtifacts: int
    }
    artifacts: [
      {
        artifactId: 'string'
        deploymentStatusMessage: 'string'
        installTime: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
        status: 'string'
        vmExtensionStatusMessage: 'string'
      }
    ]
    computeVm: {
      dataDiskIds: [
        'string'
      ]
      dataDisks: [
        {
          diskSizeGiB: int
          diskUri: 'string'
          managedDiskId: 'string'
          name: 'string'
        }
      ]
      networkInterfaceId: 'string'
      osDiskId: 'string'
      osType: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          message: 'string'
        }
      ]
      vmSize: 'string'
    }
    createdByUser: 'string'
    createdByUserId: 'string'
    createdDate: 'string'
    customImageId: 'string'
    disallowPublicIpAddress: bool
    environmentId: 'string'
    expirationDate: 'string'
    fqdn: 'string'
    galleryImageReference: {
      offer: 'string'
      osType: 'string'
      publisher: 'string'
      sku: 'string'
      version: 'string'
    }
    isAuthenticationWithSshKey: bool
    labSubnetName: 'string'
    labVirtualNetworkId: 'string'
    networkInterface: {
      dnsName: 'string'
      privateIpAddress: 'string'
      publicIpAddress: 'string'
      publicIpAddressId: 'string'
      rdpAuthority: 'string'
      sharedPublicIpAddressConfiguration: {
        inboundNatRules: [
          {
            backendPort: int
            frontendPort: int
            transportProtocol: 'string'
          }
        ]
      }
      sshAuthority: 'string'
      subnetId: 'string'
      virtualNetworkId: 'string'
    }
    notes: 'string'
    osType: 'string'
    ownerObjectId: 'string'
    ownerUserPrincipalName: 'string'
    password: 'string'
    provisioningState: 'string'
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    uniqueIdentifier: 'string'
    userName: 'string'
    virtualMachineCreationSource: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

ApplicableSchedule

Name Beschreibung Wert
Ort Der Speicherort der Ressource. Schnur
Eigenschaften Die Eigenschaften der Ressource. ApplicableScheduleProperties (erforderlich)
Schilder Die Tags der Ressource. ResourceTags-

ApplicableScheduleProperties

Name Beschreibung Wert
labVmsShutdown Der Zeitplan für das automatische Herunterfahren, wenn eins auf Lab- oder Lab-Ressourcenebene festgelegt wurde. Zeitplan
labVmsStartup Der Zeitplan für den automatischen Start, wenn eins auf Lab- oder Lab-Ressourcenebene festgelegt wurde. Zeitplan

ArtifactDeploymentStatusProperties

Name Beschreibung Wert
artifactsApplied Die Gesamtanzahl der Artefakte, die erfolgreich angewendet wurden. Int
deploymentStatus Der Bereitstellungsstatus des Artefakts. Schnur
totalArtifacts Die Gesamtanzahl der Artefakte, die mit Vorbehalt angewendet wurden. Int

ArtifactInstallProperties

Name Beschreibung Wert
artifactId Der Bezeichner 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

ComputeDataDisk

Name Beschreibung Wert
diskSizeGiB Ruft die Größe des Datenträgers in GiB ab. Int
diskUri Bei Der Sicherung durch ein Blob wird der URI des zugrunde liegenden Blobs zurückgegeben. Schnur
managedDiskId Bei der Sicherung durch verwalteten Datenträger ist dies die ID der Computedatenträgerressource. Schnur
Name Ruft den Namen des Datenträgers ab. Schnur

ComputeVmInstanceViewStatus

Name Beschreibung Wert
Code Ruft den Statuscode ab. Schnur
displayStatus Ruft die kurze lokalisierbare Bezeichnung für den Status ab. Schnur
Nachricht Ruft die Nachricht ab, die dem Status zugeordnet ist. Schnur

ComputeVmProperties

Name Beschreibung Wert
dataDiskIds Ruft den BLOB-URI der Datenträger für den virtuellen Computer ab. string[]
dataDisks Ruft alle Datenträger ab, die an den virtuellen Computer angefügt sind. ComputeDataDisk[]
networkInterfaceId Ruft die Netzwerkschnittstellen-ID des virtuellen Computers ab. Schnur
osDiskId Ruft den BLOB-URI des Betriebssystemdatenträgers für den virtuellen Computer ab. Schnur
osType Ruft den Betriebssystemtyp des virtuellen Computers ab. Schnur
Status Ruft die Status des virtuellen Computers ab. ComputeVmInstanceViewStatus[]
vmSize Ruft die Größe des virtuellen Computers ab. Schnur

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
applicableSchedule Der entsprechende Zeitplan für den virtuellen Computer. ApplicableSchedule-
artifactDeploymentStatus Der Artefaktbereitstellungsstatus für den virtuellen Computer. ArtifactDeploymentStatusProperties
artefakte Die Artefakte, die auf dem virtuellen Computer installiert werden sollen. ArtifactInstallProperties[]
computeVm Die Computereigenschaften des virtuellen Computers. ComputeVmProperties
createdByUser Die E-Mail-Adresse des Erstellers des virtuellen Computers. Schnur
createdByUserId Der Objektbezeichner des Erstellers des virtuellen Computers. Schnur
createdDate Das Erstellungsdatum des virtuellen Computers. Schnur
customImageId Der benutzerdefinierte Imagebezeichner des virtuellen Computers. Schnur
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
fqdn Der vollqualifizierte Domänenname des virtuellen Computers. 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
osType Der Betriebssystemtyp 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
provisioningState Der Bereitstellungsstatus der Ressource. Schnur
Größe Die Größe des virtuellen Computers. Schnur
sshKey Der SSH-Schlüssel des Administrators des virtuellen Computers. Schnur
storageType Speichertyp, der für virtuelle Computer verwendet werden soll (d. h. Standard, Premium). Schnur
uniqueIdentifier Der eindeutige unveränderliche Bezeichner einer Ressource (GUID). Schnur
Nutzername Der Benutzername des virtuellen Computers. Schnur
virtualMachineCreationSource Gibt die Quelle der Erstellung des virtuellen Laborcomputers an. Nur Ausgabeeigenschaft. 'FromCustomImage'
'FromGalleryImage'

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

ResourceTags

Name Beschreibung Wert

ResourceTags

Name Beschreibung Wert

Zeitplan

Name Beschreibung Wert
Ort Der Speicherort der Ressource. Schnur
Eigenschaften Die Eigenschaften der Ressource. ScheduleProperties- (erforderlich)
Schilder Die Tags der Ressource. ResourceTags-

ScheduleProperties

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-
provisioningState Der Bereitstellungsstatus der Ressource. Schnur
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. Pacific Standard time). Schnur
uniqueIdentifier Der eindeutige unveränderliche Bezeichner einer Ressource (GUID). Schnur
weeklyRecurrence Wenn der Zeitplan nur einige Wochentage auftritt, geben Sie die wöchentliche Serie an. WeekDetails-

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": "2016-05-15",
  "name": "string",
  "location": "string",
  "properties": {
    "allowClaim": "bool",
    "applicableSchedule": {
      "location": "string",
      "properties": {
        "labVmsShutdown": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {
            "{customized property}": "string"
          }
        },
        "labVmsStartup": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {
            "{customized property}": "string"
          }
        }
      },
      "tags": {
        "{customized property}": "string"
      }
    },
    "artifactDeploymentStatus": {
      "artifactsApplied": "int",
      "deploymentStatus": "string",
      "totalArtifacts": "int"
    },
    "artifacts": [
      {
        "artifactId": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "computeVm": {
      "dataDiskIds": [ "string" ],
      "dataDisks": [
        {
          "diskSizeGiB": "int",
          "diskUri": "string",
          "managedDiskId": "string",
          "name": "string"
        }
      ],
      "networkInterfaceId": "string",
      "osDiskId": "string",
      "osType": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "message": "string"
        }
      ],
      "vmSize": "string"
    },
    "createdByUser": "string",
    "createdByUserId": "string",
    "createdDate": "string",
    "customImageId": "string",
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "string",
    "fqdn": "string",
    "galleryImageReference": {
      "offer": "string",
      "osType": "string",
      "publisher": "string",
      "sku": "string",
      "version": "string"
    },
    "isAuthenticationWithSshKey": "bool",
    "labSubnetName": "string",
    "labVirtualNetworkId": "string",
    "networkInterface": {
      "dnsName": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "publicIpAddressId": "string",
      "rdpAuthority": "string",
      "sharedPublicIpAddressConfiguration": {
        "inboundNatRules": [
          {
            "backendPort": "int",
            "frontendPort": "int",
            "transportProtocol": "string"
          }
        ]
      },
      "sshAuthority": "string",
      "subnetId": "string",
      "virtualNetworkId": "string"
    },
    "notes": "string",
    "osType": "string",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "provisioningState": "string",
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "uniqueIdentifier": "string",
    "userName": "string",
    "virtualMachineCreationSource": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

ApplicableSchedule

Name Beschreibung Wert
Ort Der Speicherort der Ressource. Schnur
Eigenschaften Die Eigenschaften der Ressource. ApplicableScheduleProperties (erforderlich)
Schilder Die Tags der Ressource. ResourceTags-

ApplicableScheduleProperties

Name Beschreibung Wert
labVmsShutdown Der Zeitplan für das automatische Herunterfahren, wenn eins auf Lab- oder Lab-Ressourcenebene festgelegt wurde. Zeitplan
labVmsStartup Der Zeitplan für den automatischen Start, wenn eins auf Lab- oder Lab-Ressourcenebene festgelegt wurde. Zeitplan

ArtifactDeploymentStatusProperties

Name Beschreibung Wert
artifactsApplied Die Gesamtanzahl der Artefakte, die erfolgreich angewendet wurden. Int
deploymentStatus Der Bereitstellungsstatus des Artefakts. Schnur
totalArtifacts Die Gesamtanzahl der Artefakte, die mit Vorbehalt angewendet wurden. Int

ArtifactInstallProperties

Name Beschreibung Wert
artifactId Der Bezeichner 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

ComputeDataDisk

Name Beschreibung Wert
diskSizeGiB Ruft die Größe des Datenträgers in GiB ab. Int
diskUri Bei Der Sicherung durch ein Blob wird der URI des zugrunde liegenden Blobs zurückgegeben. Schnur
managedDiskId Bei der Sicherung durch verwalteten Datenträger ist dies die ID der Computedatenträgerressource. Schnur
Name Ruft den Namen des Datenträgers ab. Schnur

ComputeVmInstanceViewStatus

Name Beschreibung Wert
Code Ruft den Statuscode ab. Schnur
displayStatus Ruft die kurze lokalisierbare Bezeichnung für den Status ab. Schnur
Nachricht Ruft die Nachricht ab, die dem Status zugeordnet ist. Schnur

ComputeVmProperties

Name Beschreibung Wert
dataDiskIds Ruft den BLOB-URI der Datenträger für den virtuellen Computer ab. string[]
dataDisks Ruft alle Datenträger ab, die an den virtuellen Computer angefügt sind. ComputeDataDisk[]
networkInterfaceId Ruft die Netzwerkschnittstellen-ID des virtuellen Computers ab. Schnur
osDiskId Ruft den BLOB-URI des Betriebssystemdatenträgers für den virtuellen Computer ab. Schnur
osType Ruft den Betriebssystemtyp des virtuellen Computers ab. Schnur
Status Ruft die Status des virtuellen Computers ab. ComputeVmInstanceViewStatus[]
vmSize Ruft die Größe des virtuellen Computers ab. Schnur

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
applicableSchedule Der entsprechende Zeitplan für den virtuellen Computer. ApplicableSchedule-
artifactDeploymentStatus Der Artefaktbereitstellungsstatus für den virtuellen Computer. ArtifactDeploymentStatusProperties
artefakte Die Artefakte, die auf dem virtuellen Computer installiert werden sollen. ArtifactInstallProperties[]
computeVm Die Computereigenschaften des virtuellen Computers. ComputeVmProperties
createdByUser Die E-Mail-Adresse des Erstellers des virtuellen Computers. Schnur
createdByUserId Der Objektbezeichner des Erstellers des virtuellen Computers. Schnur
createdDate Das Erstellungsdatum des virtuellen Computers. Schnur
customImageId Der benutzerdefinierte Imagebezeichner des virtuellen Computers. Schnur
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
fqdn Der vollqualifizierte Domänenname des virtuellen Computers. 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
osType Der Betriebssystemtyp 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
provisioningState Der Bereitstellungsstatus der Ressource. Schnur
Größe Die Größe des virtuellen Computers. Schnur
sshKey Der SSH-Schlüssel des Administrators des virtuellen Computers. Schnur
storageType Speichertyp, der für virtuelle Computer verwendet werden soll (d. h. Standard, Premium). Schnur
uniqueIdentifier Der eindeutige unveränderliche Bezeichner einer Ressource (GUID). Schnur
Nutzername Der Benutzername des virtuellen Computers. Schnur
virtualMachineCreationSource Gibt die Quelle der Erstellung des virtuellen Laborcomputers an. Nur Ausgabeeigenschaft. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

Name Beschreibung Wert
apiVersion Die API-Version '2016-05-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
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

ResourceTags

Name Beschreibung Wert

ResourceTags

Name Beschreibung Wert

Zeitplan

Name Beschreibung Wert
Ort Der Speicherort der Ressource. Schnur
Eigenschaften Die Eigenschaften der Ressource. ScheduleProperties- (erforderlich)
Schilder Die Tags der Ressource. ResourceTags-

ScheduleProperties

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-
provisioningState Der Bereitstellungsstatus der Ressource. Schnur
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. Pacific Standard time). Schnur
uniqueIdentifier Der eindeutige unveränderliche Bezeichner einer Ressource (GUID). Schnur
weeklyRecurrence Wenn der Zeitplan nur einige Wochentage auftritt, geben Sie die wöchentliche Serie an. WeekDetails-

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@2016-05-15"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      allowClaim = bool
      applicableSchedule = {
        location = "string"
        properties = {
          labVmsShutdown = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {
              {customized property} = "string"
            }
          }
          labVmsStartup = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {
              {customized property} = "string"
            }
          }
        }
        tags = {
          {customized property} = "string"
        }
      }
      artifactDeploymentStatus = {
        artifactsApplied = int
        deploymentStatus = "string"
        totalArtifacts = int
      }
      artifacts = [
        {
          artifactId = "string"
          deploymentStatusMessage = "string"
          installTime = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
          status = "string"
          vmExtensionStatusMessage = "string"
        }
      ]
      computeVm = {
        dataDiskIds = [
          "string"
        ]
        dataDisks = [
          {
            diskSizeGiB = int
            diskUri = "string"
            managedDiskId = "string"
            name = "string"
          }
        ]
        networkInterfaceId = "string"
        osDiskId = "string"
        osType = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            message = "string"
          }
        ]
        vmSize = "string"
      }
      createdByUser = "string"
      createdByUserId = "string"
      createdDate = "string"
      customImageId = "string"
      disallowPublicIpAddress = bool
      environmentId = "string"
      expirationDate = "string"
      fqdn = "string"
      galleryImageReference = {
        offer = "string"
        osType = "string"
        publisher = "string"
        sku = "string"
        version = "string"
      }
      isAuthenticationWithSshKey = bool
      labSubnetName = "string"
      labVirtualNetworkId = "string"
      networkInterface = {
        dnsName = "string"
        privateIpAddress = "string"
        publicIpAddress = "string"
        publicIpAddressId = "string"
        rdpAuthority = "string"
        sharedPublicIpAddressConfiguration = {
          inboundNatRules = [
            {
              backendPort = int
              frontendPort = int
              transportProtocol = "string"
            }
          ]
        }
        sshAuthority = "string"
        subnetId = "string"
        virtualNetworkId = "string"
      }
      notes = "string"
      osType = "string"
      ownerObjectId = "string"
      ownerUserPrincipalName = "string"
      password = "string"
      provisioningState = "string"
      size = "string"
      sshKey = "string"
      storageType = "string"
      uniqueIdentifier = "string"
      userName = "string"
      virtualMachineCreationSource = "string"
    }
  })
}

Eigenschaftswerte

ApplicableSchedule

Name Beschreibung Wert
Ort Der Speicherort der Ressource. Schnur
Eigenschaften Die Eigenschaften der Ressource. ApplicableScheduleProperties (erforderlich)
Schilder Die Tags der Ressource. ResourceTags-

ApplicableScheduleProperties

Name Beschreibung Wert
labVmsShutdown Der Zeitplan für das automatische Herunterfahren, wenn eins auf Lab- oder Lab-Ressourcenebene festgelegt wurde. Zeitplan
labVmsStartup Der Zeitplan für den automatischen Start, wenn eins auf Lab- oder Lab-Ressourcenebene festgelegt wurde. Zeitplan

ArtifactDeploymentStatusProperties

Name Beschreibung Wert
artifactsApplied Die Gesamtanzahl der Artefakte, die erfolgreich angewendet wurden. Int
deploymentStatus Der Bereitstellungsstatus des Artefakts. Schnur
totalArtifacts Die Gesamtanzahl der Artefakte, die mit Vorbehalt angewendet wurden. Int

ArtifactInstallProperties

Name Beschreibung Wert
artifactId Der Bezeichner 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

ComputeDataDisk

Name Beschreibung Wert
diskSizeGiB Ruft die Größe des Datenträgers in GiB ab. Int
diskUri Bei Der Sicherung durch ein Blob wird der URI des zugrunde liegenden Blobs zurückgegeben. Schnur
managedDiskId Bei der Sicherung durch verwalteten Datenträger ist dies die ID der Computedatenträgerressource. Schnur
Name Ruft den Namen des Datenträgers ab. Schnur

ComputeVmInstanceViewStatus

Name Beschreibung Wert
Code Ruft den Statuscode ab. Schnur
displayStatus Ruft die kurze lokalisierbare Bezeichnung für den Status ab. Schnur
Nachricht Ruft die Nachricht ab, die dem Status zugeordnet ist. Schnur

ComputeVmProperties

Name Beschreibung Wert
dataDiskIds Ruft den BLOB-URI der Datenträger für den virtuellen Computer ab. string[]
dataDisks Ruft alle Datenträger ab, die an den virtuellen Computer angefügt sind. ComputeDataDisk[]
networkInterfaceId Ruft die Netzwerkschnittstellen-ID des virtuellen Computers ab. Schnur
osDiskId Ruft den BLOB-URI des Betriebssystemdatenträgers für den virtuellen Computer ab. Schnur
osType Ruft den Betriebssystemtyp des virtuellen Computers ab. Schnur
Status Ruft die Status des virtuellen Computers ab. ComputeVmInstanceViewStatus[]
vmSize Ruft die Größe des virtuellen Computers ab. Schnur

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
applicableSchedule Der entsprechende Zeitplan für den virtuellen Computer. ApplicableSchedule-
artifactDeploymentStatus Der Artefaktbereitstellungsstatus für den virtuellen Computer. ArtifactDeploymentStatusProperties
artefakte Die Artefakte, die auf dem virtuellen Computer installiert werden sollen. ArtifactInstallProperties[]
computeVm Die Computereigenschaften des virtuellen Computers. ComputeVmProperties
createdByUser Die E-Mail-Adresse des Erstellers des virtuellen Computers. Schnur
createdByUserId Der Objektbezeichner des Erstellers des virtuellen Computers. Schnur
createdDate Das Erstellungsdatum des virtuellen Computers. Schnur
customImageId Der benutzerdefinierte Imagebezeichner des virtuellen Computers. Schnur
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
fqdn Der vollqualifizierte Domänenname des virtuellen Computers. 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
osType Der Betriebssystemtyp 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
provisioningState Der Bereitstellungsstatus der Ressource. Schnur
Größe Die Größe des virtuellen Computers. Schnur
sshKey Der SSH-Schlüssel des Administrators des virtuellen Computers. Schnur
storageType Speichertyp, der für virtuelle Computer verwendet werden soll (d. h. Standard, Premium). Schnur
uniqueIdentifier Der eindeutige unveränderliche Bezeichner einer Ressource (GUID). Schnur
Nutzername Der Benutzername des virtuellen Computers. Schnur
virtualMachineCreationSource Gibt die Quelle der Erstellung des virtuellen Laborcomputers an. Nur Ausgabeeigenschaft. 'FromCustomImage'
'FromGalleryImage'

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@2016-05-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
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

ResourceTags

Name Beschreibung Wert

ResourceTags

Name Beschreibung Wert

Zeitplan

Name Beschreibung Wert
Ort Der Speicherort der Ressource. Schnur
Eigenschaften Die Eigenschaften der Ressource. ScheduleProperties- (erforderlich)
Schilder Die Tags der Ressource. ResourceTags-

ScheduleProperties

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-
provisioningState Der Bereitstellungsstatus der Ressource. Schnur
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. Pacific Standard time). Schnur
uniqueIdentifier Der eindeutige unveränderliche Bezeichner einer Ressource (GUID). Schnur
weeklyRecurrence Wenn der Zeitplan nur einige Wochentage auftritt, geben Sie die wöchentliche Serie an. WeekDetails-

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