Microsoft.DevTestLab labs/virtualmachines 2018-09-15

Articolo
08/11/2023

Definizione di risorsa Bicep

Il tipo di risorsa labs/virtualmachines può essere distribuito con operazioni destinate:

Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.DevTestLab/labs/virtualmachines, aggiungere il codice Bicep seguente al modello.

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

Valori delle proprietà

labs/virtualmachines

Nome	Descrizione	valore
name	Nome della risorsa Vedere come impostare nomi e tipi per le risorse figlio in Bicep.	stringa (obbligatoria) Limite di caratteri: 1-15 (Windows) 1-64 (Linux) Caratteri validi: Caratteri alfanumerici e trattini. Deve iniziare e terminare con un carattere alfanumerico. Non può contenere solo numeri.
posizione	Il percorso della risorsa.	string
tags	Tag della risorsa.	Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
padre	In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre. Per altre informazioni, vedere Risorsa figlio esterna alla risorsa padre.	Nome simbolico per la risorsa di tipo: lab
properties	Proprietà della risorsa.	LabVirtualMachineProperties (obbligatorio)

LabVirtualMachineProperties

Nome	Descrizione	Valore
allowClaim	Indica se un altro utente può assumere la proprietà della macchina virtuale	bool
Artefatti	Elementi da installare nella macchina virtuale.	ArtifactInstallProperties[]
createdDate	Data di creazione della macchina virtuale.	string
customImageId	Identificatore di immagine personalizzato della macchina virtuale.	string
dataDiskParameters	Dischi dati nuovi o esistenti da collegare alla macchina virtuale dopo la creazione	DataDiskProperties[]
disallowPublicIpAddress	Indica se la macchina virtuale deve essere creata senza un indirizzo IP pubblico.	bool
environmentId	ID risorsa dell'ambiente contenente questa macchina virtuale, se presente.	string
expirationDate	Data di scadenza per la macchina virtuale.	string
galleryImageReference	Riferimento all'immagine di Microsoft Azure Marketplace della macchina virtuale.	GalleryImageReference
isAuthenticationWithSshKey	Indica se questa macchina virtuale usa una chiave SSH per l'autenticazione.	bool
labSubnetName	Nome della subnet lab della macchina virtuale.	string
labVirtualNetworkId	Identificatore di rete virtuale lab della macchina virtuale.	string
networkInterface	Proprietà dell'interfaccia di rete.	NetworkInterfaceProperties
di HDInsight	Note della macchina virtuale.	string
ownerObjectId	Identificatore dell'oggetto del proprietario della macchina virtuale.	string
ownerUserPrincipalName	Nome dell'entità utente del proprietario della macchina virtuale.	string
password	Password dell'amministratore della macchina virtuale.	string
planId	ID del piano associato all'immagine della macchina virtuale	string
scheduleParameters	Pianificazioni di macchine virtuali da creare	ScheduleCreationParameter[]
size	Dimensioni della macchina virtuale.	string
sshKey	Chiave SSH dell'amministratore della macchina virtuale.	string
storageType	Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium).	string
userName	Nome utente della macchina virtuale.	string

ArtifactInstallProperties

Nome	Descrizione	Valore
artifactId	Identificatore dell'artefatto.	string
artifactTitle	Titolo dell'artefatto.	string
deploymentStatusMessage	Messaggio di stato dalla distribuzione.	string
installTime	Ora in cui l'artefatto inizia a essere installato nella macchina virtuale.	string
parametri	Parametri dell'artefatto.	ArtifactParameterProperties[]
status	Stato dell'artefatto.	string
vmExtensionStatusMessage	Messaggio di stato dall'estensione della macchina virtuale.	string

ArtifactParameterProperties

Nome	Descrizione	valore
name	Nome del parametro dell'artefatto.	string
Valore	Valore del parametro dell'artefatto.	string

DataDiskProperties

