Share via

Microsoft.DevTestLab labs/virtualmachines 2018-09-15

  • Artykuł

Definicja zasobu Bicep

Typ zasobu labs/virtualmachines można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevTestLab/labs/virtualmachines, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2018-09-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    allowClaim: bool
    artifacts: [
      {
        artifactId: 'string'
        artifactTitle: 'string'
        deploymentStatusMessage: 'string'
        installTime: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
        status: 'string'
        vmExtensionStatusMessage: 'string'
      }
    ]
    createdDate: 'string'
    customImageId: 'string'
    dataDiskParameters: [
      {
        attachNewDataDiskOptions: {
          diskName: 'string'
          diskSizeGiB: int
          diskType: 'string'
        }
        existingLabDiskId: 'string'
        hostCaching: 'string'
      }
    ]
    disallowPublicIpAddress: bool
    environmentId: 'string'
    expirationDate: 'string'
    galleryImageReference: {
      offer: 'string'
      osType: 'string'
      publisher: 'string'
      sku: 'string'
      version: 'string'
    }
    isAuthenticationWithSshKey: bool
    labSubnetName: 'string'
    labVirtualNetworkId: 'string'
    networkInterface: {
      dnsName: 'string'
      privateIpAddress: 'string'
      publicIpAddress: 'string'
      publicIpAddressId: 'string'
      rdpAuthority: 'string'
      sharedPublicIpAddressConfiguration: {
        inboundNatRules: [
          {
            backendPort: int
            frontendPort: int
            transportProtocol: 'string'
          }
        ]
      }
      sshAuthority: 'string'
      subnetId: 'string'
      virtualNetworkId: 'string'
    }
    notes: 'string'
    ownerObjectId: 'string'
    ownerUserPrincipalName: 'string'
    password: 'string'
    planId: 'string'
    scheduleParameters: [
      {
        name: 'string'
        properties: {
          dailyRecurrence: {
            time: 'string'
          }
          hourlyRecurrence: {
            minute: int
          }
          notificationSettings: {
            emailRecipient: 'string'
            notificationLocale: 'string'
            status: 'string'
            timeInMinutes: int
            webhookUrl: 'string'
          }
          status: 'string'
          targetResourceId: 'string'
          taskType: 'string'
          weeklyRecurrence: {
            time: 'string'
            weekdays: [
              'string'
            ]
          }
        }
        tags: {}
      }
    ]
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    userName: 'string'
  }
}

Wartości właściwości

labs/virtualmachines

Nazwa Opis Wartość
name Nazwa zasobu

Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w aplikacji Bicep.		 ciąg (wymagany)

Limit znaków: 1–15 (Windows)
1–64 (Linux)

Prawidłowe znaki:
Alfanumeryczne i łączniki.

Rozpocznij i zakończ od alfanumeryczne. Nie można zawierać wszystkich liczb.
location Lokalizacja zasobu. ciąg
tags Tagi zasobu. Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
Nadrzędny W pliku Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.		 Symboliczna nazwa zasobu typu: laboratoria
properties Właściwości zasobu. LabVirtualMachineProperties (wymagane)

LabVirtualMachineProperties

Nazwa Opis Wartość
allowClaim Wskazuje, czy inny użytkownik może przejąć własność maszyny wirtualnej bool
Artefakty Artefakty do zainstalowania na maszynie wirtualnej. ArtifactInstallProperties[]
createdDate Data utworzenia maszyny wirtualnej. ciąg
customImageId Identyfikator obrazu niestandardowego maszyny wirtualnej. ciąg
dataDiskParameters Nowe lub istniejące dyski danych do dołączania do maszyny wirtualnej po utworzeniu DataDiskProperties[]
disallowPublicIpAddress Wskazuje, czy maszyna wirtualna ma zostać utworzona bez publicznego adresu IP. bool
environmentId Identyfikator zasobu środowiska, który zawiera tę maszynę wirtualną, jeśli istnieje. ciąg
data wygaśnięcia Data wygaśnięcia maszyny wirtualnej. ciąg
galleryImageReference Dokumentacja obrazu Azure Marketplace firmy Microsoft dla maszyny wirtualnej. GalleryImageReference
isAuthenticationWithSshKey Wskazuje, czy ta maszyna wirtualna używa klucza SSH do uwierzytelniania. bool
labSubnetName Nazwa podsieci laboratorium maszyny wirtualnej. ciąg
labVirtualNetworkId Identyfikator sieci wirtualnej laboratorium maszyny wirtualnej. ciąg
networkInterface Właściwości interfejsu sieciowego. NetworkInterfaceProperties
Uwagi Uwagi dotyczące maszyny wirtualnej. ciąg
ownerObjectId Identyfikator obiektu właściciela maszyny wirtualnej. ciąg
ownerUserPrincipalName Główna nazwa użytkownika właściciela maszyny wirtualnej. ciąg
hasło Hasło administratora maszyny wirtualnej. ciąg
identyfikator planu Identyfikator planu skojarzonego z obrazem maszyny wirtualnej ciąg
scheduleParameters Harmonogramy tworzenia maszyn wirtualnych ScheduleCreationParameter[]
size Rozmiar maszyny wirtualnej. ciąg
sshKey Klucz SSH administratora maszyny wirtualnej. ciąg
storageType Typ magazynu do użycia dla maszyny wirtualnej (tj. Standardowa, Premium). ciąg
userName Nazwa użytkownika maszyny wirtualnej. ciąg

