Quickstart: Een Azure Portal-dashboard maken met PowerShell

Een dashboard in Azure Portal is een gerichte en georganiseerde weergave van uw cloudresources. Dit artikel is gericht op het proces van het gebruik van de PowerShell-module Az.Portal om een dashboard te maken. Het voorbeelddashboard toont de prestaties van een virtuele machine (VM) die u maakt, samen met enkele statische informatie en koppelingen.

Prerequisites

• Een Azure-account met een actief abonnement. Gratis een account maken

• Als u PowerShell lokaal wilt gebruiken, moet u voor dit artikel de Az PowerShell-module installeren en verbinding maken met uw Azure-account met behulp van de cmdlet Connect-AzAccount . Zie Azure PowerShell installeren voor meer informatie over het installeren van de Az PowerShell-module.

Azure Cloud Shell

Azure host Azure Cloud Shell, een interactieve shell-omgeving die u via uw browser kunt gebruiken. U kunt Bash of PowerShell gebruiken met Cloud Shell om met Azure-services te werken. U kunt de vooraf geïnstalleerde Cloud Shell-opdrachten gebruiken om de code in dit artikel uit te voeren zonder dat u iets hoeft te installeren in uw lokale omgeving.

Om Azure Cloud Shell op te starten:

Option	Example/Link
Selecteer Uitproberen in de rechterbovenhoek van een code- of opdrachtblok. Als u Try It selecteert, wordt de code of opdracht niet automatisch gekopieerd naar Cloud Shell.
Ga naar https://shell.azure.com, of selecteer de knop Cloud Shell starten om Cloud Shell in uw browser te openen.
Klik op de knop Cloud Shell in het menu in de balk rechtsboven in de Azure-portal.

Azure Cloud Shell gebruiken:

1. Start Cloud Shell.

2. Selecteer de knop Kopiëren op een codeblok (of opdrachtblok) om de code of opdracht te kopiëren.

3. Plak de code of opdracht in de Cloud Shell-sessie door op Windows en Linux de toetsencombinatie Ctrl+Shift+V in te drukken, of op macOS de toetsencombinatie Cmd+Shift+V te gebruiken.

4. Selecteer Enter om de code of opdracht uit te voeren.

Een specifiek Azure-abonnement kiezen

Als u meerdere Azure-abonnementen hebt, kiest u het juiste abonnement waarin de resources moeten worden gefactureerd. Selecteer een specifiek abonnement met behulp van de cmdlet Set-AzContext.

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

Variabelen definiëren

In het voorbeelddashboard worden meerdere stukjes informatie herhaaldelijk gebruikt. Maak variabelen om deze informatie op te slaan.

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

Een brongroep maken

Maak een Azure-resourcegroep met behulp van de cmdlet New-AzResourceGroup . Een resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd als een groep.

In het volgende voorbeeld wordt een resourcegroep gemaakt op basis van de naam in de $resourceGroupName variabele in de regio die is opgegeven in de $location variabele.

New-AzResourceGroup -Name $resourceGroupName -Location $location

Een virtuele machine maken

Voor het voorbeelddashboard is een virtuele machine vereist. Als u al een VIRTUELE machine hebt, kunt u uw sjabloon bijwerken om die VM te gebruiken. Anders kunt u een voorbeeld-VM maken door deze stappen uit te voeren.

Sla aanmeldingsreferenties voor de virtuele machine op in een variabele. Het wachtwoord moet complex zijn. Dit is een nieuwe gebruikersnaam en een nieuw wachtwoord (niet het account dat u gebruikt om u aan te melden bij Azure). Zie gebruikersnaamvereisten en wachtwoordvereisten voor meer informatie.

$Cred = Get-Credential

Maak de VIRTUELE machine.

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

De VM-implementatie wordt nu gestart en duurt meestal een paar minuten. Nadat de implementatie is voltooid, gaat u verder met de volgende sectie.

De dashboardsjabloon downloaden

Omdat Azure-dashboards resources zijn, kunnen ze worden weergegeven als JSON. Met de volgende code wordt een JSON-weergave van een voorbeelddashboard gedownload. Zie de structuur van Azure-dashboards voor meer informatie.

$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

De sjabloon aanpassen

Pas de gedownloade sjabloon aan door de volgende code uit te voeren.

$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

Zie de sjabloonreferentie voor Microsoft-portaldashboards voor meer informatie over de structuur van de dashboardsjabloon.

De dashboardsjabloon implementeren

U kunt de New-AzPortalDashboard cmdlet die deel uitmaakt van de Az.Portal-module gebruiken om de sjabloon rechtstreeks vanuit PowerShell te implementeren.

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

De geïmplementeerde resources bekijken

Controleer of het dashboard succesvol is gemaakt.

Get-AzPortalDashboard -Name $dashboardName -ResourceGroupName $resourceGroupName

Controleer of u gegevens over uw virtuele machine kunt zien in het Dashboard van Azure Portal.

1. Selecteer Dashboard in het menu van Azure Portal.

   

2. Selecteer Eenvoudig VM-dashboard op de dashboardpagina.

   

3. Bekijk het dashboard. Dit moet er ongeveer uitzien als het dashboard dat hier wordt weergegeven. Hoewel een deel van de inhoud statisch is, zijn er ook grafieken die de prestaties weergeven van de VM die u aan het begin hebt gemaakt.

   

De hulpbronnen opschonen

Als u de VIRTUELE machine en het bijbehorende dashboard wilt verwijderen, verwijdert u de resourcegroep die deze bevat.

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

Volgende stappen

Zie voor meer informatie over de cmdlets in de PowerShell-module Az.Portal: