Microsoft.DevTestLab labs/virtualmachines
Bicep-resursdefinition
Resurstypen labs/virtualmachines kan distribueras med åtgärder som mål:
- Resursgrupper – Se kommandon för resursgruppsdistribution
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.DevTestLab/labs/virtualmachines-resurs lägger du till följande Bicep i mallen.
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'
}
}
Egenskapsvärden
labs/virtualmachines
Name | Beskrivning | Värde |
---|---|---|
name | Resursnamnet Se hur du anger namn och typer för underordnade resurser i Bicep. |
sträng (krävs) Teckengräns: 1–15 (Windows) 1–64 (Linux) Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja och sluta med alfanumeriskt. Det kan inte vara alla tal. |
location | Platsen för resursen. | sträng |
tags | Taggarna för resursen. | Ordlista med taggnamn och värden. Se Taggar i mallar |
parent | I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen. Mer information finns i Underordnad resurs utanför överordnad resurs. |
Symboliskt namn för resurs av typen: labb |
properties | Egenskaperna för resursen. | LabVirtualMachineProperties (krävs) |
LabVirtualMachineProperties
Name | Beskrivning | Värde |
---|---|---|
allowClaim | Anger om en annan användare kan bli ägare till den virtuella datorn | boolesk |
Artefakter | Artefakterna som ska installeras på den virtuella datorn. | ArtifactInstallProperties[] |
createdDate | Skapandedatumet för den virtuella datorn. | sträng |
customImageId | Den virtuella datorns anpassade avbildningsidentifierare. | sträng |
dataDiskParameters | Nya eller befintliga datadiskar som ska anslutas till den virtuella datorn när de har skapats | DataDiskProperties[] |
tillåt intePublicIpAddress | Anger om den virtuella datorn ska skapas utan en offentlig IP-adress. | boolesk |
environmentId | Resurs-ID för miljön som innehåller den här virtuella datorn, om sådan finns. | sträng |
expirationDate | Förfallodatum för den virtuella datorn. | sträng |
galleryImageReference | Microsoft Azure Marketplace avbildningsreferens för den virtuella datorn. | GalleryImageReference |
isAuthenticationWithSshKey | Anger om den här virtuella datorn använder en SSH-nyckel för autentisering. | boolesk |
labSubnetName | Namnet på den virtuella datorns labbundernät. | sträng |
labVirtualNetworkId | Labb-ID för det virtuella nätverket för den virtuella datorn. | sträng |
networkInterface | Egenskaperna för nätverksgränssnittet. | NetworkInterfaceProperties |
anteckningar | Anteckningarna för den virtuella datorn. | sträng |
ownerObjectId | Objektidentifieraren för den virtuella datorns ägare. | sträng |
ownerUserPrincipalName | Användarens huvudnamn för den virtuella datorns ägare. | sträng |
password | Lösenordet för den virtuella datoradministratören. | sträng |
planId | ID:t för planen som är associerad med avbildningen av den virtuella datorn | sträng |
scheduleParameters | Scheman för virtuella datorer som ska skapas | ScheduleCreationParameter[] |
ikoner | Storleken på den virtuella datorn. | sträng |
sshKey | SSH-nyckeln för den virtuella datoradministratören. | sträng |
storageType | Lagringstyp som ska användas för virtuella datorer (t.ex. Standard, Premium). | sträng |
userName | Användarnamnet för den virtuella datorn. | sträng |
ArtifactInstallProperties
Name | Beskrivning | Värde |
---|---|---|
artifactId | Artefaktens identifierare. | sträng |
artifactTitle | Artefaktens rubrik. | sträng |
deploymentStatusMessage | Statusmeddelandet från distributionen. | sträng |
installTime | Den tid då artefakten börjar installeras på den virtuella datorn. | sträng |
parametrar | Parametrarna för artefakten. | ArtifactParameterProperties[] |
status | Artefaktens status. | sträng |
vmExtensionStatusMessage | Statusmeddelandet från tillägget för den virtuella datorn. | sträng |
ArtifactParameterProperties
Name | Beskrivning | Värde |
---|---|---|
name | Namnet på artefaktparametern. | sträng |
värde | Värdet för artefaktparametern. | sträng |
DataDiskProperties
Name | Beskrivning | Värde |
---|---|---|
attachNewDataDiskOptions | Anger alternativ för att ansluta en ny disk till den virtuella datorn. | AttachNewDataDiskOptions |
existingLabDiskId | Anger det befintliga labbdisk-ID:t som ska anslutas till den virtuella datorn. | sträng |
hostCaching | Cachelagringsalternativ för en datadisk (t.ex. Ingen, ReadOnly, ReadWrite). | "Ingen" "ReadOnly" 'ReadWrite' |
AttachNewDataDiskOptions
Name | Beskrivning | Värde |
---|---|---|
diskName | Namnet på den disk som ska anslutas. | sträng |
diskSizeGiB | Storleken på disken som ska anslutas i Gibibytes. | int |
Disktype | Lagringstypen för disken (t.ex. Standard, Premium). | "Premium" "Standard" "StandardSSD" |
GalleryImageReference
Name | Beskrivning | Värde |
---|---|---|
offer | Galleribildens erbjudande. | sträng |
osType | Galleriavbildningens operativsystemtyp. | sträng |
utgivare | Utgivaren av galleribilden. | sträng |
sku | SKU:n för galleribilden. | sträng |
version | Versionen av galleribilden. | sträng |
NetworkInterfaceProperties
Name | Beskrivning | Värde |
---|---|---|
dnsName | DNS-namnet. | sträng |
privateIpAddress | Den privata IP-adressen. | sträng |
publicIpAddress | Den offentliga IP-adressen. | sträng |
publicIpAddressId | Resurs-ID för den offentliga IP-adressen. | sträng |
rdpAuthority | Egenskapen RdpAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för RDP (Remote Desktop Protocol). | sträng |
sharedPublicIpAddressConfiguration | Konfigurationen för att dela en offentlig IP-adress mellan flera virtuella datorer. | SharedPublicIpAddressConfiguration |
sshAuthority | Egenskapen SshAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för SSH. | sträng |
subnetId | Resurs-ID för undernätet. | sträng |
virtualNetworkId | Resurs-ID för det virtuella nätverket. | sträng |
SharedPublicIpAddressConfiguration
Name | Beskrivning | Värde |
---|---|---|
inboundNatRules | Inkommande NAT-regler | InboundNatRule[] |
InboundNatRule
Name | Beskrivning | Värde |
---|---|---|
backendPort | Porten som den externa trafiken ska omdirigeras till. | int |
frontendPort | Den externa slutpunktsporten för den inkommande anslutningen. Möjliga värden sträcker sig mellan 1 och 65535, inklusive. Om det är ospecificerat allokeras ett värde automatiskt. | int |
transportProtocol | Transportprotokollet för slutpunkten. | "Tcp" "Udp" |
ScheduleCreationParameter
Name | Beskrivning | Värde |
---|---|---|
name | Namnet på den virtuella datorn eller miljön | sträng |
properties | Egenskaperna för schemat. | ScheduleCreationParameterEgenskaper |
tags | Resursens taggar. | objekt |
ScheduleCreationParameterEgenskaper
Name | Beskrivning | Värde |
---|---|---|
dailyRecurrence | Om schemat inträffar en gång varje dag i veckan anger du den dagliga upprepningen. | DayDetails |
hourlyRecurrence | Om schemat inträffar flera gånger om dagen anger du upprepningen varje timme. | HourDetails |
notificationSettings | Meddelandeinställningar. | NotificationSettings |
status | Status för schemat (dvs. Aktiverad, Inaktiverad) | "Inaktiverad" "Aktiverad" |
targetResourceId | Det resurs-ID som schemat tillhör | sträng |
taskType | Uppgiftstypen för schemat (t.ex. LabVmsShutdownTask, LabVmAutoStart). | sträng |
weeklyRecurrence | Om schemat bara inträffar några dagar i veckan anger du veckovis upprepning. | WeekDetails |
DayDetails
Name | Beskrivning | Värde |
---|---|---|
time | Tid på dagen schemat kommer att ske. | sträng |
HourDetails
Name | Beskrivning | Värde |
---|---|---|
minut | Minuter av timmen som schemat körs. | int |
NotificationSettings
Name | Beskrivning | Värde |
---|---|---|
emailRecipient | E-postmottagaren att skicka meddelanden till (kan vara en lista med semikolonavgränsade e-postadresser). | sträng |
notificationLocale | Språkvarianten som ska användas när du skickar ett meddelande (återställning för språk som inte stöds är EN). | sträng |
status | Om meddelanden är aktiverade för det här schemat (t.ex. aktiverat, inaktiverat). | "Inaktiverad" "Aktiverad" |
timeInMinutes | Tid i minuter innan händelsen då meddelandet skickas. | int |
webhookUrl | Den webhook-URL som meddelandet ska skickas till. | sträng |
WeekDetails
Name | Beskrivning | Värde |
---|---|---|
time | Den tid på dagen som schemat inträffar. | sträng |
Vardagar | Veckodagarna som schemat anges för (t.ex. söndag, måndag, tisdag osv.). | string[] |
Snabbstartsmallar
Följande snabbstartsmallar distribuerar den här resurstypen.
Mall | Description |
---|---|
Skapar ett labb i Azure DevTest Labs med en virtuell Windows Server-dator |
Den här mallen skapar en ny DevTest Lab/DTL-instans med en virtuell Windows Server 2019 Datacenter-dator i den. Fler Azure Resource Manager-snabbstartsmallar för Azure DevTest Labs finns påhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
Skapar ett labb i Azure DevTest Labs med en begärd virtuell dator |
Den här mallen skapar en ny DevTest Lab/DTL-instans med en begärd virtuell Windows Server 2019 Datacenter-dator i den. Fler Azure Resource Manager-snabbstartsmallar för Azure DevTest Labs finns påhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
Resursdefinition för ARM-mall
Resurstypen labs/virtualmachines kan distribueras med åtgärder som mål:
- Resursgrupper – Se kommandon för resursgruppsdistribution
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.DevTestLab/labs/virtualmachines-resurs lägger du till följande JSON i mallen.
{
"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"
}
}
Egenskapsvärden
labs/virtualmachines
Name | Beskrivning | Värde |
---|---|---|
typ | Resurstypen | "Microsoft.DevTestLab/labs/virtualmachines" |
apiVersion | Resurs-API-versionen | '2018-09-15' |
name | Resursnamnet Se hur du anger namn och typer för underordnade resurser i JSON ARM-mallar. |
sträng (krävs) Teckengräns: 1–15 (Windows) 1–64 (Linux) Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja och sluta med alfanumeriskt. Det kan inte vara alla tal. |
location | Platsen för resursen. | sträng |
tags | Taggarna för resursen. | Ordlista med taggnamn och värden. Se Taggar i mallar |
properties | Egenskaperna för resursen. | LabVirtualMachineProperties (krävs) |
LabVirtualMachineProperties
Name | Beskrivning | Värde |
---|---|---|
allowClaim | Anger om en annan användare kan bli ägare till den virtuella datorn | boolesk |
Artefakter | Artefakterna som ska installeras på den virtuella datorn. | ArtifactInstallProperties[] |
createdDate | Skapandedatumet för den virtuella datorn. | sträng |
customImageId | Den virtuella datorns anpassade avbildningsidentifierare. | sträng |
dataDiskParameters | Nya eller befintliga datadiskar som ska anslutas till den virtuella datorn när de har skapats | DataDiskProperties[] |
tillåt intePublicIpAddress | Anger om den virtuella datorn ska skapas utan en offentlig IP-adress. | boolesk |
environmentId | Resurs-ID för miljön som innehåller den här virtuella datorn, om sådan finns. | sträng |
expirationDate | Förfallodatum för den virtuella datorn. | sträng |
galleryImageReference | Microsoft Azure Marketplace avbildningsreferens för den virtuella datorn. | GalleryImageReference |
isAuthenticationWithSshKey | Anger om den här virtuella datorn använder en SSH-nyckel för autentisering. | boolesk |
labSubnetName | Namnet på den virtuella datorns labbundernät. | sträng |
labVirtualNetworkId | Labb-ID för det virtuella nätverket för den virtuella datorn. | sträng |
networkInterface | Egenskaperna för nätverksgränssnittet. | NetworkInterfaceProperties |
anteckningar | Anteckningarna för den virtuella datorn. | sträng |
ownerObjectId | Objektidentifieraren för den virtuella datorns ägare. | sträng |
ownerUserPrincipalName | Användarens huvudnamn för den virtuella datorns ägare. | sträng |
password | Lösenordet för den virtuella datoradministratören. | sträng |
planId | ID:t för planen som är associerad med avbildningen av den virtuella datorn | sträng |
scheduleParameters | Scheman för virtuella datorer som ska skapas | ScheduleCreationParameter[] |
ikoner | Storleken på den virtuella datorn. | sträng |
sshKey | SSH-nyckeln för den virtuella datoradministratören. | sträng |
storageType | Lagringstyp som ska användas för virtuella datorer (t.ex. Standard, Premium). | sträng |
userName | Användarnamnet för den virtuella datorn. | sträng |
ArtifactInstallProperties
Name | Beskrivning | Värde |
---|---|---|
artifactId | Artefaktens identifierare. | sträng |
artifactTitle | Artefaktens rubrik. | sträng |
deploymentStatusMessage | Statusmeddelandet från distributionen. | sträng |
installTime | Den tid då artefakten börjar installeras på den virtuella datorn. | sträng |
parametrar | Parametrarna för artefakten. | ArtifactParameterProperties[] |
status | Artefaktens status. | sträng |
vmExtensionStatusMessage | Statusmeddelandet från tillägget för den virtuella datorn. | sträng |
ArtifactParameterProperties
Name | Beskrivning | Värde |
---|---|---|
name | Namnet på artefaktparametern. | sträng |
värde | Värdet för artefaktparametern. | sträng |
DataDiskProperties
Name | Beskrivning | Värde |
---|---|---|
attachNewDataDiskOptions | Anger alternativ för att ansluta en ny disk till den virtuella datorn. | AttachNewDataDiskOptions |
existingLabDiskId | Anger det befintliga labbdisk-ID:t som ska anslutas till den virtuella datorn. | sträng |
hostCaching | Cachelagringsalternativ för en datadisk (t.ex. Ingen, ReadOnly, ReadWrite). | "Ingen" "ReadOnly" 'ReadWrite' |
AttachNewDataDiskOptions
Name | Beskrivning | Värde |
---|---|---|
diskName | Namnet på den disk som ska anslutas. | sträng |
diskSizeGiB | Storleken på disken som ska anslutas i Gibibytes. | int |
Disktype | Lagringstypen för disken (t.ex. Standard, Premium). | "Premium" "Standard" "StandardSSD" |
GalleryImageReference
Name | Beskrivning | Värde |
---|---|---|
offer | Galleribildens erbjudande. | sträng |
osType | Galleriavbildningens operativsystemtyp. | sträng |
utgivare | Utgivaren av galleribilden. | sträng |
sku | SKU:n för galleribilden. | sträng |
version | Versionen av galleribilden. | sträng |
NetworkInterfaceProperties
Name | Beskrivning | Värde |
---|---|---|
dnsName | DNS-namnet. | sträng |
privateIpAddress | Den privata IP-adressen. | sträng |
publicIpAddress | Den offentliga IP-adressen. | sträng |
publicIpAddressId | Resurs-ID för den offentliga IP-adressen. | sträng |
rdpAuthority | Egenskapen RdpAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för RDP (Remote Desktop Protocol). | sträng |
sharedPublicIpAddressConfiguration | Konfigurationen för att dela en offentlig IP-adress mellan flera virtuella datorer. | SharedPublicIpAddressConfiguration |
sshAuthority | Egenskapen SshAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för SSH. | sträng |
subnetId | Resurs-ID för undernätet. | sträng |
virtualNetworkId | Resurs-ID för det virtuella nätverket. | sträng |
SharedPublicIpAddressConfiguration
Name | Beskrivning | Värde |
---|---|---|
inboundNatRules | Inkommande NAT-regler | InboundNatRule[] |
InboundNatRule
Name | Beskrivning | Värde |
---|---|---|
backendPort | Porten som den externa trafiken ska omdirigeras till. | int |
frontendPort | Den externa slutpunktsporten för den inkommande anslutningen. Möjliga värden mellan 1 och 65535, inklusive. Om det inte anges allokeras ett värde automatiskt. | int |
transportProtocol | Transportprotokollet för slutpunkten. | "Tcp" "Udp" |
ScheduleCreationParameter
Name | Beskrivning | Värde |
---|---|---|
name | Namnet på den virtuella datorn eller miljön | sträng |
properties | Egenskaperna för schemat. | ScheduleCreationParameterProperties |
tags | Taggarna för resursen. | objekt |
ScheduleCreationParameterProperties
Name | Beskrivning | Värde |
---|---|---|
dailyRecurrence | Om schemat ska ske en gång varje dag i veckan anger du den dagliga upprepningen. | DayDetails |
hourlyRecurrence | Om schemat ska ske flera gånger om dagen anger du upprepningen varje timme. | HourDetails |
notificationSettings | Meddelandeinställningar. | NotificationSettings |
status | Status för schemat (t.ex. Aktiverad, Inaktiverad) | "Inaktiverad" "Aktiverad" |
targetResourceId | Det resurs-ID som schemat tillhör | sträng |
taskType | Uppgiftstypen för schemat (t.ex. LabVmsShutdownTask, LabVmAutoStart). | sträng |
weeklyRecurrence | Om schemat bara inträffar några dagar i veckan anger du veckovis upprepning. | WeekDetails |
DayDetails
Name | Beskrivning | Värde |
---|---|---|
time | Den tid på dagen som schemat inträffar. | sträng |
HourDetails
Name | Beskrivning | Värde |
---|---|---|
minut | Minuter av timmen som schemat körs. | int |
NotificationSettings
Name | Beskrivning | Värde |
---|---|---|
emailRecipient | E-postmottagaren att skicka meddelanden till (kan vara en lista med semikolonavgränsade e-postadresser). | sträng |
notificationLocale | Språkvarianten som ska användas när du skickar ett meddelande (återställning för språk som inte stöds är EN). | sträng |
status | Om meddelanden är aktiverade för det här schemat (t.ex. aktiverat, inaktiverat). | "Inaktiverad" "Aktiverad" |
timeInMinutes | Tid i minuter innan händelsen då meddelandet skickas. | int |
webhookUrl | Den webhook-URL som meddelandet ska skickas till. | sträng |
WeekDetails
Name | Beskrivning | Värde |
---|---|---|
time | Den tid på dagen som schemat inträffar. | sträng |
Vardagar | Veckodagarna som schemat anges för (t.ex. söndag, måndag, tisdag osv.). | string[] |
Snabbstartsmallar
Följande snabbstartsmallar distribuerar den här resurstypen.
Mall | Description |
---|---|
Skapar ett labb i Azure DevTest Labs med en virtuell Windows Server-dator |
Den här mallen skapar en ny DevTest Lab/DTL-instans med en virtuell Windows Server 2019 Datacenter-dator i den. Fler Azure Resource Manager-snabbstartsmallar för Azure DevTest Labs finns påhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
Skapar ett labb i Azure DevTest Labs med en begärd virtuell dator |
Den här mallen skapar en ny DevTest Lab/DTL-instans med en begärd virtuell Windows Server 2019 Datacenter-dator i den. Fler Azure Resource Manager-snabbstartsmallar för Azure DevTest Labs finns påhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
Resursdefinition för Terraform (AzAPI-provider)
Resurstypen labs/virtualmachines kan distribueras med åtgärder som mål:
- Resursgrupper
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.DevTestLab/labs/virtualmachines-resurs lägger du till följande Terraform i mallen.
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"
}
})
}
Egenskapsvärden
labs/virtualmachines
Name | Beskrivning | Värde |
---|---|---|
typ | Resurstypen | "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15" |
name | Resursnamnet | sträng (krävs) Teckengräns: 1–15 (Windows) 1–64 (Linux) Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja och sluta med alfanumeriskt. Det kan inte vara alla tal. |
location | Platsen för resursen. | sträng |
parent_id | ID för resursen som är överordnad för den här resursen. | ID för resurs av typen: labb |
tags | Taggarna för resursen. | Ordlista med taggnamn och värden. |
properties | Egenskaperna för resursen. | LabVirtualMachineProperties (krävs) |
LabVirtualMachineProperties
Name | Beskrivning | Värde |
---|---|---|
allowClaim | Anger om en annan användare kan bli ägare till den virtuella datorn | boolesk |
Artefakter | Artefakterna som ska installeras på den virtuella datorn. | ArtifactInstallProperties[] |
createdDate | Skapandedatumet för den virtuella datorn. | sträng |
customImageId | Den virtuella datorns anpassade avbildningsidentifierare. | sträng |
dataDiskParameters | Nya eller befintliga datadiskar som ska anslutas till den virtuella datorn när de har skapats | DataDiskProperties[] |
tillåt intePublicIpAddress | Anger om den virtuella datorn ska skapas utan en offentlig IP-adress. | boolesk |
environmentId | Resurs-ID för miljön som innehåller den här virtuella datorn, om sådan finns. | sträng |
expirationDate | Förfallodatum för den virtuella datorn. | sträng |
galleryImageReference | Microsoft Azure Marketplace avbildningsreferens för den virtuella datorn. | GalleryImageReference |
isAuthenticationWithSshKey | Anger om den här virtuella datorn använder en SSH-nyckel för autentisering. | boolesk |
labSubnetName | Namnet på den virtuella datorns labbundernät. | sträng |
labVirtualNetworkId | Labb-ID för det virtuella nätverket för den virtuella datorn. | sträng |
networkInterface | Egenskaperna för nätverksgränssnittet. | NetworkInterfaceProperties |
anteckningar | Anteckningarna för den virtuella datorn. | sträng |
ownerObjectId | Objektidentifieraren för den virtuella datorns ägare. | sträng |
ownerUserPrincipalName | Användarens huvudnamn för den virtuella datorns ägare. | sträng |
password | Lösenordet för den virtuella datoradministratören. | sträng |
planId | ID:t för planen som är associerad med avbildningen av den virtuella datorn | sträng |
scheduleParameters | Scheman för virtuella datorer som ska skapas | ScheduleCreationParameter[] |
ikoner | Storleken på den virtuella datorn. | sträng |
sshKey | SSH-nyckeln för den virtuella datoradministratören. | sträng |
storageType | Lagringstyp som ska användas för virtuella datorer (t.ex. Standard, Premium). | sträng |
userName | Användarnamnet för den virtuella datorn. | sträng |
ArtifactInstallProperties
Name | Beskrivning | Värde |
---|---|---|
artifactId | Artefaktens identifierare. | sträng |
artifactTitle | Artefaktens rubrik. | sträng |
deploymentStatusMessage | Statusmeddelandet från distributionen. | sträng |
installTime | Den tid då artefakten börjar installeras på den virtuella datorn. | sträng |
parametrar | Parametrarna för artefakten. | ArtifactParameterProperties[] |
status | Artefaktens status. | sträng |
vmExtensionStatusMessage | Statusmeddelandet från tillägget för den virtuella datorn. | sträng |
ArtifactParameterProperties
Name | Beskrivning | Värde |
---|---|---|
name | Namnet på artefaktparametern. | sträng |
värde | Värdet för artefaktparametern. | sträng |
DataDiskProperties
Name | Beskrivning | Värde |
---|---|---|
attachNewDataDiskOptions | Anger alternativ för att ansluta en ny disk till den virtuella datorn. | AttachNewDataDiskOptions |
existingLabDiskId | Anger det befintliga labbdisk-ID:t som ska anslutas till den virtuella datorn. | sträng |
hostCaching | Cachelagringsalternativ för en datadisk (t.ex. Ingen, ReadOnly, ReadWrite). | "Ingen" "ReadOnly" "ReadWrite" |
AttachNewDataDiskOptions
Name | Beskrivning | Värde |
---|---|---|
diskName | Namnet på den disk som ska anslutas. | sträng |
diskSizeGiB | Storleken på disken som ska anslutas i Gibibytes. | int |
Disktype | Lagringstypen för disken (t.ex. Standard, Premium). | "Premium" "Standard" "StandardSSD" |
GalleryImageReference
Name | Beskrivning | Värde |
---|---|---|
offer | Galleribildens erbjudande. | sträng |
osType | Galleriavbildningens operativsystemtyp. | sträng |
utgivare | Utgivaren av galleribilden. | sträng |
sku | SKU:n för galleribilden. | sträng |
version | Versionen av galleribilden. | sträng |
NetworkInterfaceProperties
Name | Beskrivning | Värde |
---|---|---|
dnsName | DNS-namnet. | sträng |
privateIpAddress | Den privata IP-adressen. | sträng |
publicIpAddress | Den offentliga IP-adressen. | sträng |
publicIpAddressId | Resurs-ID för den offentliga IP-adressen. | sträng |
rdpAuthority | Egenskapen RdpAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för RDP (Remote Desktop Protocol). | sträng |
sharedPublicIpAddressConfiguration | Konfigurationen för att dela en offentlig IP-adress mellan flera virtuella datorer. | SharedPublicIpAddressConfiguration |
sshAuthority | Egenskapen SshAuthority är ett DNS-värdnamn eller IP-adress för servern följt av tjänstportnumret för SSH. | sträng |
subnetId | Resurs-ID för undernätet. | sträng |
virtualNetworkId | Resurs-ID för det virtuella nätverket. | sträng |
SharedPublicIpAddressConfiguration
Name | Beskrivning | Värde |
---|---|---|
inboundNatRules | Inkommande NAT-regler | InboundNatRule[] |
InboundNatRule
Name | Beskrivning | Värde |
---|---|---|
backendPort | Porten som den externa trafiken ska omdirigeras till. | int |
frontendPort | Den externa slutpunktsporten för den inkommande anslutningen. Möjliga värden mellan 1 och 65535, inklusive. Om det inte anges allokeras ett värde automatiskt. | int |
transportProtocol | Transportprotokollet för slutpunkten. | "Tcp" "Udp" |
ScheduleCreationParameter
Name | Beskrivning | Värde |
---|---|---|
name | Namnet på den virtuella datorn eller miljön | sträng |
properties | Egenskaperna för schemat. | ScheduleCreationParameterProperties |
tags | Taggarna för resursen. | objekt |
ScheduleCreationParameterProperties
Name | Beskrivning | Värde |
---|---|---|
dailyRecurrence | Om schemat ska ske en gång varje dag i veckan anger du den dagliga upprepningen. | DayDetails |
hourlyRecurrence | Om schemat ska ske flera gånger om dagen anger du upprepningen varje timme. | HourDetails |
notificationSettings | Meddelandeinställningar. | NotificationSettings |
status | Status för schemat (t.ex. Aktiverad, Inaktiverad) | "Inaktiverad" "Aktiverad" |
targetResourceId | Det resurs-ID som schemat tillhör | sträng |
taskType | Uppgiftstypen för schemat (t.ex. LabVmsShutdownTask, LabVmAutoStart). | sträng |
weeklyRecurrence | Om schemat bara inträffar några dagar i veckan anger du veckovis upprepning. | WeekDetails |
DayDetails
Name | Beskrivning | Värde |
---|---|---|
time | Den tid på dagen som schemat inträffar. | sträng |
HourDetails
Name | Beskrivning | Värde |
---|---|---|
minut | Minuter av timmen som schemat körs. | int |
NotificationSettings
Name | Beskrivning | Värde |
---|---|---|
emailRecipient | E-postmottagaren att skicka meddelanden till (kan vara en lista med semikolonavgränsade e-postadresser). | sträng |
notificationLocale | Språkvarianten som ska användas när du skickar ett meddelande (återställning för språk som inte stöds är EN). | sträng |
status | Om meddelanden är aktiverade för det här schemat (t.ex. aktiverat, inaktiverat). | "Inaktiverad" "Aktiverad" |
timeInMinutes | Tid i minuter innan händelsen då meddelandet skickas. | int |
webhookUrl | Den webhook-URL som meddelandet ska skickas till. | sträng |
WeekDetails
Name | Beskrivning | Värde |
---|---|---|
time | Den tid på dagen som schemat inträffar. | sträng |
Vardagar | Veckodagarna som schemat anges för (t.ex. söndag, måndag, tisdag osv.). | string[] |