Nome	Descrizione	Valore
attachNewDataDiskOptions	Specifica le opzioni per collegare un nuovo disco alla macchina virtuale.	AttachNewDataDiskOptions
existingLabDiskId	Specifica l'ID disco lab esistente da collegare alla macchina virtuale.	string
hostCaching	Opzione di memorizzazione nella cache per un disco dati, ad esempio Nessuna, ReadOnly, ReadWrite.	'Nessuno' 'ReadOnly' 'ReadWrite'

AttachNewDataDiskOptions

Nome	Descrizione	Valore
Diskname	Nome del disco da collegare.	string
diskSizeGiB	Dimensioni del disco da collegare in Gibibyte.	INT
diskType	Tipo di archiviazione per il disco (ad esempio Standard, Premium).	'Premium' 'Standard' 'StandardSSD'

GalleryImageReference

Nome	Descrizione	Valore
offer	Offerta dell'immagine della raccolta.	string
osType	Tipo di sistema operativo dell'immagine della raccolta.	string
publisher	Autore dell'immagine della raccolta.	string
sku	SKU dell'immagine della raccolta.	string
version	Versione dell'immagine della raccolta.	string

NetworkInterfaceProperties

Nome	Descrizione	Valore
dnsName	Nome DNS.	string
privateIpAddress	Indirizzo IP privato.	string
publicIpAddress	Indirizzo IP pubblico.	string
publicIpAddressId	ID risorsa dell'indirizzo IP pubblico.	string
rdpAuthority	La proprietà RdpAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per RDP (Remote Desktop Protocol).	string
sharedPublicIpAddressConfiguration	Configurazione per la condivisione di un indirizzo IP pubblico tra più macchine virtuali.	SharedPublicIpAddressConfiguration
sshAuthority	La proprietà SshAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per SSH.	string
subnetId	ID risorsa della rete secondaria.	string
virtualNetworkId	ID risorsa della rete virtuale.	string

SharedPublicIpAddressConfiguration

Nome	Descrizione	Valore
inboundNatRules	Regole NAT in ingresso	InboundNatRule[]

InboundNatRule

Nome	Descrizione	Valore
backendPort	Porta a cui verrà reindirizzato il traffico esterno.	INT
frontendPort	Porta endpoint esterna della connessione in ingresso. I possibili valori sono compresi tra 1 e 65535 inclusi. Se non specificato, verrà allocato automaticamente un valore.	INT
transportProtocol	Protocollo di trasporto per l'endpoint.	'Tcp' 'Udp'

ScheduleCreationParameter

Nome	Descrizione	valore
name	Nome della macchina virtuale o dell'ambiente	string
properties	Proprietà della pianificazione.	ScheduleCreationParameterProperties
tags	Tag della risorsa.	object

ScheduleCreationParameterProperties

Nome	Descrizione	Valore
Dailyrecurrence	Se la pianificazione verrà eseguita una volta ogni giorno della settimana, specificare la ricorrenza giornaliera.	DayDetails
hourlyRecurrence	Se la pianificazione verrà eseguita più volte al giorno, specificare la ricorrenza oraria.	HourDetails
notificationSettings	Impostazioni di notifica.	NotificationSettings
status	Stato della pianificazione (ad esempio Abilitato, Disabilitato)	'Disabilitato' 'Enabled'
targetResourceId	ID risorsa a cui appartiene la pianificazione	string
taskType	Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart.	string
weeklyRecurrence	Se la pianificazione verrà eseguita solo alcuni giorni della settimana, specificare la ricorrenza settimanale.	WeekDetails

DayDetails

Nome	Descrizione	Valore
time	Ora del giorno in cui verrà eseguita la pianificazione.	string

HourDetails

Nome	Descrizione	Valore
minute	Minuti dell'ora in cui verrà eseguita la pianificazione.	INT

NotificationSettings

Nome	Descrizione	Valore
emailRecipient	Il destinatario del messaggio di posta elettronica a cui inviare notifiche (può essere un elenco di indirizzi di posta elettronica separati da punti e virgola).	string
notificationLocale	Le impostazioni locali da usare quando si invia una notifica (fallback per le lingue non supportate è EN).	string
status	Se le notifiche sono abilitate per questa pianificazione( ad esempio Abilitato, Disabilitato).	'Disabilitato' 'Enabled'
timeInMinutes	Tempo in minuti prima dell'evento in cui verrà inviata la notifica.	INT
webhookUrl	URL webhook a cui verrà inviata la notifica.	string

WeekDetails

Nome	Descrizione	Valore
time	L'ora del giorno verrà eseguita la pianificazione.	string
giorni feriali	Giorni della settimana per cui viene impostata la pianificazione (ad esempio domenica, lunedì, martedì e così via).	string[]

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello	Descrizione
Crea un lab in Azure DevTest Labs con una macchina virtuale Windows Server	Questo modello crea una nuova istanza di DevTest Lab/DTL con una macchina virtuale data center di Windows Server 2019. Altre Resource Manager modelli di avvio rapido di Azure per Azure DevTest Labs disponibili all'indirizzohttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Crea un lab in Azure DevTest Labs con una macchina virtuale richiesta	Questo modello crea una nuova istanza di DevTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter richiesta. Altre Resource Manager modelli di avvio rapido di Azure per Azure DevTest Labs disponibili all'indirizzohttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definizione della risorsa modello di Resource Manager

Il tipo di risorsa labs/virtualmachines può essere distribuito con operazioni destinate:

Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.DevTestLab/labs/virtualmachines, aggiungere il codice JSON seguente al modello.

{
  "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"
  }
}

Valori delle proprietà

labs/virtualmachines

Nome	Descrizione	Valore
tipo	Tipo di risorsa	'Microsoft.DevTestLab/labs/virtualmachines'
apiVersion	Versione dell'API risorsa	'2018-09-15'
name	Nome della risorsa Vedere come impostare nomi e tipi per le risorse figlio nei modelli di RESOURCE JSON.	stringa (obbligatoria) Limite di caratteri: 1-15 (Windows) 1-64 (Linux) Caratteri validi: Caratteri alfanumerici e trattini. Deve iniziare e terminare con un carattere alfanumerico. Non può contenere solo numeri.
posizione	Il percorso della risorsa.	string
tags	Tag della risorsa.	Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
properties	Proprietà della risorsa.	LabVirtualMachineProperties (obbligatorio)

LabVirtualMachineProperties

Nome	Descrizione	Valore
allowClaim	Indica se un altro utente può assumere la proprietà della macchina virtuale	bool
Artefatti	Elementi da installare nella macchina virtuale.	ArtifactInstallProperties[]
createdDate	Data di creazione della macchina virtuale.	string
customImageId	Identificatore di immagine personalizzato della macchina virtuale.	string
dataDiskParameters	Dischi dati nuovi o esistenti da collegare alla macchina virtuale dopo la creazione	DataDiskProperties[]
disallowPublicIpAddress	Indica se la macchina virtuale deve essere creata senza un indirizzo IP pubblico.	bool
environmentId	ID risorsa dell'ambiente contenente questa macchina virtuale, se presente.	string
expirationDate	Data di scadenza per la macchina virtuale.	string
galleryImageReference	Riferimento all'immagine di Microsoft Azure Marketplace della macchina virtuale.	GalleryImageReference
isAuthenticationWithSshKey	Indica se questa macchina virtuale usa una chiave SSH per l'autenticazione.	bool
labSubnetName	Nome della subnet lab della macchina virtuale.	string
labVirtualNetworkId	Identificatore di rete virtuale lab della macchina virtuale.	string
networkInterface	Proprietà dell'interfaccia di rete.	NetworkInterfaceProperties
di HDInsight	Note della macchina virtuale.	string
ownerObjectId	Identificatore dell'oggetto del proprietario della macchina virtuale.	string
ownerUserPrincipalName	Nome dell'entità utente del proprietario della macchina virtuale.	string
password	Password dell'amministratore della macchina virtuale.	string
planId	ID del piano associato all'immagine della macchina virtuale	string
scheduleParameters	Pianificazioni di macchine virtuali da creare	ScheduleCreationParameter[]
size	Dimensioni della macchina virtuale.	string
sshKey	Chiave SSH dell'amministratore della macchina virtuale.	string
storageType	Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium).	string
userName	Nome utente della macchina virtuale.	string

