Criar um laboratório no Azure Lab Services usando o PowerShell e o módulo do Azure

Importante

O Azure Lab Services será descontinuado a 28 de junho de 2027. Para obter mais informações, consulte o guia de aposentadoria.

Neste artigo, você aprenderá a criar um laboratório usando o PowerShell e os módulos do Azure. O laboratório usa as configurações de um plano de laboratório criado anteriormente. Para obter uma visão geral detalhada dos Serviços de Laboratório do Azure, consulte Uma introdução aos Serviços de Laboratório do Azure.

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

• Uma conta do Azure com permissão para gerenciar um laboratório, como a função RBAC do Azure Criador de Lab, Proprietário, Colaborador ou Colaborador de Serviços de Laboratório . Saiba mais sobre as funções internas e os escopos de atribuição do Azure Lab Services.

• Um plano de laboratório do Azure. Se você ainda não tem um plano de laboratório, siga as etapas em Guia de início rápido: configurar recursos para criar laboratórios.

• Windows PowerShell.

• Módulo Azure Az do PowerShell. Deve ser a versão 7.2 ou superior.

  Install-Module 'Az'
  

• Módulo Az.LabServices do PowerShell.

  Install-Module 'Az.LabServices'
  

• Plano de laboratório. Para criar um plano de laboratório, consulte Criar um plano de laboratório usando o PowerShell e os módulos do Azure.

Execute Connect-AzAccount para entrar no Azure e verificar uma assinatura ativa.

Criar um laboratório

Antes de criar um laboratório, você precisa do recurso de plano de laboratório. No capítulo Criar um plano de laboratório usando o PowerShell, você aprenderá a criar um plano de laboratório nomeado ContosoLabPlan em um grupo de recursos chamado MyResourceGroup.

$plan = Get-AzLabServicesLabPlan `
    -Name "ContosoLabPlan" `
    -ResourceGroupName "MyResourceGroupName"

Também precisamos de escolher uma imagem de base para as VMs do laboratório a partir das imagens disponíveis para o plano do laboratório. Vamos ver o quais as imagens disponíveis.

$plan | Get-AzLabServicesPlanImage | Where-Object { $_.EnabledState.ToString() -eq "enabled" }

Vamos escolher a imagem do Windows 11.

$image = $plan | Get-AzLabServicesPlanImage | Where-Object { $_.EnabledState.ToString() -eq "enabled" -and $_.DisplayName -eq "Windows 11 Pro (Gen2)" }

Ao criar um laboratório usando o PowerShell, você também precisa fornecer as informações de SKU do recurso. O comando a seguir usa a API REST para recuperar a lista de SKUs e seleciona a Classic_Fsv2_4_8GB_128_S_SSD SKU:

$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

Agora estamos prontos para criar um laboratório baseado em nosso plano de laboratório com a imagem do Windows 11 Pro e o Classic_Fsv2_4_8GB_128_S_SSD recurso SKU. O comando seguinte criará um laboratório com base no plano de laboratório criado acima.

# $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

Clean up resources (Limpar recursos)

Se você não vai continuar a usar este aplicativo, exclua o plano e o laboratório com as seguintes etapas:

$lab | Remove-AzLabServicesLab

Mais informações

Como administrador, você pode saber mais sobre o módulo do Azure PowerShell e os cmdlets Az.LabServices.