Microsoft.DevTestLab labs/virtualmachines

Articolo
12/21/2024

Definizione di risorsa Bicep

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

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 risorsa

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

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

Valori delle proprietà

ArtifactInstallProperties

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

ArtifactParameterProperties

Nome	Descrizione	Valore
nome	Nome del parametro dell'artefatto.	corda
valore	Valore del parametro dell'artefatto.	corda

AttachNewDataDiskOptions

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

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.	corda
hostCaching	Opzione di memorizzazione nella cache per un disco dati(ad esempio Nessuno, ReadOnly, ReadWrite).	'Nessuno' 'ReadOnly' 'ReadWrite'

DayDetails

Nome	Descrizione	Valore
Ore	Ora del giorno in cui verrà eseguita la pianificazione.	corda

GalleryImageReference

Nome	Descrizione	Valore
offerta	Offerta dell'immagine della raccolta.	corda
osType	Tipo di sistema operativo dell'immagine della raccolta.	corda
editore	Autore dell'immagine della raccolta.	corda
Sku	SKU dell'immagine della raccolta.	corda
Versione	Versione dell'immagine della raccolta.	corda

HourDetails

Nome	Descrizione	Valore
minuto	Minuti dell'ora in cui verrà eseguita la pianificazione.	Int

InboundNatRule

Nome	Descrizione	Valore
backendPort	Porta a cui verrà reindirizzato il traffico esterno.	Int
frontendPort	Porta endpoint esterna della connessione in ingresso. I valori possibili 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'

LabVirtualMachineProperties

Nome	Descrizione	Valore
allowClaim	Indica se un altro utente può assumere la proprietà della macchina virtuale	Bool
Manufatti	Artefatti da installare nella macchina virtuale.	ArtifactInstallProperties[]
createdDate	Data di creazione della macchina virtuale.	corda
customImageId	Identificatore dell'immagine personalizzata della macchina virtuale.	corda
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 che contiene questa macchina virtuale, se presente.	corda
expirationDate	Data di scadenza per la macchina virtuale.	corda
galleryImageReference	Informazioni di riferimento sull'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 del lab della macchina virtuale.	corda
labVirtualNetworkId	Identificatore di rete virtuale del lab della macchina virtuale.	corda
networkInterface	Proprietà dell'interfaccia di rete.	NetworkInterfaceProperties
Note	Note della macchina virtuale.	corda
ownerObjectId	Identificatore dell'oggetto del proprietario della macchina virtuale.	corda
ownerUserPrincipalName	Nome dell'entità utente del proprietario della macchina virtuale.	corda
parola d’ordine	Password dell'amministratore della macchina virtuale.	corda Vincoli: Valore sensibile. Passare come parametro sicuro.
planId	ID del piano associato all'immagine della macchina virtuale	corda
scheduleParameters	Pianificazioni delle macchine virtuali da creare	ScheduleCreationParameter[]
grandezza	Dimensioni della macchina virtuale.	corda
sshKey	Chiave SSH dell'amministratore della macchina virtuale.	corda Vincoli: Valore sensibile. Passare come parametro sicuro.
storageType	Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium).	corda
nome utente	Nome utente della macchina virtuale.	corda

Microsoft.DevTestLab/labs/virtualmachines

Nome	Descrizione	Valore
ubicazione	Posizione della risorsa.	corda
nome	Nome della risorsa	stringa (obbligatorio)
genitore	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 all'esterno della risorsa padre.	Nome simbolico per la risorsa di tipo: lab
proprietà	Proprietà della risorsa.	LabVirtualMachineProperties (obbligatorio)
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli

NetworkInterfaceProperties

Nome	Descrizione	Valore
dnsName	Nome DNS.	corda
privateIpAddress	Indirizzo IP privato.	corda
publicIpAddress	Indirizzo IP pubblico.	corda
publicIpAddressId	ID risorsa dell'indirizzo IP pubblico.	corda
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).	corda
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.	corda
subnetId	ID risorsa della rete secondaria.	corda
virtualNetworkId	ID risorsa della rete virtuale.	corda

NotificationSettings

