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.
Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
Se si sceglie di usare PowerShell in locale, per questo articolo è necessario installare il modulo Az PowerShell e connettersi all'account di Azure usando il cmdlet Connect-AzAccount. Per altre informazioni sull'installazione del modulo Az PowerShell, vedere Installare Azure PowerShell.
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. | |
Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser. | |
Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure. |
Per usare Azure Cloud Shell:
Avviare Cloud Shell.
Selezionare il pulsante Copia in un blocco di codice (o in un blocco di comando) per copiare il codice o il comando.
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.
Premere Invio per eseguire il codice o il comando.
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
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 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
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.
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 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.
È 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
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.
Selezionare Dashboard nel menu del portale di Azure.
Nella pagina del dashboard selezionare Simple VM Dashboard.
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.
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"
Per altre informazioni sui cmdlet contenuti nel modulo Az.Portal di PowerShell, vedere: