Quickstart: Een Azure Portal-dashboard maken met PowerShell

Een dashboard in de Azure-portal is een gerichte en georganiseerde weergave van uw cloudresources. Dit artikel richt zich op het gebruik van de PowerShell-module Az.Portal voor het maken van een dashboard. Het dashboard toont de prestaties van een virtuele machine (VM), evenals een aantal statische gegevens en links.

Vereisten

Als u nog geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Als u PowerShell lokaal wilt gebruiken, moet u voor dit artikel de Az-module van PowerShell 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-module van PowerShell.

Install-Module -Name Az.Portal

Azure Cloud Shell gebruiken

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 opdrachten van Cloud Shell 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:

Optie	Voorbeeld/koppeling
Selecteer Nu proberen in de rechterbovenhoek van een codeblok. Als u Uitproberen selecteert, wordt de code 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.

Om de code in dit artikel in Azure Cloud Shell uit te voeren:

1. Start Cloud Shell.

2. Selecteer de knop Kopiëren op een codeblok om de code te kopiëren.

3. Plak de code in de Cloud Shell-sessie door CTRL+Shift+V te selecteren in Windows en Linux of door Cmd+Shift+V op macOS te selecteren.

4. Selecteer Invoeren om de code uit te voeren.

Een specifiek Azure-abonnement kiezen

Als u meerdere Azure-abonnementen hebt, kiest u het juiste abonnement waarin de resource moet worden gefactureerd. Selecteer een specifiek abonnement met de cmdlet set-AzContext.

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

Variabelen definiëren

U gebruikt herhaaldelijk verschillende gegevens. Maak variabelen om de gegevens 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 = 'SimpleWinVM'

Een resourcegroep maken

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

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

New-AzResourceGroup -Name $resourceGroupName -Location $location

Een virtuele machine maken

Het dashboard dat u in het volgende deel van deze quickstart maakt, vereist een bestaande VM. Volg deze stappen om een virtuele machine te maken.

Sla referenties voor de virtuele machine op in een variabele. Het wachtwoord moet complex zijn. Dit is een nieuwe gebruikersnaam en nieuw wachtwoord. Het is bijvoorbeeld 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 VM.

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

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

De dashboardsjabloon downloaden

Omdat Azure-dashboards resources zijn, kunnen ze als JSON worden weergegeven. 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/azure-docs-powershell-samples/master/azure-portal/portal-dashboard-template-testvm.json'

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

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

De sjabloon aanpassen

Voer de volgende code uit om de gedownloade sjabloon aan te passen.

$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 Referentie voor Microsoft Portal-dashboardsjablonen voor meer informatie.

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 is gemaakt.

Get-AzPortalDashboard -Name $dashboardName -ResourceGroupName $resourceGroupName

Controleer of u in het dash board van Azure Portal gegevens kunt zien over de virtuele machine.

1. In de Azure-portal selecteert u Dashboard.

   

2. Op de dashboardpagina selecteert u Eenvoudig VM-dashboard.

   

3. Bekijk het dash board dat door de Azure Resource Manager sjabloon (ARM-sjabloon) is gemaakt. U kunt zien dat een deel van de inhoud statisch is, maar er zijn ook grafieken waarin de prestaties van de virtuele machine worden weergegeven die u aan het begin hebt gemaakt.

   

Resources opschonen

Als u de virtuele machine en het bijbehorende dashboard wilt verwijderen, verwijdert u de resourcegroep waarin deze zich bevinden.

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: