Freigeben über


Microsoft.DevTestLab Labs

Bicep-Ressourcendefinition

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

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

Ressourcenformat

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

resource symbolicname 'Microsoft.DevTestLab/labs@2018-09-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    announcement: {
      enabled: 'string'
      expirationDate: 'string'
      expired: bool
      markdown: 'string'
      title: 'string'
    }
    environmentPermission: 'string'
    extendedProperties: {}
    labStorageType: 'string'
    mandatoryArtifactsResourceIdsLinux: [
      'string'
    ]
    mandatoryArtifactsResourceIdsWindows: [
      'string'
    ]
    premiumDataDisks: 'string'
    support: {
      enabled: 'string'
      markdown: 'string'
    }
  }
}

Eigenschaftswerte

labs

Name Beschreibung Wert
name Der Ressourcenname Zeichenfolge (erforderlich)

Zeichenlimit: 1-50

Gültige Zeichen:
Alphanumerische Zeichen, Unterstriche und Bindestriche.
location Der Speicherort der Ressource. Zeichenfolge
tags Die Tags der Ressource. Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen.
properties Die Eigenschaften der Ressource. LabProperties

LabProperties

Name Beschreibung Wert
Ankündigung Die Eigenschaften aller Labankündigungen, die diesem Lab zugeordnet sind LabAnnouncementProperties
Environmentpermission Die Zugriffsrechte, die dem Benutzer beim Bereitstellen einer Umgebung gewährt werden sollen "Mitwirkender"
"Reader"
extendedProperties Erweiterte Eigenschaften des Labs, das für experimentelle Features verwendet wird Objekt (object)
labStorageType Speichertyp, der vom Lab verwendet wird. Es kann entweder Premium oder Standard sein. Der Standardwert ist Premium. "Premium"
"Standard"
"StandardSSD"
mandatoryArtifactsResourceIdsLinux Die sortierte Liste der Artefaktressourcen-IDs, die vor den vom Benutzer angegebenen Artefakten standardmäßig auf alle Linux-VM-Erstellungen angewendet werden sollen. string[]
mandatoryArtifactsResourceIdsWindows Die sortierte Liste der Artefaktressourcen-IDs, die vor den vom Benutzer angegebenen Artefakten standardmäßig auf alle Windows-VM-Erstellungen angewendet werden sollen. string[]
premiumDataDisks Die Einstellung zum Aktivieren der Verwendung von Premium-Datenträgern.
Wenn der Wert "Enabled" lautet, ist die Erstellung von Standard- oder Premium-Datenträgern zulässig.
Wenn der Wert "Disabled" lautet, ist nur die Erstellung von Standarddatenträgern zulässig.
"Deaktiviert"
"Aktiviert"
support Die Eigenschaften jeder Lab-Supportnachricht, die diesem Lab zugeordnet ist LabSupportProperties

LabAnnouncementProperties

Name Beschreibung Wert
enabled Ist die Labankündigung zu diesem Zeitpunkt aktiv/aktiviert? "Deaktiviert"
"Aktiviert"
expirationDate Der Zeitpunkt, zu dem die Ankündigung abläuft (NULL für nie) Zeichenfolge
Abgelaufen Ist diese Ankündigung abgelaufen? bool
markdown Der Markdowntext (sofern vorhanden), den dieses Lab auf der Benutzeroberfläche anzeigt. Wenn leer/NULL gelassen wird, wird nichts angezeigt. Zeichenfolge
title Der Nur-Text-Titel für die Labankündigung Zeichenfolge

LabSupportProperties

Name Beschreibung Wert
enabled Ist das Lab-Supportbanner zu diesem Zeitpunkt aktiv/aktiviert? "Deaktiviert"
"Aktiviert"
markdown Der Markdowntext (sofern vorhanden), den dieses Lab auf der Benutzeroberfläche anzeigt. Wenn leer/NULL gelassen wird, wird nichts angezeigt. Zeichenfolge

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage Beschreibung
Erstellen eines neuen Labs in Azure DevTest Labs

In Azure bereitstellen
Mit dieser Vorlage wird eine neue DevTest Lab/DTL-instance erstellt. Weitere Azure Resource Manager-Schnellstartvorlagen für Azure DevTestlab finden Sie unterhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Erstellt ein Lab in Azure DevTest Labs mit einer Windows Server-VM

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

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