ArtifactInstallProperties

Nazwa Opis Wartość
artifactId Identyfikator artefaktu. ciąg
artifactTitle Tytuł artefaktu. ciąg
deploymentStatusMessage Komunikat o stanie z wdrożenia. ciąg
installTime Czas rozpoczęcia instalacji artefaktu na maszynie wirtualnej. ciąg
parameters Parametry artefaktu. ArtifactParameterProperties[]
status Stan artefaktu. ciąg
vmExtensionStatusMessage Komunikat o stanie z rozszerzenia maszyny wirtualnej. ciąg

ArtifactParameterProperties

Nazwa Opis Wartość
name Nazwa parametru artefaktu. ciąg
wartość Wartość parametru artefaktu. ciąg

DataDiskProperties

Nazwa Opis Wartość
attachNewDataDiskOptions Określa opcje dołączania nowego dysku do maszyny wirtualnej. AttachNewDataDiskOptions
existingLabDiskId Określa istniejący identyfikator dysku laboratorium, który ma zostać dołączony do maszyny wirtualnej. ciąg
hostCaching Opcja buforowania dysku danych (tj. Brak, ReadOnly, ReadWrite). "Brak"
"ReadOnly"
"ReadWrite"

AttachNewDataDiskOptions

Nazwa Opis Wartość
diskName Nazwa dysku do dołączenia. ciąg
diskSizeGiB Rozmiar dysku do dołączenia w gibibajtach. int
diskType Typ magazynu dysku (tj. Standardowa, Premium). "Premium"
"Standardowa"
"StandardSSD"

GalleryImageReference

Nazwa Opis Wartość
offer Oferta obrazu galerii. ciąg
osType Typ systemu operacyjnego obrazu galerii. ciąg
publisher Wydawca obrazu galerii. ciąg
sku Jednostka SKU obrazu galerii. ciąg
Wersja Wersja obrazu galerii. ciąg

NetworkInterfaceProperties

Nazwa Opis Wartość
dnsName Nazwa DNS. ciąg
privateIpAddress Prywatny adres IP. ciąg
publicIpAddress Publiczny adres IP. ciąg
publicIpAddressId Identyfikator zasobu publicznego adresu IP. ciąg
rdpAuthority Właściwość RdpAuthority jest nazwą hosta DNS serwera lub adresem IP, a następnie numerem portu usługi dla protokołu RDP (Remote Desktop Protocol). ciąg
sharedPublicIpAddressConfiguration Konfiguracja udostępniania publicznego adresu IP na wielu maszynach wirtualnych. SharedPublicIpAddressConfiguration
sshAuthority Właściwość SshAuthority to nazwa hosta DNS serwera lub adres IP, po którym następuje numer portu usługi dla protokołu SSH. ciąg
subnetId Identyfikator zasobu podsieci. ciąg
virtualNetworkId Identyfikator zasobu sieci wirtualnej. ciąg

SharedPublicIpAddressConfiguration

Nazwa Opis Wartość
inboundNatRules Reguły translatora adresów sieciowych przychodzących InboundNatRule[]

Ruch przychodzącyNatRule

Nazwa Opis Wartość
backendPort Port, do którego zostanie przekierowany ruch zewnętrzny. int
frontendPort Zewnętrzny port punktu końcowego połączenia przychodzącego. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie. Jeśli nie zostanie określona, wartość zostanie przydzielona automatycznie. int
transportProtocol Protokół transportu dla punktu końcowego. "Tcp"
"Udp"

