Microsoft.DevTestLab Labs/virtualmachines

Artikel
2024-12-20

Bicep-Ressourcendefinition

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

Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

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

Ressourcenformat

Um eine Microsoft.DevTestLab/labs/virtualmachines-Ressource zu erstellen, fügen Sie 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[]

Verwendungsbeispiele

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

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:

Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

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

Ressourcenformat

Um eine Microsoft.DevTestLab/labs/virtualmachines-Ressource zu erstellen, fügen Sie 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[]

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Schablone	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

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

Freigeben über

Microsoft.DevTestLab Labs/virtualmachines

Bicep-Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Verwendungsbeispiele

Azure-Schnellstartbeispiele

ARM-Vorlagenressourcendefinition

Ressourcenformat

Eigenschaftswerte

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Ressourcenformat

Eigenschaftswerte

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Feedback

Zusätzliche Ressourcen