ArtifactInstallProperties

Nome	Descrizione	Valore
artifactId	Identificatore dell'artefatto.	string
artifactTitle	Titolo dell'artefatto.	string
deploymentStatusMessage	Messaggio di stato dalla distribuzione.	string
installTime	Ora in cui l'artefatto inizia a essere installato nella macchina virtuale.	string
parametri	Parametri dell'artefatto.	ArtifactParameterProperties[]
status	Stato dell'artefatto.	string
vmExtensionStatusMessage	Messaggio di stato dall'estensione della macchina virtuale.	string

ArtifactParameterProperties

Nome	Descrizione	valore
name	Nome del parametro dell'artefatto.	string
Valore	Valore del parametro dell'artefatto.	string

DataDiskProperties

Nome	Descrizione	Valore
attachNewDataDiskOptions	Specifica le opzioni per collegare un nuovo disco alla macchina virtuale.	AttachNewDataDiskOptions
existingLabDiskId	Specifica l'ID del disco lab esistente da collegare alla macchina virtuale.	string
hostCaching	Opzione di memorizzazione nella cache per un disco dati ,ad esempio Nessuno, ReadOnly, ReadWrite.	'Nessuno' 'ReadOnly' 'ReadWrite'

AttachNewDataDiskOptions

Nome	Descrizione	Valore
Diskname	Nome del disco da collegare.	string
diskSizeGiB	Dimensioni del disco da collegare in Gibibytes.	INT
diskType	Tipo di archiviazione per il disco (ad esempio Standard, Premium).	'Premium' 'Standard' 'StandardSSD'

GalleryImageReference

Nome	Descrizione	Valore
offer	Offerta dell'immagine della raccolta.	string
osType	Tipo di sistema operativo dell'immagine della raccolta.	string
publisher	Autore dell'immagine della raccolta.	string
sku	SKU dell'immagine della raccolta.	string
version	Versione dell'immagine della raccolta.	string

NetworkInterfaceProperties

Nome	Descrizione	Valore
dnsName	Nome DNS.	string
privateIpAddress	Indirizzo IP privato.	string
publicIpAddress	Indirizzo IP pubblico.	string
publicIpAddressId	ID risorsa dell'indirizzo IP pubblico.	string
rdpAuthority	La proprietà RdpAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per RDP (Remote Desktop Protocol).	string
sharedPublicIpAddressConfiguration	Configurazione per la condivisione di un indirizzo IP pubblico tra più macchine virtuali.	SharedPublicIpAddressConfiguration
sshAuthority	La proprietà SshAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per SSH.	string
subnetId	ID risorsa della rete secondaria.	string
virtualNetworkId	ID risorsa della rete virtuale.	string

SharedPublicIpAddressConfiguration

Nome	Descrizione	Valore
inboundNatRules	Regole NAT in ingresso	InboundNatRule[]

InboundNatRule

Nome	Descrizione	Valore
backendPort	Porta a cui verrà reindirizzato il traffico esterno.	INT
frontendPort	Porta endpoint esterna della connessione in ingresso. I possibili valori sono compresi tra 1 e 65535 inclusi. Se non specificato, verrà allocato automaticamente un valore.	INT
transportProtocol	Protocollo di trasporto per l'endpoint.	'Tcp' 'Udp'

ScheduleCreationParameter

Nome	Descrizione	valore
name	Nome della macchina virtuale o dell'ambiente	string
properties	Proprietà della pianificazione.	ScheduleCreationParameterProperties
tags	Tag della risorsa.	object

ScheduleCreationParameterProperties

