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

配置 Azure PowerShell 全局设置

Azure PowerShell 支持多种全局设置，例如禁用中断性变更警告消息。 在 Az PowerShell 模块版本 9 之前，没有可用于为 Azure PowerShell 配置全局设置的集中式或精细化方法。

集中式配置

Az PowerShell 模块版本 9 及更高版本包含用于管理 Azure PowerShell 全局设置配置的 cmdlet。 这些 *-AzConfig cmdlet 属于 Az.Accounts PowerShell 模块：

• Get-AzConfig
• Update-AzConfig
• Export-AzConfig
• Import-AzConfig
• Clear-AzConfig

精细设置

可应用仅在特定范围内有效的设置。 Scope 参数的有效值如下：

• Current User。 应用设置时的默认值。
• Process。 设置仅应用于当前 PowerShell 会话。
• Default。 默认值未更改的只读范围。
• Environment。 通过环境变量配置值的只读范围。

除了范围之外，还可将设置应用于所有 Az PowerShell 模块或只应用于单个模块。 使用 AppliesTo 参数，可指定该设置的应用范围。 值 Az 指示设置应用于 Azure PowerShell 中的所有可用模块。

要在 Az.Compute 模块中禁用 cmdlet 的中断性变更警告消息，请将 Update-AzConfig cmdlet 与 DisplayBreakingChangeWarning 和 AppliesTo 参数一起使用，如下例所示。

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute

在此方案中，除 Az.Compute 之外，所有 Az PowerShell 模块中的 cmdlet 的中断性变更警告消息保持活动状态。

默认订阅

默认情况下，当你向 Azure 进行身份验证时，系统将检索你可访问的所有订阅。 除非使用 Connect-AzAccount 指定订阅，否则将使用 Azure 返回的第一个订阅。 此行为可能很危险，例如，如果返回的第一个订阅是生产环境。

要配置默认订阅，可将 Update-AzConfig cmdlet 与 DefaultSubscriptionForLogin 参数结合使用，如下例所示。

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

注意

不要与默认上下文的订阅混淆，DefaultSubscriptionForLogin 配置仅在向 Azure 进行身份验证时生效。

升级通知

Azure PowerShell 版本升级的工具内通知是 Az PowerShell 模块版本 10.3.0 中发布的一项功能。 当新版本的 Azure PowerShell 可用时，交互式 PowerShell 会话中会显示升级通知。

若要确定是否启用了升级通知，请将 cmdlet 与 Get-AzConfigCheckForUpgrade 参数一起使用，如以下示例所示。

Get-AzConfig -CheckForUpgrade

若要为 Azure PowerShell 启用升级通知，请使用具有 CheckForUpgrade 参数的 Update-AzConfig cmdlet 及其 $true 值，如以下示例所示。

Update-AzConfig -CheckForUpgrade $true

若要关闭升级通知，请使用 Update-AzConfig 具有 CheckForUpgrade 参数的 cmdlet 及其 $false 值，如以下示例所示。

Update-AzConfig -CheckForUpgrade $false

Azure 区域标识

Azure 客户可以选择在许多不同的区域中部署资源。 在某些情况下，客户可以通过选择提供相同服务的附近区域来降低成本。 如果某个附近区域被标识，则一条消息会显示要选择用于将来部署的区域。

禁用区域建议消息

以下示例中使用了 Update-AzConfig cmdlet 来禁用区域建议消息：

Update-AzConfig -DisplayRegionIdentified $false

有关 Azure 区域的详细信息，请参阅选择适合你的 Azure 区域。

复制设置

要将设置从一个环境复制到另一个环境，可使用 Export-AzConfig cmdlet 将设置导出到 JSON 文件。

Export-AzConfig -Path $HOME\AzConfig.json

要导入设置，可使用 Import-AzConfig cmdlet 并引用之前导出的 JSON 文件。

Import-AzConfig -Path $HOME\AzConfig.json

清除配置

要将一个或多个 Azure PowerShell 全局设置的配置设置重置为默认值，可使用 Clear-AzConfig cmdlet。 在以下示例中，已清除 DefaultSubscriptionForLogin 设置。

Clear-AzConfig -DefaultSubscriptionForLogin