Nome	Descrizione	Valore
emailRecipient	Destinatario del messaggio di posta elettronica a cui inviare notifiche (può essere un elenco di indirizzi di posta elettronica separati da punti e virgola).	corda
notificationLocale	Impostazioni locali da usare quando si invia una notifica (il fallback per le lingue non supportate è EN).	corda
stato	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 del webhook a cui verrà inviata la notifica.	corda

ResourceTags

Nome	Descrizione	Valore

ScheduleCreationParameter

Nome	Descrizione	Valore
nome	Nome della macchina virtuale o dell'ambiente	corda
proprietà	Proprietà della pianificazione.	ScheduleCreationParameterProperties
Tag	Tag della risorsa.	ScheduleCreationParameterTags

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
stato	Stato della pianificazione (ad esempio Abilitato, Disabilitato)	'Disabilitato' 'Enabled'
targetResourceId	ID risorsa a cui appartiene la pianificazione	corda
taskType	Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart.	corda
timeZoneId	ID fuso orario (ad esempio, ora solare cina, ora solare della Groenlandia, ora solare pacifico e così via). I valori possibili per questa proprietà sono disponibili in `IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds` (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)	corda
weeklyRecurrence	Se la pianificazione verrà eseguita solo alcuni giorni della settimana, specificare la ricorrenza settimanale.	WeekDetails

ScheduleCreationParameterTags

Nome	Descrizione	Valore

SharedPublicIpAddressConfiguration

Nome	Descrizione	Valore
inboundNatRules	Regole NAT in ingresso	inboundNatRule[]

