Guia de início rápido: criar um painel do portal do Azure com o PowerShell

Artigo
10/03/2024

Um painel no portal do Azure é uma exibição focada e organizada de seus recursos de nuvem. Este artigo se concentra no processo de usar o módulo Az.Portal PowerShell para criar um painel. O painel de exemplo mostra o desempenho de uma máquina virtual (VM) que você cria, juntamente com algumas informações estáticas e links.

Pré-requisitos

Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
Se você optar por usar o PowerShell localmente, este artigo exigirá que você instale o módulo Az PowerShell e se conecte à sua conta do Azure usando o cmdlet Connect-AzAccount . Para obter mais informações sobre como instalar o módulo Az PowerShell, consulte Instalar o Azure PowerShell.

Azure Cloud Shell

O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Você pode usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada em seu ambiente local.

Para iniciar o Azure Cloud Shell:

Opção	Exemplo/Ligação
Selecione Experimentar no canto superior direito de um código ou bloco de comandos. Selecionar Experimentar não copia automaticamente o código ou comando para o Cloud Shell.
Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser.
Selecione o botão Cloud Shell na barra de menus, na parte direita do portal do Azure.

Para usar o Azure Cloud Shell:

Inicie o Cloud Shell.
Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou comando.
Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e Linux ou selecionando Cmd+Shift+V no macOS.
Selecione Enter para executar o código ou comando.

Escolha uma assinatura específica do Azure

Se você tiver várias assinaturas do Azure, escolha a assinatura apropriada na qual os recursos devem ser cobrados. Selecione uma assinatura específica usando o cmdlet Set-AzContext .

Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000

Definir variáveis

O painel de exemplo usa várias informações repetidamente. Crie variáveis para armazenar essas informações.

# Name of resource group used throughout this article
$resourceGroupName = 'myResourceGroup'

# Azure region
$location = 'centralus'

# Dashboard Title
$dashboardTitle = 'Simple VM Dashboard'

# Dashboard Name
$dashboardName = $dashboardTitle -replace '\s'

# Your Azure Subscription ID
$subscriptionID = (Get-AzContext).Subscription.Id

# Name of test VM
$vmName = 'myVM1'

Criar um grupo de recursos

Crie um grupo de recursos do Azure usando o cmdlet New-AzResourceGroup. Um grupo de recursos é um contentor lógico no qual os recursos do Azure são implementados e geridos como um grupo.

O exemplo a seguir cria um grupo de recursos com base no nome na $resourceGroupName variável na região especificada na $location variável.

New-AzResourceGroup -Name $resourceGroupName -Location $location

Criar uma máquina virtual

O painel de exemplo requer uma VM existente. Crie uma VM seguindo estas etapas.

Armazene as credenciais de login para a VM em uma variável. A senha deve ser complexa. Este é um novo nome de usuário e senha (não a conta que você usa para entrar no Azure). Para obter mais informações, consulte Requisitos de nome de usuário e requisitos de senha.

$Cred = Get-Credential

Crie a VM.

$AzVmParams = @{
  ResourceGroupName = $resourceGroupName
  Name = $vmName
  Location = $location
  Credential = $Cred
}
New-AzVm @AzVmParams

A implantação da VM agora é iniciada e normalmente leva alguns minutos para ser concluída. Após a conclusão da implantação, passe para a próxima seção.

Baixe o modelo de painel

Como os painéis do Azure são recursos, eles podem ser representados como JSON. O código a seguir baixa uma representação JSON de um painel de exemplo. Para obter mais informações, consulte A estrutura dos Painéis do Azure.

$myPortalDashboardTemplateUrl = 'https://raw.githubusercontent.com/Azure-Samples/azure-docs-powershell-samples/refs/heads/main/azure-portal/portal-dashboard-template-testvm.json'

$myPortalDashboardTemplatePath = "$HOME\portal-dashboard-template-testvm.json"

Invoke-WebRequest -Uri $myPortalDashboardTemplateUrl -OutFile $myPortalDashboardTemplatePath -UseBasicParsing

Personalizar o modelo

Personalize o modelo baixado executando o código a seguir.

$Content = Get-Content -Path $myPortalDashboardTemplatePath -Raw
$Content = $Content -replace '<subscriptionID>', $subscriptionID
$Content = $Content -replace '<rgName>', $resourceGroupName
$Content = $Content -replace '<vmName>', $vmName
$Content = $Content -replace '<dashboardTitle>', $dashboardTitle
$Content = $Content -replace '<location>', $location
$Content | Out-File -FilePath $myPortalDashboardTemplatePath -Force

Para obter mais informações sobre a estrutura do modelo de painel, consulte Referência de modelo de painéis do portal da Microsoft.

Implantar o modelo de painel

Você pode usar o New-AzPortalDashboard cmdlet que faz parte do módulo Az.Portal para implantar o modelo diretamente do PowerShell.

$DashboardParams = @{
  DashboardPath = $myPortalDashboardTemplatePath
  ResourceGroupName = $resourceGroupName
  DashboardName = $dashboardName
}
New-AzPortalDashboard @DashboardParams

Revisar os recursos implantados

Verifique se o painel foi criado com êxito.

Get-AzPortalDashboard -Name $dashboardName -ResourceGroupName $resourceGroupName

Verifique se você pode ver dados sobre sua máquina virtual no painel do portal do Azure.

No menu do portal do Azure, selecione Painel.
Na página do painel, selecione Painel de VM simples.
Analise o painel, que deve ser semelhante ao mostrado aqui. Embora parte do conteúdo seja estático, também há gráficos que mostram o desempenho da VM criada no início.

Clean up resources (Limpar recursos)

Para remover a VM e o painel associado, exclua o grupo de recursos que os contém.

Atenção

A exclusão do grupo de recursos excluirá todos os recursos contidos nele. Se o grupo de recursos contiver recursos adicionais além da máquina virtual e do painel, esses recursos também serão excluídos.

Remove-AzResourceGroup -Name $resourceGroupName
Remove-Item -Path "$HOME\portal-dashboard-template-testvm.json"

Próximos passos

Para obter mais informações sobre os cmdlets contidos no módulo Az.Portal PowerShell, consulte:

Microsoft Azure PowerShell: cmdlets do Painel do Portal

Partilhar via