Snabbstart: Skapa en Azure Portal instrumentpanel med PowerShell

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

Krav

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

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 Anslut-AzAccount. Mer information om hur du installerar Az PowerShell-modulen finns i Installera Azure PowerShell.

Install-Module -Name Az.Portal

Använda 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 av ett kodblock. Om du väljer Prova kopieras koden inte 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 kör du koden i den här artikeln i Azure Cloud Shell:

1. Starta Cloud Shell.

2. Kopiera koden genom att klicka på knappen Kopiera på ett kodblock.

3. Klistra in koden i Cloud Shell-sessionen genom att välja Ctrl+Skift+V på Windows och Linux eller genom att välja Cmd+Skift+V på macOS.

4. Välj Retur för att köra koden.

Välj en specifik Azure-prenumeration

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

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

Definiera variabler

Du kommer att använda flera olika typer av information upprepade gånger. Skapa variabler för att lagra 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 = 'SimpleWinVM'

Skapa en resursgrupp

Skapa en Azure-resursgrupp med hjälp av 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 $resourceGroupName variabeln i den region som anges i $location variabeln.

New-AzResourceGroup -Name $resourceGroupName -Location $location

Skapa en virtuell dator

Instrumentpanelen som du skapar i nästa del av den här snabbstarten kräver en befintlig virtuell dator. Skapa en virtuell dator genom att följa dessa steg.

Lagra inloggningsuppgifterna 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. det är till exempel inte det konto som du använder för att logga in på Azure. Mer information finns i krav för användarnamn och lösenord.

$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 instrumentpanelens mall

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/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

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 finns i mallreferensen för instrumentpaneler i Microsoft Portal.

Distribuera instrumentpanelens mall

Du kan använda New-AzPortalDashboard cmdleten som ingår i modulen Az.Portal 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

Kontrol lera att du kan se data om den virtuella datorn inifrån Azure Portal instrument panelen.

1. Öppna Azure-portalen och välj Instrumentpanel.

   

2. På instrument panels sidan väljer du enkel instrument panel för virtuell dator.

   

3. Granska instrument panelen som Azure Resource Managers mal len (ARM-mallen) skapades. Du kan se att en del av innehållet är statiskt, men det finns även diagram som visar prestanda för den virtuella dator som du skapade i början.

   

Rensa resurser

Om du vill ta bort den virtuella datorn och den associerade instrumentpanelen tar du bort resursgruppen som innehåller dem.

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

Nästa steg

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