ScheduleCreationParameter

Nazwa Opis Wartość
name Nazwa maszyny wirtualnej lub środowiska ciąg
properties Właściwości harmonogramu. ScheduleCreationParameterProperties
tags Tagi zasobu. object

ScheduleCreationParameterProperties

Nazwa Opis Wartość
Dailyrecurrence Jeśli harmonogram wystąpi raz dziennie tygodnia, określ cykl dzienny. DayDetails
hourlyRecurrence Jeśli harmonogram wystąpi wiele razy dziennie, określ cykl godzinowy. HourDetails
notificationSettings Ustawienia powiadomień. NotificationSettings
status Stan harmonogramu (tj. Włączone, Wyłączone) "Wyłączone"
"Włączone"
targetResourceId Identyfikator zasobu, do którego należy harmonogram ciąg
Tasktype Typ zadania harmonogramu (np. LabVmsShutdownTask, LabVmAutoStart). ciąg
Weeklyrecurrence Jeśli harmonogram będzie występował tylko kilka dni tygodnia, określ cykl tygodniowy. WeekDetails

DayDetails

Nazwa Opis Wartość
time Godzina dnia, w ramach których zostanie zaplanowany harmonogram. ciąg

HourDetails

Nazwa Opis Wartość
minuta Minuty godziny, w których zostanie uruchomiony harmonogram. int

NotificationSettings

Nazwa Opis Wartość
emailRecipient Adresat wiadomości e-mail do wysyłania powiadomień do (może to być lista adresów e-mail rozdzielonych średnikami). ciąg
notificationLocale Ustawienia regionalne do użycia podczas wysyłania powiadomienia (rezerwa dla nieobsługiwanych języków to EN). ciąg
status Jeśli powiadomienia są włączone dla tego harmonogramu (tj. Włączone, Wyłączone). "Wyłączone"
"Włączone"
timeInMinutes Godzina w minutach przed zdarzeniem, w którym zostanie wysłane powiadomienie. int
element webhookUrl Adres URL elementu webhook, do którego zostanie wysłane powiadomienie. ciąg

WeekDetails

Nazwa Opis Wartość
time Godzina dnia, w ramach których zostanie zaplanowany harmonogram. ciąg
Dni powszednie Dni tygodnia, dla których harmonogram jest ustawiony (np. niedziela, poniedziałek, wtorek itp.). ciąg[]

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Tworzy laboratorium w Azure DevTest Labs za pomocą maszyny wirtualnej z systemem Windows Server

Wdróż na platformie Azure		 Ten szablon tworzy nowe wystąpienie laboratorium DevTest Lab /DTL z maszyną wirtualną z systemem Windows Server 2019 Datacenter. Więcej szablonów szybkiego startu usługi Azure Resource Manager dla Azure DevTest Labs dostępnych na stroniehttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Tworzy laboratorium w Azure DevTest Labs z żądaną maszyną wirtualną

Wdróż na platformie Azure		 Ten szablon tworzy nowe wystąpienie laboratorium DevTest Lab /DTL z żądaną maszyną wirtualną z systemem Windows Server 2019 Datacenter. Więcej szablonów szybkiego startu usługi Azure Resource Manager dla Azure DevTest Labs dostępnych na stroniehttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definicja zasobu szablonu usługi ARM