Ressourcendefinition mit einer ARM-Vorlage

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

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

Ressourcenformat

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

{
  "type": "Microsoft.DevTestLab/labs",
  "apiVersion": "2018-09-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "announcement": {
      "enabled": "string",
      "expirationDate": "string",
      "expired": "bool",
      "markdown": "string",
      "title": "string"
    },
    "environmentPermission": "string",
    "extendedProperties": {},
    "labStorageType": "string",
    "mandatoryArtifactsResourceIdsLinux": [ "string" ],
    "mandatoryArtifactsResourceIdsWindows": [ "string" ],
    "premiumDataDisks": "string",
    "support": {
      "enabled": "string",
      "markdown": "string"
    }
  }
}

Eigenschaftswerte

labs

Name Beschreibung Wert
type Der Ressourcentyp "Microsoft.DevTestLab/labs"
apiVersion Die Version der Ressourcen-API '2018-09-15'
name Der Ressourcenname Zeichenfolge (erforderlich)

Zeichenlimit: 1-50

Gültige Zeichen:
Alphanumerische Zeichen, Unterstriche und Bindestriche.
location Der Speicherort der Ressource. Zeichenfolge
tags Die Tags der Ressource. Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen.
properties Die Eigenschaften der Ressource. LabProperties

LabProperties

Name Beschreibung Wert
Ankündigung Die Eigenschaften aller Labankündigungen, die diesem Lab zugeordnet sind LabAnnouncementProperties
Environmentpermission Die Zugriffsrechte, die dem Benutzer beim Bereitstellen einer Umgebung gewährt werden sollen "Mitwirkender"
"Reader"
extendedProperties Erweiterte Eigenschaften des Labs, das für experimentelle Features verwendet wird Objekt (object)
labStorageType Speichertyp, der vom Lab verwendet wird. Es kann entweder Premium oder Standard sein. Der Standardwert ist Premium. "Premium"
"Standard"
"StandardSSD"
mandatoryArtifactsResourceIdsLinux Die sortierte Liste der Artefaktressourcen-IDs, die vor den vom Benutzer angegebenen Artefakten standardmäßig auf alle Linux-VM-Erstellungen angewendet werden sollen. string[]
mandatoryArtifactsResourceIdsWindows Die sortierte Liste der Artefaktressourcen-IDs, die vor den vom Benutzer angegebenen Artefakten standardmäßig auf alle Windows-VM-Erstellungen angewendet werden sollen. string[]
premiumDataDisks Die Einstellung zum Aktivieren der Verwendung von Premium-Datenträgern.
Wenn der Wert "Enabled" lautet, ist die Erstellung von Standard- oder Premium-Datenträgern zulässig.
Wenn der Wert "Disabled" lautet, ist nur die Erstellung von Standarddatenträgern zulässig.
"Deaktiviert"
"Aktiviert"
support Die Eigenschaften jeder Lab-Supportnachricht, die diesem Lab zugeordnet ist LabSupportProperties

LabAnnouncementProperties

Name Beschreibung Wert
enabled Ist die Labankündigung zu diesem Zeitpunkt aktiv/aktiviert? "Deaktiviert"
"Aktiviert"
expirationDate Der Zeitpunkt, zu dem die Ankündigung abläuft (NULL für nie) Zeichenfolge
Abgelaufen Ist diese Ankündigung abgelaufen? bool
markdown Der Markdowntext (falls vorhanden), den dieses Lab auf der Benutzeroberfläche anzeigt. Wenn leer/NULL bleibt, wird nichts angezeigt. Zeichenfolge
title Der Nur-Text-Titel für die Labankündigung Zeichenfolge

LabSupportProperties

Name Beschreibung Wert
enabled Ist das Lab-Supportbanner zu diesem Zeitpunkt aktiv/aktiviert? "Deaktiviert"
"Aktiviert"
markdown Der Markdowntext (falls vorhanden), den dieses Lab auf der Benutzeroberfläche anzeigt. Wenn leer/NULL bleibt, wird nichts angezeigt. Zeichenfolge

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.

Vorlage Beschreibung
Erstellen eines neuen Labs in Azure DevTest Labs

In Azure bereitstellen
Mit dieser Vorlage wird ein neues DevTest Lab/DTL-instance erstellt. Weitere Azure Resource Manager-Schnellstartvorlagen für Azure DevTestlab finden Sie unterhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Erstellt ein Lab in Azure DevTest Labs mit einer Windows Server-VM

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

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