WeekDetails

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

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File	Descrizione
Crea un lab in Azure DevTest Labs con una macchina virtuale richiesta	Questo modello crea una nuova istanza devTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter richiesta. Altri modelli di avvio rapido di Azure Resource Manager per Azure DevTest Labs disponibili in https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definizione di risorsa del modello di Resource Manager

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

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 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",
  "properties": {
    "allowClaim": "bool",
    "artifacts": [
      {
        "artifactId": "string",
        "artifactTitle": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "createdDate": "string",
    "customImageId": "string",
    "dataDiskParameters": [
      {
        "attachNewDataDiskOptions": {
          "diskName": "string",
          "diskSizeGiB": "int",
          "diskType": "string"
        },
        "existingLabDiskId": "string",
        "hostCaching": "string"
      }
    ],
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "string",
    "galleryImageReference": {
      "offer": "string",
      "osType": "string",
      "publisher": "string",
      "sku": "string",
      "version": "string"
    },
    "isAuthenticationWithSshKey": "bool",
    "labSubnetName": "string",
    "labVirtualNetworkId": "string",
    "networkInterface": {
      "dnsName": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "publicIpAddressId": "string",
      "rdpAuthority": "string",
      "sharedPublicIpAddressConfiguration": {
        "inboundNatRules": [
          {
            "backendPort": "int",
            "frontendPort": "int",
            "transportProtocol": "string"
          }
        ]
      },
      "sshAuthority": "string",
      "subnetId": "string",
      "virtualNetworkId": "string"
    },
    "notes": "string",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "planId": "string",
    "scheduleParameters": [
      {
        "name": "string",
        "properties": {
          "dailyRecurrence": {
            "time": "string"
          },
          "hourlyRecurrence": {
            "minute": "int"
          },
          "notificationSettings": {
            "emailRecipient": "string",
            "notificationLocale": "string",
            "status": "string",
            "timeInMinutes": "int",
            "webhookUrl": "string"
          },
          "status": "string",
          "targetResourceId": "string",
          "taskType": "string",
          "timeZoneId": "string",
          "weeklyRecurrence": {
            "time": "string",
            "weekdays": [ "string" ]
          }
        },
        "tags": {
          "{customized property}": "string"
        }
      }
    ],
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "userName": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

ArtifactInstallProperties

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

ArtifactParameterProperties

Nome	Descrizione	Valore
nome	Nome del parametro dell'artefatto.	corda
valore	Valore del parametro dell'artefatto.	corda

AttachNewDataDiskOptions

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

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.	corda
hostCaching	Opzione di memorizzazione nella cache per un disco dati(ad esempio Nessuno, ReadOnly, ReadWrite).	'Nessuno' 'ReadOnly' 'ReadWrite'

DayDetails

Nome	Descrizione	Valore
Ore	Ora del giorno in cui verrà eseguita la pianificazione.	corda

GalleryImageReference

Nome	Descrizione	Valore
offerta	Offerta dell'immagine della raccolta.	corda
osType	Tipo di sistema operativo dell'immagine della raccolta.	corda
editore	Autore dell'immagine della raccolta.	corda
Sku	SKU dell'immagine della raccolta.	corda
Versione	Versione dell'immagine della raccolta.	corda

HourDetails

Nome	Descrizione	Valore
minuto	Minuti dell'ora in cui verrà eseguita la pianificazione.	Int

InboundNatRule

Nome	Descrizione	Valore
backendPort	Porta a cui verrà reindirizzato il traffico esterno.	Int
frontendPort	Porta endpoint esterna della connessione in ingresso. I valori possibili 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'

LabVirtualMachineProperties

Nome	Descrizione	Valore
allowClaim	Indica se un altro utente può assumere la proprietà della macchina virtuale	Bool
Manufatti	Artefatti da installare nella macchina virtuale.	ArtifactInstallProperties[]
createdDate	Data di creazione della macchina virtuale.	corda
customImageId	Identificatore dell'immagine personalizzata della macchina virtuale.	corda
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 che contiene questa macchina virtuale, se presente.	corda
expirationDate	Data di scadenza per la macchina virtuale.	corda
galleryImageReference	Informazioni di riferimento sull'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 del lab della macchina virtuale.	corda
labVirtualNetworkId	Identificatore di rete virtuale del lab della macchina virtuale.	corda
networkInterface	Proprietà dell'interfaccia di rete.	NetworkInterfaceProperties
Note	Note della macchina virtuale.	corda
ownerObjectId	Identificatore dell'oggetto del proprietario della macchina virtuale.	corda
ownerUserPrincipalName	Nome dell'entità utente del proprietario della macchina virtuale.	corda
parola d’ordine	Password dell'amministratore della macchina virtuale.	corda Vincoli: Valore sensibile. Passare come parametro sicuro.
planId	ID del piano associato all'immagine della macchina virtuale	corda
scheduleParameters	Pianificazioni delle macchine virtuali da creare	ScheduleCreationParameter[]
grandezza	Dimensioni della macchina virtuale.	corda
sshKey	Chiave SSH dell'amministratore della macchina virtuale.	corda Vincoli: Valore sensibile. Passare come parametro sicuro.
storageType	Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium).	corda
nome utente	Nome utente della macchina virtuale.	corda

Microsoft.DevTestLab/labs/virtualmachines

Nome	Descrizione	Valore
apiVersion	Versione dell'API	'2018-09-15'
ubicazione	Posizione della risorsa.	corda
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Proprietà della risorsa.	LabVirtualMachineProperties (obbligatorio)
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare	Tipo di risorsa	'Microsoft.DevTestLab/labs/virtualmachines'

NetworkInterfaceProperties

Nome	Descrizione	Valore
dnsName	Nome DNS.	corda
privateIpAddress	Indirizzo IP privato.	corda
publicIpAddress	Indirizzo IP pubblico.	corda
publicIpAddressId	ID risorsa dell'indirizzo IP pubblico.	corda
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).	corda
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.	corda
subnetId	ID risorsa della rete secondaria.	corda
virtualNetworkId	ID risorsa della rete virtuale.	corda

NotificationSettings

Nome	Descrizione	Valore
emailRecipient	Destinatario del messaggio di posta elettronica a cui inviare notifiche (può essere un elenco di indirizzi di posta elettronica separati da punti e virgola).	corda
notificationLocale	Impostazioni locali da usare quando si invia una notifica (il fallback per le lingue non supportate è EN).	corda
stato	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 del webhook a cui verrà inviata la notifica.	corda

ResourceTags

Nome	Descrizione	Valore

ScheduleCreationParameter

Nome	Descrizione	Valore
nome	Nome della macchina virtuale o dell'ambiente	corda
proprietà	Proprietà della pianificazione.	ScheduleCreationParameterProperties
Tag	Tag della risorsa.	ScheduleCreationParameterTags

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
stato	Stato della pianificazione (ad esempio Abilitato, Disabilitato)	'Disabilitato' 'Enabled'
targetResourceId	ID risorsa a cui appartiene la pianificazione	corda
taskType	Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart.	corda
timeZoneId	ID fuso orario (ad esempio, ora solare cina, ora solare della Groenlandia, ora solare pacifico e così via). I valori possibili per questa proprietà sono disponibili in `IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds` (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)	corda
weeklyRecurrence	Se la pianificazione verrà eseguita solo alcuni giorni della settimana, specificare la ricorrenza settimanale.	WeekDetails

ScheduleCreationParameterTags

Nome	Descrizione	Valore

SharedPublicIpAddressConfiguration

Nome	Descrizione	Valore
inboundNatRules	Regole NAT in ingresso	inboundNatRule[]

WeekDetails

Nome	Descrizione	Valore
Ore	Ora del giorno in cui verrà eseguita la pianificazione.	corda
giorni feriali	Giorni della settimana per cui è 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.

Sagoma	Descrizione
Crea un lab in Azure DevTest Labs con una macchina virtuale richiesta	Questo modello crea una nuova istanza devTest Lab/DTL con una macchina virtuale Windows Server 2019 Datacenter richiesta. Altri modelli di avvio rapido di Azure Resource Manager per Azure DevTest Labs disponibili in https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definizione di risorsa Terraform (provider AzAPI)

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

gruppi di risorse

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

Formato 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"
  tags = {
    {customized property} = "string"
  }
  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"
            timeZoneId = "string"
            weeklyRecurrence = {
              time = "string"
              weekdays = [
                "string"
              ]
            }
          }
          tags = {
            {customized property} = "string"
          }
        }
      ]
      size = "string"
      sshKey = "string"
      storageType = "string"
      userName = "string"
    }
  })
}