Typ zasobu labs/virtualmachines można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevTestLab/labs/virtualmachines, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.DevTestLab/labs/virtualmachines",
  "apiVersion": "2018-09-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "allowClaim": "bool",
    "artifacts": [
      {
        "artifactId": "string",
        "artifactTitle": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "createdDate": "string",
    "customImageId": "string",
    "dataDiskParameters": [
      {
        "attachNewDataDiskOptions": {
          "diskName": "string",
          "diskSizeGiB": "int",
          "diskType": "string"
        },
        "existingLabDiskId": "string",
        "hostCaching": "string"
      }
    ],
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "string",
    "galleryImageReference": {
      "offer": "string",
      "osType": "string",
      "publisher": "string",
      "sku": "string",
      "version": "string"
    },
    "isAuthenticationWithSshKey": "bool",
    "labSubnetName": "string",
    "labVirtualNetworkId": "string",
    "networkInterface": {
      "dnsName": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "publicIpAddressId": "string",
      "rdpAuthority": "string",
      "sharedPublicIpAddressConfiguration": {
        "inboundNatRules": [
          {
            "backendPort": "int",
            "frontendPort": "int",
            "transportProtocol": "string"
          }
        ]
      },
      "sshAuthority": "string",
      "subnetId": "string",
      "virtualNetworkId": "string"
    },
    "notes": "string",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "planId": "string",
    "scheduleParameters": [
      {
        "name": "string",
        "properties": {
          "dailyRecurrence": {
            "time": "string"
          },
          "hourlyRecurrence": {
            "minute": "int"
          },
          "notificationSettings": {
            "emailRecipient": "string",
            "notificationLocale": "string",
            "status": "string",
            "timeInMinutes": "int",
            "webhookUrl": "string"
          },
          "status": "string",
          "targetResourceId": "string",
          "taskType": "string",
          "weeklyRecurrence": {
            "time": "string",
            "weekdays": [ "string" ]
          }
        },
        "tags": {}
      }
    ],
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "userName": "string"
  }
}

Wartości właściwości

labs/virtualmachines

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.DevTestLab/labs/virtualmachines"
apiVersion Wersja interfejsu API zasobów '2018-09-15'
name Nazwa zasobu

Zobacz, jak ustawiać nazwy i typy dla zasobów podrzędnych w szablonach usługi ARM JSON.		 ciąg (wymagany)

Limit znaków: 1–15 (Windows)
1–64 (Linux)

Prawidłowe znaki:
Alfanumeryczne i łączniki.

Rozpocznij i zakończ od alfanumeryczne. Nie można zawierać wszystkich liczb.
location Lokalizacja zasobu. ciąg
tags Tagi zasobu. Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
properties Właściwości zasobu. LabVirtualMachineProperties (wymagane)

LabVirtualMachineProperties

Nazwa Opis Wartość
allowClaim Wskazuje, czy inny użytkownik może przejąć własność maszyny wirtualnej bool
Artefakty Artefakty do zainstalowania na maszynie wirtualnej. ArtifactInstallProperties[]
createdDate Data utworzenia maszyny wirtualnej. ciąg
customImageId Identyfikator obrazu niestandardowego maszyny wirtualnej. ciąg
dataDiskParameters Nowe lub istniejące dyski danych do dołączania do maszyny wirtualnej po utworzeniu DataDiskProperties[]
disallowPublicIpAddress Wskazuje, czy maszyna wirtualna ma zostać utworzona bez publicznego adresu IP. bool
environmentId Identyfikator zasobu środowiska, który zawiera tę maszynę wirtualną, jeśli istnieje. ciąg
data wygaśnięcia Data wygaśnięcia maszyny wirtualnej. ciąg
galleryImageReference Dokumentacja obrazu Azure Marketplace firmy Microsoft dla maszyny wirtualnej. GalleryImageReference
isAuthenticationWithSshKey Wskazuje, czy ta maszyna wirtualna używa klucza SSH do uwierzytelniania. bool
labSubnetName Nazwa podsieci laboratorium maszyny wirtualnej. ciąg
labVirtualNetworkId Identyfikator sieci wirtualnej laboratorium maszyny wirtualnej. ciąg
networkInterface Właściwości interfejsu sieciowego. NetworkInterfaceProperties
Uwagi Uwagi dotyczące maszyny wirtualnej. ciąg
ownerObjectId Identyfikator obiektu właściciela maszyny wirtualnej. ciąg
ownerUserPrincipalName Główna nazwa użytkownika właściciela maszyny wirtualnej. ciąg
hasło Hasło administratora maszyny wirtualnej. ciąg
identyfikator planu Identyfikator planu skojarzonego z obrazem maszyny wirtualnej ciąg
scheduleParameters Harmonogramy tworzenia maszyn wirtualnych ScheduleCreationParameter[]
size Rozmiar maszyny wirtualnej. ciąg
sshKey Klucz SSH administratora maszyny wirtualnej. ciąg
storageType Typ magazynu do użycia dla maszyny wirtualnej (tj. Standardowa, Premium). ciąg
userName Nazwa użytkownika maszyny wirtualnej. ciąg

ArtifactInstallProperties

Nazwa Opis Wartość
artifactId Identyfikator artefaktu. ciąg
artifactTitle Tytuł artefaktu. ciąg
deploymentStatusMessage Komunikat o stanie z wdrożenia. ciąg
installTime Czas rozpoczęcia instalacji artefaktu na maszynie wirtualnej. ciąg
parameters Parametry artefaktu. ArtifactParameterProperties[]
status Stan artefaktu. ciąg
vmExtensionStatusMessage Komunikat o stanie z rozszerzenia maszyny wirtualnej. ciąg

ArtifactParameterProperties

Nazwa Opis Wartość
name Nazwa parametru artefaktu. ciąg
wartość Wartość parametru artefaktu. ciąg

DataDiskProperties

Nazwa Opis Wartość
attachNewDataDiskOptions Określa opcje dołączania nowego dysku do maszyny wirtualnej. AttachNewDataDiskOptions
existingLabDiskId Określa istniejący identyfikator dysku laboratorium, który ma zostać dołączony do maszyny wirtualnej. ciąg
hostCaching Opcja buforowania dysku danych (tj. Brak, ReadOnly, ReadWrite). "Brak"
"ReadOnly"
"ReadWrite"

AttachNewDataDiskOptions

Nazwa Opis Wartość
diskName Nazwa dysku do dołączenia. ciąg
diskSizeGiB Rozmiar dysku do dołączenia w gibibajtach. int
diskType Typ magazynu dysku (tj. Standardowa, Premium). "Premium"
"Standardowa"
"StandardSSD"

GalleryImageReference

Nazwa Opis Wartość
offer Oferta obrazu galerii. ciąg
osType Typ systemu operacyjnego obrazu galerii. ciąg
publisher Wydawca obrazu galerii. ciąg
sku Jednostka SKU obrazu galerii. ciąg
Wersja Wersja obrazu galerii. ciąg

NetworkInterfaceProperties

Nazwa Opis Wartość
dnsName Nazwa DNS. ciąg
privateIpAddress Prywatny adres IP. ciąg
publicIpAddress Publiczny adres IP. ciąg
publicIpAddressId Identyfikator zasobu publicznego adresu IP. ciąg
rdpAuthority Właściwość RdpAuthority jest nazwą hosta DNS serwera lub adresem IP, po którym następuje numer portu usługi dla protokołu RDP (Remote Desktop Protocol). ciąg
sharedPublicIpAddressConfiguration Konfiguracja udostępniania publicznego adresu IP na wielu maszynach wirtualnych. SharedPublicIpAddressConfiguration
sshAuthority Właściwość SshAuthority jest nazwą hosta DNS serwera lub adresem IP, po którym następuje numer portu usługi dla protokołu SSH. ciąg
subnetId Identyfikator zasobu podsieci. ciąg
virtualNetworkId Identyfikator zasobu sieci wirtualnej. ciąg

SharedPublicIpAddressConfiguration

Nazwa Opis Wartość
inboundNatRules Przychodzące reguły NAT Ruch przychodzącyNatRule[]

Ruch przychodzącyNatRule

Nazwa Opis Wartość
backendPort Port, do którego będzie przekierowywany ruch zewnętrzny. int
frontendPort Zewnętrzny port punktu końcowego połączenia przychodzącego. Możliwe wartości mieszczą się w zakresie od 1 do 65535 włącznie. Jeśli nie zostanie określona, wartość zostanie przydzielona automatycznie. int
transportProtocol Protokół transportu dla punktu końcowego. "Tcp"
"Udp"

ScheduleCreationParameter

Nazwa Opis Wartość
name Nazwa maszyny wirtualnej lub środowiska ciąg
properties Właściwości harmonogramu. ScheduleCreationParameterProperties
tags Tagi zasobu. object

ScheduleCreationParameterProperties

Nazwa Opis Wartość
Dailyrecurrence Jeśli harmonogram będzie występować raz dziennie tygodnia, określ cykl dzienny. DayDetails
hourlyRecurrence Jeśli harmonogram będzie występować wiele razy dziennie, określ cykl godzinowy. HourDetails
notificationSettings Ustawienia powiadomień. NotificationSettings
status Stan harmonogramu (tj. Włączone, Wyłączone) "Wyłączone"
"Włączone"
targetResourceId Identyfikator zasobu, do którego należy harmonogram ciąg
Tasktype Typ zadania harmonogramu (np. LabVmsShutdownTask, LabVmAutoStart). ciąg
Weeklyrecurrence Jeśli harmonogram będzie występować tylko kilka dni tygodnia, określ cykl tygodniowy. WeekDetails

