Förbereda din miljö för Azure CLI

Artikel
12/06/2023

I det här självstudiesteget kör du dina första Azure CLI-kommandon! Detta inkluderar att hitta och ange din aktiva prenumeration och ange standardvärden. Du får också lära dig hur du skapar resursgrupper som innehåller ett slumpmässigt ID för att alltid garantera ett unikt resursnamn.

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

För att slutföra det här självstudiesteget behöver contributor du eller högre behörigheter för din prenumeration.

Installera Azure CLI

Kom igång genom att först välja din miljö.

Använd Bash-miljön i Azure Cloud Shell genom att välja knappen Öppna Cloud Shell i det övre högra hörnet av varje Azure CLI-kodblock.
Om du föredrar att köra Azure CLI-referenskommandona lokalt installerar du Azure CLI.

Den aktuella versionen av Azure CLI är 2.60.0. Information om den senaste versionen finns i viktig information. Kör az version för att hitta den installerade versionen och se om du behöver uppdatera.

Det finns flera autentiseringsalternativ när du arbetar med Azure CLI. Azure CLI:s standardautentiseringsmetod för inloggningar använder en webbläsare och åtkomsttoken för att logga in.

Kör kommandot az login.
```
az login
```
Om Azure CLI kan öppna standardwebbläsaren initierar den auktoriseringskodflödet och öppnar standardwebbläsaren för att läsa in en Azure-inloggningssida.

Annars initieras enhetskodflödet och du uppmanas att öppna en webbläsarsida på https://aka.ms/devicelogin. Ange sedan koden som visas i terminalen.

Om ingen webbläsare är tillgänglig eller om webbläsaren inte kan öppnas kan du tvinga enhetskodflödet med az login --use-device-code.
Logga in med dina autentiseringsuppgifter för kontot i webbläsaren.

Hitta och ändra din aktiva prenumeration

När du har loggat in på Azure CLI kontrollerar du alltid din aktuella prenumeration. Om du inte arbetar under den prenumeration du föredrar ändrar du prenumerationen med az account set. Här är ett kodexempel att använda:

# see your current/default subscription
az account show

# find the list of subscriptions available to you
az account list --output table

# change your current/default subscription
az account set --subscription <mySubscriptionName>

# you can also set your subscription using a subscription ID
az account set --subscription <00000000-0000-0000-0000-000000000000>

Konsolutdata för az account show kommando:

{
  "environmentName": "AzureCloud",
  "homeTenantId": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "isDefault": true,
  "managedByTenants": [],
  "name": "Your storage account name",
  "state": "Enabled",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "user": {
    "name": "yourName@contoso.com",
    "type": "user"
  }
}

Läs mer om resursgrupper

En resursgrupp är en container för Azure-resurser. Om du vill skapa en resursgrupp behöver contributor du behörigheter eller högre i din prenumeration.

Skapa en resursgrupp

I en prenumeration måste ett resursgruppsnamn vara unikt. Kontrollera först om det namn du vill ha är tillgängligt med kommandot az group exists . Ett utdatavärde för false innebär att namnet är tillgängligt.
```
az group exists --name <myUniqueRGname>
```
Hämta en lista över regioner som stöds för din prenumeration med kommandot az account list-locations . En lista över tillgängliga Azure-platser finns i Välj rätt Azure-region åt dig.
```
az account list-locations --query "[].{Region:name}" --output table
```
Det är dags att skapa resursgruppen! Använd kommandot az group create.
```
az group create --location <myLocation> --name <myUniqueRGname>
```

Skapa en resursgrupp som innehåller ett slumpmässigt ID

När du testar är det bäst att skapa en resursgrupp som innehåller ett slumpmässigt ID i namnet. Genom att lägga till ett slumpmässigt ID i resursgruppens namn kan du testa koden igen utan att behöva vänta tills en tidigare resursgrupp med samma namn har tagits bort från Azure.

Bash- och PowerShell-variabelsyntaxen skiljer sig åt. Kopiera rätt skript för din miljö.

