Avvio rapido: crea un dashboard del portale di Azure con PowerShell

Un dashboard nel portale di Azure è una visualizzazione mirata e organizzata delle risorse cloud. Questo articolo è incentrato sul processo d’uso del modulo PowerShell Az.Portal per creare un dashboard. Il dashboard di esempio mostra le prestazioni di una macchina virtuale (VM) creata, insieme ad alcune informazioni statiche e collegamenti.

Prerequisiti

Azure Cloud Shell

Azure Cloud Shell è un ambiente di shell interattivo ospitato in Azure e usato tramite il browser. È possibile usare Bash o PowerShell con Cloud Shell per usare i servizi di Azure. È possibile usare i comandi preinstallati di Cloud Shell per eseguire il codice contenuto in questo articolo senza dover installare strumenti nell'ambiente locale.

Per avviare Azure Cloud Shell:

Opzione Esempio/Collegamento
Selezionare Prova nell'angolo superiore destro di un blocco di codice o di comando. Quando si seleziona Prova, il codice o il comando non viene copiato automaticamente in Cloud Shell. Screenshot che mostra un esempio di Prova per Azure Cloud Shell.
Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser. Pulsante per avviare Azure Cloud Shell.
Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure. Screenshot che mostra il pulsante Cloud Shell nel portale di Azure

Per usare Azure Cloud Shell:

  1. Avviare Cloud Shell.

  2. Selezionare il pulsante Copia in un blocco di codice (o in un blocco di comando) per copiare il codice o il comando.

  3. Incollare il codice o il comando nella sessione di Cloud Shell selezionando CTRL+MAIUSC+V in Windows e Linux o selezionando CMD+MAIUSC+V in macOS.

  4. Premere Invio per eseguire il codice o il comando.

Scegliere una sottoscrizione di Azure specifica

Se si possiedono più sottoscrizioni di Azure, scegliere quella appropriata in cui verranno fatturate le risorse. Selezionare una sottoscrizione specifica usando il cmdlet Set-AzContext.

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

Definire le variabili

Il dashboard di esempio usa ripetutamente diverse informazioni. Creare variabili in cui archiviarle.

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

Creare un gruppo di risorse

Creare un gruppo di risorse di Azure con il cmdlet New-AzResourceGroup. Un gruppo di risorse è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite come gruppo.

L'esempio seguente crea un gruppo di risorse basato sul nome incluso nella variabile $resourceGroupName nell'area specificata nella variabile $location.

New-AzResourceGroup -Name $resourceGroupName -Location $location

Creare una macchina virtuale

Il dashboard di esempio richiede una macchina virtuale esistente. Creare una VM seguendo questa procedura.

Archiviare le credenziali di accesso per la VM in una variabile. La password deve essere complessa. Si tratta di un nuovo nome utente e una nuova password (non l'account usato per accedere ad Azure). Per altre informazioni, vedere i requisiti relativi ai nomi utente e i requisiti relativi alle password.

$Cred = Get-Credential

Creare la macchina virtuale.

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

La distribuzione della VM viene avviata e in genere impiega alcuni minuti. Al termine della distribuzione, passare alla sezione successiva.

Scaricare il modello di dashboard

Poiché i dashboard di Azure sono risorse, possono essere rappresentati come JSON. Il codice seguente scarica una rappresentazione JSON di un dashboard di esempio. Per altre informazioni, vedere Struttura dei dashboard di 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

Personalizzare il modello

Personalizzare il modello scaricato eseguendo il codice seguente.

$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

Per altre informazioni sulla struttura dei modelli di dashboard, vedere informazioni di riferimento sul modello dei dashboard del portale Microsoft.

Distribuire il modello di dashboard

È possibile usare il cmdlet New-AzPortalDashboard che fa parte del modulo Az.Portal per distribuire il modello direttamente da PowerShell.

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

Esaminare le risorse distribuite

Verificare che il dashboard sia stato creato correttamente.

Get-AzPortalDashboard -Name $dashboardName -ResourceGroupName $resourceGroupName

Verificare che sia possibile visualizzare i dati sulla macchina virtuale nel dashboard del portale di Azure.

  1. Selezionare Dashboard nel menu del portale di Azure.

    Screenshot dell’elemento Dashboard nel menu del portale di Azure.

  2. Nella pagina del dashboard selezionare Simple VM Dashboard.

    Screenshot dell’opzione di selezione del dashboard nel portale di Azure.

  3. Esaminare il dashboard che dovrebbe essere simile a quello illustrato qui. Anche se alcuni contenuti sono statici, esistono anche grafici che mostrano le prestazioni della macchina virtuale creata all’inizio.

    Screenshot di un dashboard di esempio nel portale di Azure.

Pulire le risorse

Per rimuovere la VM e il dashboard associato, eliminare il gruppo di risorse che li contiene.

Attenzione

Se si elimina il gruppo di risorse, tutte le risorse contenute verranno eliminate. Se il gruppo di risorse contiene risorse aggiuntive a parte la macchina virtuale e il dashboard, anche tali risorse verranno eliminate.

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

Passaggi successivi

Per altre informazioni sui cmdlet contenuti nel modulo Az.Portal di PowerShell, vedere: