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

Importante

O Azure Lab Services será desativado em 28 de junho de 2027. Para obter mais informações, consulte o cuia de desativação.

Neste artigo, você aprenderá a criar um laboratório usando o PowerShell e os módulos do Azure. O laboratório usará as configurações de um plano de laboratório criado anteriormente. Para obter uma visão geral detalhada do Azure Lab Services, confira Uma introdução ao Azure Lab Services.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se você não tiver uma assinatura 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 Criador de Laboratório, Proprietário, Colaborador ou Colaborador do Lab Services RBAC do Azure. Saiba mais sobre as funções internas e os escopos de atribuição do Azure Lab Services.

• Um plano do Azure Lab. Se você ainda não tiver um plano de laboratório, siga as etapas em Início Rápido: Configurar recursos para criar laboratórios.

• Windows PowerShell.

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

  Install-Module 'Az'
  

• Módulo PowerShell Az.LabServices.

  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 verifique se há uma assinatura ativa.

Criar um laboratório

Antes de criar um laboratório, você precisa do recurso de plano de laboratório. No artigoCriação de um plano de laboratório usando o PowerShell, você aprende 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 escolher uma imagem base para as VMs de laboratório das imagens disponíveis para o plano de laboratório. Vamos ver o que está disponível.

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

Escolheremos 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 do SKU de recurso. O comando a seguir usa a API REST para recuperar a lista de SKUs e seleciona o 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

Agora estamos prontos para criar um laboratório baseado no nosso plano de laboratório com a imagem do Windows 11 Pro e o SKU de recurso Classic_Fsv2_4_8GB_128_S_SSD. O comando a seguir criará um laboratório usando o 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

Limpar os recursos

Se você não vai continuar usando o aplicativo, exclua o plano e o laboratório seguindo estas etapas:

$lab | Remove-AzLabServicesLab

Mais informações

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