Nome	Descrizione	Valore
Dailyrecurrence	Se la pianificazione verrà eseguita una volta ogni giorno della settimana, specificare la ricorrenza giornaliera.	DayDetails
hourlyRecurrence	Se la pianificazione si verificherà più volte al giorno, specificare la ricorrenza oraria.	HourDetails
notificationSettings	Impostazioni di notifica.	NotificationSettings
status	Stato della pianificazione (ad esempio Abilitato, Disabilitato)	'Disabilitato' 'Enabled'
targetResourceId	ID risorsa a cui appartiene la pianificazione	string
taskType	Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart.	string
settimanaleRecurrence	Se la pianificazione si verificherà solo alcuni giorni della settimana, specificare la ricorrenza settimanale.	WeekDetails

DayDetails

Nome	Descrizione	Valore
time	L'ora del giorno verrà eseguita la pianificazione.	string

HourDetails

Nome	Descrizione	Valore
minute	Minuti dell'ora in cui verrà eseguita la pianificazione.	INT

NotificationSettings

Nome	Descrizione	Valore
emailRecipient	Il destinatario del messaggio di posta elettronica a cui inviare notifiche (può essere un elenco di indirizzi di posta elettronica separati da punti e virgola).	string
notificationLocale	Le impostazioni locali da usare quando si invia una notifica (fallback per le lingue non supportate è EN).	string
status	Se le notifiche sono abilitate per questa pianificazione( ad esempio Abilitato, Disabilitato).	'Disabilitato' 'Enabled'
timeInMinutes	Tempo in minuti prima dell'evento in cui verrà inviata la notifica.	INT
webhookUrl	URL webhook a cui verrà inviata la notifica.	string

WeekDetails

Nome	Descrizione	Valore
time	L'ora del giorno verrà eseguita la pianificazione.	string
giorni feriali	Giorni della settimana per cui viene impostata la pianificazione (ad esempio domenica, lunedì, martedì e così via).	string[]

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello	Descrizione
Crea un lab in Azure DevTest Labs con una macchina virtuale Windows Server	Questo modello crea una nuova istanza di DevTest Lab/DTL con una macchina virtuale data center di Windows Server 2019. Altre Resource Manager modelli di avvio rapido di Azure per Azure DevTest Labs disponibili all'indirizzohttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates
Crea un lab in Azure DevTest Labs con una macchina virtuale richiesta	Questo modello crea una nuova istanza di DevTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter richiesta. Altre Resource Manager modelli di avvio rapido di Azure per Azure DevTest Labs disponibili all'indirizzohttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa labs/virtualmachines può essere distribuito con operazioni destinate:

Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.DevTestLab/labs/virtualmachines, aggiungere il codice Terraform seguente al modello.

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"
    }
  })
}

Valori delle proprietà

labs/virtualmachines

Nome	Descrizione	Valore
tipo	Tipo di risorsa	"Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
name	Nome della risorsa	stringa (obbligatoria) Limite di caratteri: 1-15 (Windows) 1-64 (Linux) Caratteri validi: Caratteri alfanumerici e trattini. Deve iniziare e terminare con un carattere alfanumerico. Non può contenere solo numeri.
posizione	Il percorso della risorsa.	string
parent_id	ID della risorsa padre per questa risorsa.	ID per la risorsa di tipo: lab
tags	Tag della risorsa.	Dizionario dei nomi e dei valori dei tag.
properties	Proprietà della risorsa.	LabVirtualMachineProperties (obbligatorio)

LabVirtualMachineProperties