Valori delle proprietà

ArtifactInstallProperties

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

ArtifactParameterProperties

Nome	Descrizione	Valore
nome	Nome del parametro dell'artefatto.	corda
valore	Valore del parametro dell'artefatto.	corda

AttachNewDataDiskOptions

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

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.	corda
hostCaching	Opzione di memorizzazione nella cache per un disco dati(ad esempio Nessuno, ReadOnly, ReadWrite).	'Nessuno' 'ReadOnly' 'ReadWrite'

DayDetails

Nome	Descrizione	Valore
Ore	Ora del giorno in cui verrà eseguita la pianificazione.	corda

GalleryImageReference

Nome	Descrizione	Valore
offerta	Offerta dell'immagine della raccolta.	corda
osType	Tipo di sistema operativo dell'immagine della raccolta.	corda
editore	Autore dell'immagine della raccolta.	corda
Sku	SKU dell'immagine della raccolta.	corda
Versione	Versione dell'immagine della raccolta.	corda

HourDetails

Nome	Descrizione	Valore
minuto	Minuti dell'ora in cui verrà eseguita la pianificazione.	Int

InboundNatRule

Nome	Descrizione	Valore
backendPort	Porta a cui verrà reindirizzato il traffico esterno.	Int
frontendPort	Porta endpoint esterna della connessione in ingresso. I valori possibili 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'

LabVirtualMachineProperties

Nome	Descrizione	Valore
allowClaim	Indica se un altro utente può assumere la proprietà della macchina virtuale	Bool
Manufatti	Artefatti da installare nella macchina virtuale.	ArtifactInstallProperties[]
createdDate	Data di creazione della macchina virtuale.	corda
customImageId	Identificatore dell'immagine personalizzata della macchina virtuale.	corda
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 che contiene questa macchina virtuale, se presente.	corda
expirationDate	Data di scadenza per la macchina virtuale.	corda
galleryImageReference	Informazioni di riferimento sull'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 del lab della macchina virtuale.	corda
labVirtualNetworkId	Identificatore di rete virtuale del lab della macchina virtuale.	corda
networkInterface	Proprietà dell'interfaccia di rete.	NetworkInterfaceProperties
Note	Note della macchina virtuale.	corda
ownerObjectId	Identificatore dell'oggetto del proprietario della macchina virtuale.	corda
ownerUserPrincipalName	Nome dell'entità utente del proprietario della macchina virtuale.	corda
parola d’ordine	Password dell'amministratore della macchina virtuale.	corda Vincoli: Valore sensibile. Passare come parametro sicuro.
planId	ID del piano associato all'immagine della macchina virtuale	corda
scheduleParameters	Pianificazioni delle macchine virtuali da creare	ScheduleCreationParameter[]
grandezza	Dimensioni della macchina virtuale.	corda
sshKey	Chiave SSH dell'amministratore della macchina virtuale.	corda Vincoli: Valore sensibile. Passare come parametro sicuro.
storageType	Tipo di archiviazione da usare per la macchina virtuale (ad esempio Standard, Premium).	corda
nome utente	Nome utente della macchina virtuale.	corda