DayDetails

Nazwa Opis Wartość
time Godzina dnia, w ramach których zostanie zaplanowany harmonogram. ciąg

HourDetails

Nazwa Opis Wartość
minuta Minuty godziny, przez które zostanie uruchomiony harmonogram. int

NotificationSettings

Nazwa Opis Wartość
emailRecipient Adresat wiadomości e-mail do wysyłania powiadomień (może to być lista adresów e-mail rozdzielonych średnikami). ciąg
notificationLocale Ustawienia regionalne do użycia podczas wysyłania powiadomienia (rezerwa dla nieobsługiwanych języków to EN). ciąg
status Jeśli powiadomienia są włączone dla tego harmonogramu (tj. Włączone, Wyłączone). "Wyłączone"
"Włączone"
timeInMinutes Czas w minutach przed zdarzeniem, w którym zostanie wysłane powiadomienie. int
element webhookUrl Adres URL elementu webhook, do którego zostanie wysłane powiadomienie. ciąg

WeekDetails

Nazwa Opis Wartość
time Godzina dnia, w ramach których zostanie zaplanowany harmonogram. ciąg
Dni powszednie Dni tygodnia, dla których zaplanowano harmonogram (np. niedziela, poniedziałek, wtorek itp.). ciąg[]

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Tworzy laboratorium w Azure DevTest Labs przy użyciu maszyny wirtualnej z systemem Windows Server

Wdróż na platformie Azure		 Ten szablon tworzy nowe wystąpienie laboratorium DevTest Lab/DTL z maszyną wirtualną z systemem Windows Server 2019 Datacenter. Więcej szablonów szybkiego startu usługi Azure Resource Manager dla Azure DevTest Labs dostępnych pod adresemhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Tworzy laboratorium w Azure DevTest Labs z żądaną maszyną wirtualną

Wdróż na platformie Azure		 Ten szablon tworzy nowe wystąpienie laboratorium DevTest Lab/DTL z maszyną wirtualną z systemem Windows Server 2019 Datacenter. Więcej szablonów szybkiego startu usługi Azure Resource Manager dla Azure DevTest Labs dostępnych pod adresemhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu labs/virtualmachines można wdrożyć z operacjami docelowymi:

  • Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevTestLab/labs/virtualmachines, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      allowClaim = bool
      artifacts = [
        {
          artifactId = "string"
          artifactTitle = "string"
          deploymentStatusMessage = "string"
          installTime = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
          status = "string"
          vmExtensionStatusMessage = "string"
        }
      ]
      createdDate = "string"
      customImageId = "string"
      dataDiskParameters = [
        {
          attachNewDataDiskOptions = {
            diskName = "string"
            diskSizeGiB = int
            diskType = "string"
          }
          existingLabDiskId = "string"
          hostCaching = "string"
        }
      ]
      disallowPublicIpAddress = bool
      environmentId = "string"
      expirationDate = "string"
      galleryImageReference = {
        offer = "string"
        osType = "string"
        publisher = "string"
        sku = "string"
        version = "string"
      }
      isAuthenticationWithSshKey = bool
      labSubnetName = "string"
      labVirtualNetworkId = "string"
      networkInterface = {
        dnsName = "string"
        privateIpAddress = "string"
        publicIpAddress = "string"
        publicIpAddressId = "string"
        rdpAuthority = "string"
        sharedPublicIpAddressConfiguration = {
          inboundNatRules = [
            {
              backendPort = int
              frontendPort = int
              transportProtocol = "string"
            }
          ]
        }
        sshAuthority = "string"
        subnetId = "string"
        virtualNetworkId = "string"
      }
      notes = "string"
      ownerObjectId = "string"
      ownerUserPrincipalName = "string"
      password = "string"
      planId = "string"
      scheduleParameters = [
        {
          name = "string"
          properties = {
            dailyRecurrence = {
              time = "string"
            }
            hourlyRecurrence = {
              minute = int
            }
            notificationSettings = {
              emailRecipient = "string"
              notificationLocale = "string"
              status = "string"
              timeInMinutes = int
              webhookUrl = "string"
            }
            status = "string"
            targetResourceId = "string"
            taskType = "string"
            weeklyRecurrence = {
              time = "string"
              weekdays = [
                "string"
              ]
            }
          }
          tags = {}
        }
      ]
      size = "string"
      sshKey = "string"
      storageType = "string"
      userName = "string"
    }
  })
}