Nome	Descrizione	Valore
allowClaim	Indica se un altro utente può assumere la proprietà della macchina virtuale	bool
Artefatti	Elementi da installare nella macchina virtuale.	ArtifactInstallProperties[]
createdDate	Data di creazione della macchina virtuale.	string
customImageId	Identificatore di immagine personalizzato della macchina virtuale.	string
dataDiskParameters	Dischi dati nuovi o esistenti da collegare alla macchina virtuale dopo la creazione	DataDiskProperties[]
disallowPublicIpAddress	Indica se la macchina virtuale deve essere creata senza un indirizzo IP pubblico.	bool
environmentId	ID risorsa dell'ambiente contenente questa macchina virtuale, se presente.	string
expirationDate	Data di scadenza per la macchina virtuale.	string
galleryImageReference	Riferimento all'immagine di Microsoft Azure Marketplace della macchina virtuale.	GalleryImageReference
isAuthenticationWithSshKey	Indica se questa macchina virtuale usa una chiave SSH per l'autenticazione.	bool
labSubnetName	Nome della subnet lab della macchina virtuale.	string
labVirtualNetworkId	Identificatore di rete virtuale lab della macchina virtuale.	string
networkInterface	Proprietà dell'interfaccia di rete.	NetworkInterfaceProperties
di HDInsight	Note della macchina virtuale.	string
ownerObjectId	Identificatore dell'oggetto del proprietario della macchina virtuale.	string
ownerUserPrincipalName	Nome dell'entità utente del proprietario della macchina virtuale.	string
password	Password dell'amministratore della macchina virtuale.	string
planId	ID del piano associato all'immagine della macchina virtuale	string
scheduleParameters	Pianificazioni di macchine virtuali da creare	ScheduleCreationParameter[]
size	Dimensioni della macchina virtuale.	string
sshKey	Chiave SSH dell'amministratore della macchina virtuale.	string
storageType	Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium).	string
userName	Nome utente della macchina virtuale.	string

ArtifactInstallProperties

Nome	Descrizione	Valore
artifactId	Identificatore dell'artefatto.	string
artifactTitle	Titolo dell'artefatto.	string
deploymentStatusMessage	Messaggio di stato dalla distribuzione.	string
installTime	Ora in cui l'artefatto inizia a essere installato nella macchina virtuale.	string
parametri	Parametri dell'artefatto.	ArtifactParameterProperties[]
status	Stato dell'artefatto.	string
vmExtensionStatusMessage	Messaggio di stato dall'estensione della macchina virtuale.	string

ArtifactParameterProperties

Nome	Descrizione	valore
name	Nome del parametro dell'artefatto.	string
Valore	Valore del parametro dell'artefatto.	string

DataDiskProperties

Nome	Descrizione	Valore
attachNewDataDiskOptions	Specifica le opzioni per collegare un nuovo disco alla macchina virtuale.	AttachNewDataDiskOptions
existingLabDiskId	Specifica l'ID disco lab esistente da collegare alla macchina virtuale.	string
hostCaching	Opzione di memorizzazione nella cache per un disco dati, ad esempio Nessuna, ReadOnly, ReadWrite.	"None" "ReadOnly" "ReadWrite"

AttachNewDataDiskOptions

Nome	Descrizione	Valore
Diskname	Nome del disco da collegare.	string
diskSizeGiB	Dimensioni del disco da collegare in Gibibyte.	INT
diskType	Tipo di archiviazione per il disco (ad esempio Standard, Premium).	"Premium" "Standard" "StandardSSD"

GalleryImageReference

Nome	Descrizione	Valore
offer	Offerta dell'immagine della raccolta.	string
osType	Tipo di sistema operativo dell'immagine della raccolta.	string
publisher	Autore dell'immagine della raccolta.	string
sku	SKU dell'immagine della raccolta.	string
version	Versione dell'immagine della raccolta.	string

NetworkInterfaceProperties

Nome	Descrizione	Valore
dnsName	Nome DNS.	string
privateIpAddress	Indirizzo IP privato.	string
publicIpAddress	Indirizzo IP pubblico.	string
publicIpAddressId	ID risorsa dell'indirizzo IP pubblico.	string
rdpAuthority	La proprietà RdpAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per RDP (Remote Desktop Protocol).	string
sharedPublicIpAddressConfiguration	Configurazione per la condivisione di un indirizzo IP pubblico tra più macchine virtuali.	SharedPublicIpAddressConfiguration
sshAuthority	La proprietà SshAuthority è un nome host DNS del server o un indirizzo IP seguito dal numero di porta del servizio per SSH.	string
subnetId	ID risorsa della rete secondaria.	string
virtualNetworkId	ID risorsa della rete virtuale.	string

