Creare un lab in Azure Lab Services usando PowerShell e il modulo di Azure
Importante
Azure Lab Services verrà ritirato il 28 giugno 2027. Per altre informazioni, vedere la guida al ritiro.
Questo articolo illustra come creare un lab usando PowerShell e i moduli di Azure. Il lab usa le impostazioni di un piano lab creato in precedenza. Per una panoramica dettagliata di Azure Lab Services, vedere Introduzione ad Azure Lab Services.
Prerequisiti
- Un account Azure con una sottoscrizione attiva. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
- Un account Azure con l'autorizzazione per gestire un lab con il ruolo di Controllo degli accessi in base al ruolo di Azure, ad esempio Creatore di lab, Proprietario, Collaboratore o Collaboratore Lab Services. Altre informazioni su Ruoli predefiniti di Azure Lab Services e ambiti di assegnazione.
- Un piano lab di Azure. Se non si ha ancora un piano lab, seguire i passaggi descritti in Avvio rapido: Configurare le risorse per creare lab.
Modulo Az di Azure PowerShell. È richiesta la versione 7.2 o successiva.
Install-Module 'Az'
Modulo Az.LabServices di PowerShell.
Install-Module 'Az.LabServices'
Piano lab. Per creare un piano lab, vedere Creare un piano lab usando PowerShell e i moduli di Azure.
Eseguire Connect-AzAccount per accedere ad Azure e verificare la presenza di una sottoscrizione attiva.
Creare un lab
Prima di poter creare un lab, è necessaria la risorsa del piano lab. Nella sezione Creare un piano lab usando PowerShell si apprende come creare un piano lab denominato ContosoLabPlan
in un gruppo di risorse denominato MyResourceGroup
.
$plan = Get-AzLabServicesLabPlan `
-Name "ContosoLabPlan" `
-ResourceGroupName "MyResourceGroupName"
È anche necessario scegliere un'immagine di base per le macchine virtuali del lab tra quelle disponibili per il piano lab. Vediamo cosa è disponibile.
$plan | Get-AzLabServicesPlanImage | Where-Object { $_.EnabledState.ToString() -eq "enabled" }
Sceglieremo l'immagine di Windows 11.
$image = $plan | Get-AzLabServicesPlanImage | Where-Object { $_.EnabledState.ToString() -eq "enabled" -and $_.DisplayName -eq "Windows 11 Pro (Gen2)" }
Quando si crea un lab usando PowerShell, è anche necessario fornire le informazioni sullo SKU della risorsa. Il comando seguente usa l'API REST per recuperare l'elenco degli SKU e seleziona lo SKU Classic_Fsv2_4_8GB_128_S_SSD
:
$subscriptionId = (Get-AzContext).Subscription.ID
$skus = (Invoke-AzRestMethod -Uri https://management.azure.com/subscriptions/$subscriptionId/providers/Microsoft.LabServices/skus?api-version=2022-08-01 | Select-Object -Property "Content" -ExpandProperty Content | ConvertFrom-Json).value
$sku = $skus | Where-Object -Property "name" -eq "Classic_Fsv2_4_8GB_128_S_SSD" | select-object -First 1
Ora è possibile creare un lab basato sul piano lab con l'immagine di Window 11 Pro e lo SKU della risorsa Classic_Fsv2_4_8GB_128_S_SSD
. Il comando seguente crea un lab usando il piano lab creato in precedenza.
# $plan and $image are from the Create LabPlan QuickStart.
$password = "<custom password>"
$lab = New-AzLabServicesLab -Name "ContosoLab" `
-ResourceGroupName "MyResourceGroup" `
-Location "westus" `
-LabPlanId $plan.Id `
-AdminUserPassword (ConvertTo-SecureString $password -AsPlainText -Force) `
-AdminUserUsername "adminUser" `
`
-AutoShutdownProfileShutdownOnDisconnect Enabled `
-AutoShutdownProfileDisconnectDelay $(New-Timespan) `
-AutoShutdownProfileShutdownOnIdle "LowUsage" `
-AutoShutdownProfileIdleDelay $(New-TimeSpan -Minutes 15) `
-AutoShutdownProfileShutdownWhenNotConnected Disabled `
-AutoShutdownProfileNoConnectDelay $(New-TimeSpan -Minutes 15) `
`
-ConnectionProfileClientRdpAccess Public `
-ConnectionProfileClientSshAccess None `
-ConnectionProfileWebRdpAccess None `
-ConnectionProfileWebSshAccess None `
-SecurityProfileOpenAccess Disabled `
`
-ImageReferenceOffer $image.Offer `
-ImageReferencePublisher $image.Publisher `
-ImageReferenceSku $image.Sku `
-ImageReferenceVersion $image.Version `
-SkuCapacity 1 `
-SkuName $sku.size `
`
-Title "Contoso Lab" `
-Description "The Contoso lab" `
-AdditionalCapabilityInstallGpuDriver Disabled `
-VirtualMachineProfileCreateOption "TemplateVM" `
-VirtualMachineProfileUseSharedPassword Enabled
Pulire le risorse
Se non si intende continuare a usare questa applicazione, eliminare il piano e il lab seguendo questa procedura:
$lab | Remove-AzLabServicesLab
Ulteriori informazioni
Gli amministratori possono ottenere altre informazioni sui moduli di Azure PowerShell e sui cmdlet Az.LabServices.