Snabbstart: Skapa en Azure Portal instrumentpanel med PowerShell

Artikel
10/03/2024

En instrumentpanel i Azure Portal är en fokuserad och organiserad vy över dina molnresurser. Den här artikeln fokuserar på processen att använda Az.Portal PowerShell-modulen för att skapa en instrumentpanel. Exempelinstrumentpanelen visar prestanda för en virtuell dator (VM) som du skapar, tillsammans med viss statisk information och länkar.

Förutsättningar

Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
Om du väljer att använda PowerShell lokalt kräver den här artikeln att du installerar Az PowerShell-modulen och ansluter till ditt Azure-konto med hjälp av cmdleten Connect-AzAccount . Mer information om hur du installerar Az PowerShell-modulen finns i Installera Azure PowerShell.

Azure Cloud Shell

Azure är värd för Azure Cloud Shell, en interaktiv gränssnittsmiljö som du kan använda via webbläsaren. Du kan använda antingen Bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster. Du kan använda förinstallerade Cloud Shell-kommandon för att köra koden i den här artikeln, utan att behöva installera något i din lokala miljö.

Så här startar du Azure Cloud Shell:

Alternativ	Exempel/länk
Välj Prova i det övre högra hörnet i en kod eller ett kommandoblock. Om du väljer Prova kopieras inte koden eller kommandot automatiskt till Cloud Shell.
Gå till https://shell.azure.com eller Välj knappen Starta Cloud Shell för att öppna Cloud Shell i webbläsaren.
Välj knappen Cloud Shell på menyn längst upp till höger i Azure-portalen.

Så här använder du Azure Cloud Shell:

Starta Cloud Shell.
Välj knappen Kopiera i ett kodblock (eller kommandoblock) för att kopiera koden eller kommandot.
Klistra in koden eller kommandot i Cloud Shell-sessionen genom att välja Ctrl+Skift+V i Windows och Linux, eller genom att välja Cmd+Shift+V på macOS.
Välj Retur för att köra koden eller kommandot.

Välj en specifik Azure-prenumeration

Om du har flera Azure-prenumerationer väljer du den prenumeration där resurserna ska faktureras. Välj en specifik prenumeration med hjälp av cmdleten Set-AzContext .

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

Definiera variabler

Exempelinstrumentpanelen använder flera informationsdelar upprepade gånger. Skapa variabler för att lagra den här informationen.

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

Skapa en resursgrupp

Skapa en Azure-resursgrupp med cmdleten New-AzResourceGroup . En resursgrupp är en logisk container där Azure-resurser distribueras och hanteras som en grupp.

I följande exempel skapas en resursgrupp baserat på namnet i variabeln $resourceGroupName i den region som anges i variabeln $location .

New-AzResourceGroup -Name $resourceGroupName -Location $location

Skapa en virtuell dator

Exempelinstrumentpanelen kräver en befintlig virtuell dator. Skapa en virtuell dator genom att följa dessa steg.

Lagra inloggningsuppgifter för den virtuella datorn i en variabel. Lösenordet måste vara komplext. Det här är ett nytt användarnamn och lösenord (inte det konto som du använder för att logga in på Azure). Mer information finns i användarnamnskrav och lösenordskrav.

$Cred = Get-Credential

Skapa den virtuella datorn.

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

Distributionen av den virtuella datorn startar nu och tar vanligtvis några minuter att slutföra. När distributionen är klar går du vidare till nästa avsnitt.

Ladda ned instrumentpanelsmallen

Eftersom Azure-instrumentpaneler är resurser kan de representeras som JSON. Följande kod laddar ned en JSON-representation av en exempelinstrumentpanel. Mer information finns i Strukturen för Azure-instrumentpaneler.

$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

Anpassa mallen

Anpassa den nedladdade mallen genom att köra följande kod.

$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

Mer information om mallstrukturen för instrumentpanelen finns i Mallreferens för Instrumentpaneler i Microsoft-portalen.

Distribuera instrumentpanelsmallen

Du kan använda cmdleten New-AzPortalDashboard som ingår i Az.Portal-modulen för att distribuera mallen direkt från PowerShell.

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

Granska de distribuerade resurserna

Kontrollera att instrumentpanelen har skapats.

Get-AzPortalDashboard -Name $dashboardName -ResourceGroupName $resourceGroupName

Kontrollera att du kan se data om den virtuella datorn på Azure Portal instrumentpanelen.

I menyn Azure Portal väljer du Instrumentpanel.
På instrumentpanelens sida väljer du Enkel vm-instrumentpanel.
Granska instrumentpanelen, som bör se ut ungefär som den som visas här. Även om en del av innehållet är statiskt finns det även diagram som visar prestanda för den virtuella dator som du skapade i början.

Rensa resurser

Ta bort den virtuella datorn och den associerade instrumentpanelen genom att ta bort den resursgrupp som innehåller dem.

Varning

Om du tar bort resursgruppen tas alla resurser som ingår i den bort. Om resursgruppen innehåller ytterligare resurser förutom den virtuella datorn och instrumentpanelen tas även dessa resurser bort.

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

Nästa steg

Mer information om cmdletarna i Az.Portal PowerShell-modulen finns i:

Microsoft Azure PowerShell: Cmdletar för portalinstrumentpanelen

Dela via