你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

为 Azure CLI 准备环境

项目
12/11/2023

在本教程步骤中，将执行第一个 Azure CLI 命令！这包括查找和设置活动订阅和设置默认值。你还将了解如何创建包含随机 ID 的资源组，以始终保证资源名称是唯一的。

如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。

若要完成本教程步骤，需要订阅中有 contributor 或更高权限。

安装 Azure CLI

首先要选择环境。

通过在每个 Azure CLI 代码块右上角选择“打开 Cloud Shell”按钮，在 Azure Cloud Shell 中使用 Bash 环境。
如果希望在本地运行 Azure CLI 引用命令，请安装 Azure CLI。

Azure CLI 的当前版本为 2.60.0。有关最新版本的信息，请参阅发行说明。若要查找已安装的版本并查看是否需要更新，请运行 az 版本。

使用 Azure CIL 时有若干身份验证选项。 Azure CLI 的默认登录身份验证方法是使用 Web 浏览器和访问令牌进行登录。

运行 az login 命令。
```
az login
```
如果 Azure CLI 可以打开默认浏览器，则会启动授权代码流，并打开默认浏览器来加载 Azure 登录页面。

否则，它会启动设备代码流，并指示打开浏览器页面，于 https://aka.ms/devicelogin。然后，输入终端中显示的代码。

如果没有可用的 Web 浏览器或 Web 浏览器无法打开，可通过 az login --use-device-code 强制使用设备代码流。
在浏览器中使用帐户凭据登录。

查找和更改活动订阅

登录到 Azure CLI 后，请始终检查当前订阅。如果没有在想要的订阅下操作，请使用 az account set更改订阅。此处提供了代码示例：

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

az account show 命令的控制台输出：

{
  "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"
  }
}

了解资源组

资源组是 Azure 资源的容器。若要创建资源组，需要在订阅中有 contributor 权限或更高权限。

创建资源组

在订阅中，资源组名称必须是唯一的。首先，使用 az group exists 命令检查所需的名称是否可用。 false 的输出值表示名称可用。
```
az group exists --name <myUniqueRGname>
```
使用 az account list-locations 命令检索订阅支持的区域列表。有关可用 Azure 位置的列表，请参阅“选择适合你的 Azure 区域”。
```
az account list-locations --query "[].{Region:name}" --output table
```

是时候创建资源组了！使用 az group create 命令。

az group create --location <myLocation> --name <myUniqueRGname>

创建包含随机 ID 的资源组

测试时，最好创建一个资源组，并在名称中包含随机 ID。将随机 ID 添加到资源组名称后，即可重新测试代码，而无需等待之前同名的资源组从 Azure 中删除。

Bash 和 PowerShell 变量语法不同。为环境复制正确的脚本。

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 和 PowerShell 控制台输出：

{
  "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"
}

设置环境变量。

Azure CLI 提供了多个选项，可用于重复使用通用参数值。这些默认值存储在环境变量中，并且对于每个登录都是唯一的。

设置默认资源组。

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

一次设置多个环境变量。

许多 Azure CLI 参数采用多个用空格分隔的值。配置值是一个此类实例。下一个示例设置每个 Azure CLI 命令的 --location 和 --resource-group 参数使用的 .location 和 .group 默认值。
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
设置默认输出。

选择在 Azure Cloud Shell 中工作或在本地安装 Azure CLI 时，默认输出会自动设置为 json。但是，这是需要了解和设置的最重要默认值之一。 输出确定控制台上显示的内容以及写入日志文件的内容。 创建返回密钥、密码和机密的资源时，请始终使用 none 的输出。
```
az config set core.output=none
```
在本教程中，我们不会使用机密。将默认值重新设置为 json，以便可以在本教程中看到每个引用命令的返回输出。
```
az config set core.output=json
```

了解如何使用 az init。

Azure CLI 有一个参考命令，用于指导你配置环境。在控制台中键入 az init，然后按 Enter 键。按照提供的提示进行操作。

az init

az init 的第一个好处是它为你提供了所有当前设置！下面是示例输出：

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:

查找并读取配置文件。

如果你在“信任但验证”思维模式下工作，则需要知道配置文件的存储位置及其包含的内容。配置文件本身位于 $AZURE_CONFIG_DIR/config。 AZURE_CONFIG_DIR 的默认值为 $HOME/.azure（在 Linux 与 macOS 上）和 %USERPROFILE%\.azure（在 Windows 上）。立即查找配置文件并查看其包含的内容。

获取更多详细信息

想要更详细地了解本教程步骤中介绍的某项主题吗？请使用下表中的链接了解详细信息。

主题	了解详细信息
环境	选择正确的 Azure 命令行工具
登录选项	使用 Azure CLI 登录
术语	Azure CLI 术语和支持级别
订阅	使用 Azure CLI 管理订阅
资源组	使用 Azure CLI 管理资源组
配置	配置 Azure CLI
Azure 角色	Azure 角色、Microsoft Entra 角色和经典订阅管理员角色

下一步

了解如何配置环境后，请转到下一步，了解 Bash、PowerShell 和 Cmd 之间的脚本差异。

了解 Bash、PowerShell 和 Cmd 之间的 Azure CLI 语法差异