Terraform (AzAPI-Anbieter) Ressourcendefinition

Der Labs-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

  • Ressourcengruppen

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

Ressourcenformat

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs@2018-09-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      announcement = {
        enabled = "string"
        expirationDate = "string"
        expired = bool
        markdown = "string"
        title = "string"
      }
      environmentPermission = "string"
      extendedProperties = {}
      labStorageType = "string"
      mandatoryArtifactsResourceIdsLinux = [
        "string"
      ]
      mandatoryArtifactsResourceIdsWindows = [
        "string"
      ]
      premiumDataDisks = "string"
      support = {
        enabled = "string"
        markdown = "string"
      }
    }
  })
}

Eigenschaftswerte

labs

Name Beschreibung Wert
type Ressourcentyp "Microsoft.DevTestLab/labs@2018-09-15"
name Der Ressourcenname Zeichenfolge (erforderlich)

Zeichenlimit: 1-50

Gültige Zeichen:
Alphanumerische Zeichen, Unterstriche und Bindestriche.
location Der Speicherort der Ressource. Zeichenfolge
parent_id Verwenden Sie zum Bereitstellen in einer Ressourcengruppe die ID dieser Ressourcengruppe. Zeichenfolge (erforderlich)
tags Die Tags der Ressource. Wörterbuch der Tagnamen und -werte.
properties Die Eigenschaften der Ressource. LabProperties

LabProperties

Name Beschreibung Wert
Ankündigung Die Eigenschaften jeder Labankündigung, die diesem Lab zugeordnet ist LabAnnouncementProperties
Environmentpermission Die Zugriffsrechte, die dem Benutzer bei der Bereitstellung einer Umgebung gewährt werden sollen "Mitwirkender"
"Reader"
extendedProperties Erweiterte Eigenschaften des Labs, das für experimentelle Features verwendet wird Objekt (object)
labStorageType Speichertyp, der vom Lab verwendet wird. Es kann entweder Premium oder Standard sein. Der Standardwert ist Premium. "Premium"
„Standard“
"StandardSSD"
mandatoryArtifactsResourceIdsLinux Die sortierte Liste der Artefaktressourcen-IDs, die standardmäßig auf alle Linux-VM-Erstellungen vor den vom Benutzer angegebenen Artefakten angewendet werden sollen. string[]
mandatoryArtifactsResourceIdsWindows Die sortierte Liste der Artefaktressourcen-IDs, die standardmäßig auf alle Windows-VM-Erstellungen vor den vom Benutzer angegebenen Artefakten angewendet werden sollen. string[]
premiumDataDisks Die Einstellung zum Aktivieren der Verwendung von Premium-Datenträgern.
Wenn der Wert "Aktiviert" ist, ist die Erstellung von Standard- oder Premium-Datenträgern zulässig.
Wenn der Wert "Deaktiviert" lautet, ist nur die Erstellung von Standarddatenträgern zulässig.
"Deaktiviert"
"Aktiviert"
support Die Eigenschaften einer beliebigen Lab-Supportnachricht, die diesem Lab zugeordnet ist LabSupportProperties

LabAnnouncementProperties

Name Beschreibung Wert
enabled Ist die Labankündigung zu diesem Zeitpunkt aktiv/aktiviert? "Deaktiviert"
"Aktiviert"
expirationDate Der Zeitpunkt, zu dem die Ankündigung abläuft (NULL für nie) Zeichenfolge
Abgelaufen Ist diese Ankündigung abgelaufen? bool
markdown Der Markdowntext (falls vorhanden), den dieses Lab auf der Benutzeroberfläche anzeigt. Wenn leer/NULL bleibt, wird nichts angezeigt. Zeichenfolge
title Der Nur-Text-Titel für die Labankündigung Zeichenfolge

LabSupportProperties

Name Beschreibung Wert
enabled Ist das Lab-Supportbanner zu diesem Zeitpunkt aktiv/aktiviert? "Deaktiviert"
"Aktiviert"
markdown Der Markdowntext (falls vorhanden), den dieses Lab auf der Benutzeroberfläche anzeigt. Wenn leer/NULL bleibt, wird nichts angezeigt. Zeichenfolge