SharedPublicIpAddressConfiguration

Nome	Descrizione	Valore
inboundNatRules	Regole NAT in ingresso	InboundNatRule[]

InboundNatRule

Nome	Descrizione	Valore
backendPort	Porta a cui verrà reindirizzato il traffico esterno.	INT
frontendPort	Porta endpoint esterna della connessione in ingresso. I possibili valori sono compresi tra 1 e 65535 inclusi. Se non specificato, verrà allocato automaticamente un valore.	INT
transportProtocol	Protocollo di trasporto per l'endpoint.	"Tcp" "Udp"

ScheduleCreationParameter

Nome	Descrizione	valore
name	Nome della macchina virtuale o dell'ambiente	string
properties	Proprietà della pianificazione.	ScheduleCreationParameterProperties
tags	Tag della risorsa.	object

ScheduleCreationParameterProperties

Nome	Descrizione	Valore
Dailyrecurrence	Se la pianificazione verrà eseguita una volta ogni giorno della settimana, specificare la ricorrenza giornaliera.	DayDetails
hourlyRecurrence	Se la pianificazione verrà eseguita più volte al giorno, specificare la ricorrenza oraria.	HourDetails
notificationSettings	Impostazioni di notifica.	NotificationSettings
status	Stato della pianificazione (ad esempio Abilitato, Disabilitato)	"Disabilitato" "Abilitato"
targetResourceId	ID risorsa a cui appartiene la pianificazione	string
taskType	Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart.	string
weeklyRecurrence	Se la pianificazione verrà eseguita solo alcuni giorni della settimana, specificare la ricorrenza settimanale.	WeekDetails

DayDetails

Nome	Descrizione	Valore
time	Ora del giorno in cui verrà eseguita la pianificazione.	string

HourDetails

Nome	Descrizione	Valore
minute	Minuti dell'ora in cui verrà eseguita la pianificazione.	INT

NotificationSettings

Nome	Descrizione	Valore
emailRecipient	Il destinatario del messaggio di posta elettronica a cui inviare notifiche (può essere un elenco di indirizzi di posta elettronica separati da punto e virgola).	string
notificationLocale	Impostazioni locali da usare per l'invio di una notifica (fallback per le lingue non supportate è EN).	string
status	Se le notifiche sono abilitate per questa pianificazione ,ad esempio Abilitato, Disabilitato.	"Disabilitato" "Abilitato"
timeInMinutes	Tempo in minuti prima dell'evento in cui verrà inviata la notifica.	INT
webhookUrl	URL del webhook a cui verrà inviata la notifica.	string

WeekDetails

Nome	Descrizione	Valore
time	Ora del giorno in cui verrà eseguita la pianificazione.	string
giorni feriali	Giorni della settimana per cui è impostata la pianificazione (ad esempio domenica, lunedì, martedì e così via).	string[]

Condividi tramite

Microsoft.DevTestLab labs/virtualmachines 2018-09-15

Definizione di risorsa Bicep

Formato di risorsa

Valori delle proprietà

labs/virtualmachines

LabVirtualMachineProperties

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Modelli di avvio rapido

Definizione della risorsa modello di Resource Manager

Formato di risorsa

Valori delle proprietà

labs/virtualmachines

LabVirtualMachineProperties

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Modelli di avvio rapido

Definizione della risorsa Terraform (provider AzAPI)

Formato di risorsa

Valori delle proprietà

labs/virtualmachines

LabVirtualMachineProperties

ArtifactInstallProperties

ArtifactParameterProperties

DataDiskProperties

AttachNewDataDiskOptions

GalleryImageReference

NetworkInterfaceProperties

SharedPublicIpAddressConfiguration

InboundNatRule

ScheduleCreationParameter

ScheduleCreationParameterProperties

DayDetails

HourDetails

NotificationSettings

WeekDetails

Commenti e suggerimenti

Commenti e suggerimenti

Risorse aggiuntive