Wartości właściwości

labs/virtualmachines

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–15 (Windows)
1–64 (Linux)

Prawidłowe znaki:
Alfanumeryczne i łączniki.

Rozpoczynanie i kończ od alfanumeryczne. Nie można zawierać wszystkich liczb.
location Lokalizacja zasobu. ciąg
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: laboratoria
tags Tagi zasobu. Słownik nazw tagów i wartości.
properties Właściwości zasobu. LabVirtualMachineProperties (wymagane)

LabVirtualMachineProperties

Nazwa Opis Wartość
allowClaim Wskazuje, czy inny użytkownik może przejąć własność maszyny wirtualnej bool
Artefakty Artefakty do zainstalowania na maszynie wirtualnej. ArtifactInstallProperties[]
createdDate Data utworzenia maszyny wirtualnej. ciąg
customImageId Niestandardowy identyfikator obrazu maszyny wirtualnej. ciąg
dataDiskParameters Nowe lub istniejące dyski danych do dołączenia do maszyny wirtualnej po utworzeniu DataDiskProperties[]
disallowPublicIpAddress Wskazuje, czy maszyna wirtualna ma zostać utworzona bez publicznego adresu IP. bool
environmentId Identyfikator zasobu środowiska, który zawiera tę maszynę wirtualną, jeśli istnieje. ciąg
expirationDate Data wygaśnięcia maszyny wirtualnej. ciąg
galleryImageReference Dokumentacja obrazu Azure Marketplace firmy Microsoft dla maszyny wirtualnej. GalleryImageReference
isAuthenticationWithSshKey Wskazuje, czy ta maszyna wirtualna używa klucza SSH do uwierzytelniania. bool
labSubnetName Nazwa podsieci laboratorium maszyny wirtualnej. ciąg
labVirtualNetworkId Identyfikator sieci wirtualnej laboratorium maszyny wirtualnej. ciąg
networkInterface Właściwości interfejsu sieciowego. NetworkInterfaceProperties
Uwagi Uwagi dotyczące maszyny wirtualnej. ciąg
ownerObjectId Identyfikator obiektu właściciela maszyny wirtualnej. ciąg
ownerUserPrincipalName Główna nazwa użytkownika właściciela maszyny wirtualnej. ciąg
hasło Hasło administratora maszyny wirtualnej. ciąg
identyfikator planu Identyfikator planu skojarzonego z obrazem maszyny wirtualnej ciąg
scheduleParameters Harmonogramy tworzenia maszyn wirtualnych ScheduleCreationParameter[]
size Rozmiar maszyny wirtualnej. ciąg
sshKey Klucz SSH administratora maszyny wirtualnej. ciąg
storageType Typ magazynu do użycia dla maszyny wirtualnej (tj. Standardowa, Premium). ciąg
userName Nazwa użytkownika maszyny wirtualnej. ciąg

ArtifactInstallProperties

Nazwa Opis Wartość
artifactId Identyfikator artefaktu. ciąg
artifactTitle Tytuł artefaktu. ciąg
deploymentStatusMessage Komunikat o stanie z wdrożenia. ciąg
installTime Czas rozpoczęcia instalacji artefaktu na maszynie wirtualnej. ciąg
parameters Parametry artefaktu. ArtifactParameterProperties[]
status Stan artefaktu. ciąg
vmExtensionStatusMessage Komunikat o stanie z rozszerzenia maszyny wirtualnej. ciąg

ArtifactParameterProperties

Nazwa Opis Wartość
name Nazwa parametru artefaktu. ciąg
wartość Wartość parametru artefaktu. ciąg

DataDiskProperties

Nazwa Opis Wartość
attachNewDataDiskOptions Określa opcje dołączania nowego dysku do maszyny wirtualnej. AttachNewDataDiskOptions
existingLabDiskId Określa istniejący identyfikator dysku laboratorium, który ma zostać dołączony do maszyny wirtualnej. ciąg
hostCaching Opcja buforowania dysku danych (tj. Brak, ReadOnly, ReadWrite). "Brak"
"ReadOnly"
"ReadWrite"

AttachNewDataDiskOptions

Nazwa Opis Wartość
diskName Nazwa dysku do dołączenia. ciąg
diskSizeGiB Rozmiar dysku do dołączenia w gibibajtach. int
diskType Typ magazynu dysku (tj. Standardowa, Premium). "Premium"
"Standardowa"
"StandardowaSSD"