Microsoft.DevTestLab/labs/virtualmachines

Nome	Descrizione	Valore
ubicazione	Posizione della risorsa.	corda
nome	Nome della risorsa	stringa (obbligatorio)
parent_id	ID della risorsa padre per questa risorsa.	ID per la risorsa di tipo: lab
proprietà	Proprietà della risorsa.	LabVirtualMachineProperties (obbligatorio)
Tag	Tag delle risorse	Dizionario di nomi e valori di tag.
digitare	Tipo di risorsa	"Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"

NetworkInterfaceProperties

Nome	Descrizione	Valore
dnsName	Nome DNS.	corda
privateIpAddress	Indirizzo IP privato.	corda
publicIpAddress	Indirizzo IP pubblico.	corda
publicIpAddressId	ID risorsa dell'indirizzo IP pubblico.	corda
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).	corda
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.	corda
subnetId	ID risorsa della rete secondaria.	corda
virtualNetworkId	ID risorsa della rete virtuale.	corda

NotificationSettings

Nome	Descrizione	Valore
emailRecipient	Destinatario del messaggio di posta elettronica a cui inviare notifiche (può essere un elenco di indirizzi di posta elettronica separati da punti e virgola).	corda
notificationLocale	Impostazioni locali da usare quando si invia una notifica (il fallback per le lingue non supportate è EN).	corda
stato	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 del webhook a cui verrà inviata la notifica.	corda

ResourceTags

Nome	Descrizione	Valore

ScheduleCreationParameter

Nome	Descrizione	Valore
nome	Nome della macchina virtuale o dell'ambiente	corda
proprietà	Proprietà della pianificazione.	ScheduleCreationParameterProperties
Tag	Tag della risorsa.	ScheduleCreationParameterTags

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
stato	Stato della pianificazione (ad esempio Abilitato, Disabilitato)	'Disabilitato' 'Enabled'
targetResourceId	ID risorsa a cui appartiene la pianificazione	corda
taskType	Tipo di attività della pianificazione, ad esempio LabVmsShutdownTask, LabVmAutoStart.	corda
timeZoneId	ID fuso orario (ad esempio, ora solare cina, ora solare della Groenlandia, ora solare pacifico e così via). I valori possibili per questa proprietà sono disponibili in `IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds` (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)	corda
weeklyRecurrence	Se la pianificazione verrà eseguita solo alcuni giorni della settimana, specificare la ricorrenza settimanale.	WeekDetails

ScheduleCreationParameterTags

Nome	Descrizione	Valore

SharedPublicIpAddressConfiguration

Nome	Descrizione	Valore
inboundNatRules	Regole NAT in ingresso	inboundNatRule[]

WeekDetails

Nome	Descrizione	Valore
Ore	Ora del giorno in cui verrà eseguita la pianificazione.	corda
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

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Esempi di avvio rapido

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Modelli di avvio rapido

Definizione di risorsa Terraform (provider AzAPI)

Formato risorsa

Valori delle proprietà

ArtifactInstallProperties

ArtifactParameterProperties

AttachNewDataDiskOptions

DataDiskProperties

DayDetails

GalleryImageReference

HourDetails

InboundNatRule

LabVirtualMachineProperties

Microsoft.DevTestLab/labs/virtualmachines

NetworkInterfaceProperties

NotificationSettings

ResourceTags

ScheduleCreationParameter

ScheduleCreationParameterProperties

ScheduleCreationParameterTags

SharedPublicIpAddressConfiguration

WeekDetails

Commenti e suggerimenti

Risorse aggiuntive