Bash
PowerShell

let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

$randomIdentifier = (New-Guid).ToString().Substring(0,8)
$location="eastus"
$resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Bash- och PowerShell-konsolutdata:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/msdocs-tutorial-rg-000000000",
  "location": "eastus",
  "managedBy": null,
  "name": "msdocs-tutorial-rg-000000000",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Ange miljövariabler

Azure CLI erbjuder flera alternativ som gör att du kan återanvända vanliga parametervärden. Dessa standardvärden lagras i miljövariabler och är unika för varje inloggning.

Ange din standardresursgrupp.

az config set defaults.group=<msdocs-tutorial-rg-0000000>

Ange flera miljövariabler samtidigt.

Många Azure CLI-parametrar tar flera värden avgränsade med ett blanksteg. Konfigurationsvärden är en sådan instans. I nästa exempel anges både standardvärdena .location och .group som används av parametrarna --location och --resource-group för varje Azure CLI-kommando.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Ange standardutdata.

När du väljer att arbeta i Azure Cloud Shell eller installera Azure CLI lokalt anges standardutdata automatiskt till json. Detta är dock en av de viktigaste standardvärdena för att förstå och ange. Utdata avgör vad som visas i konsolen och vad som skrivs till loggfilen. Använd alltid utdata från none när du skapar resurser som returnerar nycklar, lösenord och hemligheter.
```
az config set core.output=none
```
I den här självstudien arbetar vi inte med hemligheter. Ange standardvärdet tillbaka till så att json du kan se returnerade utdata för varje referenskommando i den här självstudien.
```
az config set core.output=json
```

Lär dig att använda az init.

Azure CLI har ett referenskommando som vägleder dig genom att konfigurera din miljö. Skriv az init in konsolen och tryck på Retur. Följ anvisningarna.

az init

Det första fina med az init är att det ger dig alla dina nuvarande inställningar! Här är exempel på utdata:

Your current config settings:

  Output format: JSON 
  [core.output = json]

  Standard error stream (stderr): All events 
  [core.only_show_errors = false]

  Error output: Show recommendations 
  [core.error_recommendation = on]

  Syntax highlighting: On 
  [core.no_color = false]

  Progress Bar: On 
  [core.disable_progress_bar = false]


Select an option by typing it's number

  [1] Optimize for interaction
      These settings improve the output legibility and optimize for human interaction

  [2] Optimize for automation
      These settings optimize for machine efficiency

  [3] Customize settings
      A walk through to customize common configurations

  [4] Exit (default)
      Return to the command prompt

? Your selection:

Leta upp och läs konfigurationsfilen.

Om du arbetar med ett "förtroende men verifiera" tänkesätt vill du veta var dina konfigurationsfiler lagras och vad de innehåller. Själva konfigurationsfilen finns på $AZURE_CONFIG_DIR/config. Standardvärdet för AZURE_CONFIG_DIR är $HOME/.azure på Linux and macOS, och %USERPROFILE%\.azure för Windows. Leta upp konfigurationsfilen nu och se vad den innehåller.

Få mer information

Vill du ha mer information om något av de ämnen som beskrivs i det här självstudiesteget? Använd länkarna i den här tabellen om du vill veta mer.

Ämne	Läs mer
Miljöer	Välj rätt kommandoradsverktyg för Azure
Inloggningsalternativ	Logga in med Azure CLI
Villkor	Terminologi och supportnivåer för Azure CLI
Prenumerationer	Hantera prenumerationer med Hjälp av Azure CLI
Resursgrupper	Hantera resursgrupper med hjälp av Azure CLI
-konfigurationer	Konfigurera Azure CLI
Azure-roller	Azure-roller, Microsoft Entra-roller och klassiska administratörsroller för prenumerationer

Nästa steg

Nu när du har lärt dig hur du konfigurerar din miljö går du vidare till nästa steg för att lära dig om skriptskillnaderna mellan Bash, PowerShell och Cmd.

Lär dig skillnader i Azure CLI-syntax i Bash, PowerShell och Cmd