GalleryImageReference

Nazwa Opis Wartość
offer Oferta obrazu galerii. ciąg
osType Typ systemu operacyjnego obrazu galerii. ciąg
publisher Wydawca obrazu galerii. ciąg
sku Jednostka SKU obrazu galerii. ciąg
Wersja Wersja obrazu galerii. ciąg

NetworkInterfaceProperties

Nazwa Opis Wartość
dnsName Nazwa DNS. ciąg
privateIpAddress Prywatny adres IP. ciąg
publicIpAddress Publiczny adres IP. ciąg
publicIpAddressId Identyfikator zasobu publicznego adresu IP. ciąg
rdpAuthority Właściwość RdpAuthority jest nazwą hosta DNS serwera lub adresem IP, po którym następuje numer portu usługi dla protokołu RDP (Remote Desktop Protocol). ciąg
sharedPublicIpAddressConfiguration Konfiguracja udostępniania publicznego adresu IP na wielu maszynach wirtualnych. SharedPublicIpAddressConfiguration
sshAuthority Właściwość SshAuthority jest nazwą hosta DNS serwera lub adresem IP, po którym następuje numer portu usługi dla protokołu SSH. ciąg
subnetId Identyfikator zasobu podsieci. ciąg
virtualNetworkId Identyfikator zasobu sieci wirtualnej. ciąg

SharedPublicIpAddressConfiguration

Nazwa Opis Wartość
inboundNatRules Przychodzące reguły NAT Ruch przychodzącyNatRule[]

Ruch przychodzącyNatRule

Nazwa Opis Wartość
backendPort Port, do którego będzie przekierowywany ruch zewnętrzny. int
frontendPort Zewnętrzny port punktu końcowego połączenia przychodzącego. Możliwe wartości mieszczą się w zakresie od 1 do 65535 włącznie. Jeśli nie zostanie określona, wartość zostanie przydzielona automatycznie. int
transportProtocol Protokół transportu dla punktu końcowego. "Tcp"
"Udp"

ScheduleCreationParameter

Nazwa Opis Wartość
name Nazwa maszyny wirtualnej lub środowiska ciąg
properties Właściwości harmonogramu. ScheduleCreationParameterProperties
tags Tagi zasobu. object

ScheduleCreationParameterProperties

Nazwa Opis Wartość
Dailyrecurrence Jeśli harmonogram będzie występować raz dziennie tygodnia, określ cykl dzienny. DayDetails
hourlyRecurrence Jeśli harmonogram będzie występować wiele razy dziennie, określ cykl godzinowy. HourDetails
notificationSettings Ustawienia powiadomień. NotificationSettings
status Stan harmonogramu (tj. Włączone, Wyłączone) "Wyłączone"
"Włączone"
targetResourceId Identyfikator zasobu, do którego należy harmonogram ciąg
Tasktype Typ zadania harmonogramu (np. LabVmsShutdownTask, LabVmAutoStart). ciąg
Weeklyrecurrence Jeśli harmonogram będzie występować tylko kilka dni tygodnia, określ cykl tygodniowy. WeekDetails

DayDetails

Nazwa Opis Wartość
time Godzina dnia, w ramach których zostanie zaplanowany harmonogram. ciąg

HourDetails

Nazwa Opis Wartość
minuta Minuty godziny, przez które zostanie uruchomiony harmonogram. int

NotificationSettings

Nazwa Opis Wartość
emailRecipient Adresat wiadomości e-mail do wysyłania powiadomień (może to być lista adresów e-mail rozdzielonych średnikami). ciąg
notificationLocale Ustawienia regionalne do użycia podczas wysyłania powiadomienia (rezerwa dla nieobsługiwanych języków to EN). ciąg
status Jeśli powiadomienia są włączone dla tego harmonogramu (tj. Włączone, Wyłączone). "Wyłączone"
"Włączone"
timeInMinutes Czas w minutach przed zdarzeniem, w którym zostanie wysłane powiadomienie. int
element webhookUrl Adres URL elementu webhook, do którego zostanie wysłane powiadomienie. ciąg

WeekDetails

Nazwa Opis Wartość
time Godzina dnia, w ramach których zostanie zaplanowany harmonogram. ciąg
Dni powszednie Dni tygodnia, dla których zaplanowano harmonogram (np. niedziela, poniedziałek, wtorek itp.). ciąg[]