你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure PowerShell 提供各种全局设置，例如禁用中断性变更警告消息的选项。 在 Az PowerShell 模块版本 9 之前，没有集中或详细的方法来配置这些全局设置。
集中配置
Az PowerShell 模块版本 9 及更高版本包括用于管理 Azure PowerShell 全局设置配置的 cmdlet。 这些 *-AzConfig cmdlet 是 Az.Accounts PowerShell 模块的一部分：
精细设置
可以应用在特定范围内有效的设置。 Scope 参数的有效值为：
-
Current User：应用设置时的默认范围。 -
Process：此设置仅适用于当前 PowerShell 会话。 -
Default：默认值未更改的只读范围。 -
Environment：通过环境变量配置值的只读范围。
除了范围，还可以将设置应用于所有 Az PowerShell 模块或仅一个模块。
使用 AppliesTo 参数，可以指定要应用设置的广程度。 该值 Az 指示该设置应用于属于 Azure PowerShell 的所有模块。
配置选项
可以使用 cmdlet 设置 *-AzConfig 许多配置选项。 本部分显示了其中许多配置选项。 运行以下命令，查看可以使用 cmdlet 设置 *-AzConfig 的 Azure PowerShell 配置选项的完整列表。
Get-AzConfig | Format-List
升级通知
Azure PowerShell 版本升级的工具内通知是在 Az PowerShell 模块版本 10.3.0 中发布的一项功能。 当 Azure PowerShell 的新版本可用时，升级通知会显示在交互式 PowerShell 会话中。
若要确定是否启用了升级通知，请将 cmdlet 与 Get-AzConfig 参数一起使用，如以下示例所示。
Get-AzConfig -CheckForUpgrade
若要为 Azure PowerShell 启用升级通知，请使用 Update-AzConfig 具有 CheckForUpgrade 参数的 cmdlet 及其 $true 值，如以下示例所示。
Update-AzConfig -CheckForUpgrade $true
若要关闭升级通知，请使用 Update-AzConfig 具有 CheckForUpgrade 参数的 cmdlet 及其 $false 值，如以下示例所示。
Update-AzConfig -CheckForUpgrade $false
默认订阅
默认情况下，从 Az PowerShell 模块版本 12.0.0 开始，如果有权访问多个订阅，系统会提示你选择要登录的 Azure 订阅。
若要防止每次以交互方式登录时提示选择订阅，请使用Update-AzConfig带 DefaultSubscriptionForLogin 参数的 cmdlet 来设置默认订阅，如以下示例所示。
Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>
注释
不要与 默认上下文的订阅混淆， DefaultSubscriptionForLogin 配置仅在向 Azure 进行身份验证时才生效。
实例发现
禁用实例发现设置适用于无法访问元数据终结点的情况，例如在私有云或 Azure Stack 环境中。 实例发现涉及从中 https://login.microsoft.com/ 检索颁发机构元数据来验证颁发机构。 通过启用此设置（将其设置为）， true可以禁用实例发现和颁发机构验证。 因此，必须确保配置的颁发机构主机有效且可信。
若要禁用实例发现和颁发机构验证，请启用此设置（将其设置为 true）。
Update-AzConfig -DisableInstanceDiscovery $true
中断性变更警告消息
若要为所有 Az 模块中的 cmdlet 禁用中断性变更警告消息，请将 Update-AzConfig cmdlet 与参数一起使用 DisplayBreakingChangeWarning ，如以下示例所示：
Update-AzConfig -DisplayBreakingChangeWarning $false
若要为 Az.Compute 模块中的 cmdlet 专门禁用中断性变更警告消息，请将 cmdlet 与 Update-AzConfig 和 AppliesTo 参数结合使用，如以下示例所示：
Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute
在此方案中，除 Az.Compute 之外的所有 Az PowerShell 模块中 cmdlet 的中断性变更警告消息仍然处于活动状态。
Azure 区域标识
Azure 客户可以选择在多个不同的区域中部署资源。 有时，客户可以通过选择提供相同服务的附近区域来降低成本。 如果确定附近的区域，则会显示一条消息，显示要为将来的部署选择的区域。
若要禁用区域建议消息，请将 cmdlet 与 Update-AzConfig 参数一起使用，如以下示例所示。
Update-AzConfig -DisplayRegionIdentified $false
有关 Azure 区域的详细信息，请参阅 “为你选择正确的 Azure 区域”。
显示机密警告
默认情况下，Azure PowerShell 显示警告消息，从版本 12.0.0 开始，以帮助在命令输出中标识潜在机密时保护敏感信息。
在以下示例中， Update-AzConfig cmdlet 用于禁用警告消息。
Update-AzConfig -DisplaySecretsWarning $false
调查
使用 Azure PowerShell 时，可能会邀请你参与调查，告诉我们你的体验。 虽然我们赞赏此数据提供的见解，但我们并不明白并不是每个人都希望被提示完成调查。
可以禁用提示使用 Update-AzConfig cmdlet 参与调查，如以下示例所示。
Update-AzConfig -DisplaySurveyMessage $false
数据收集
默认情况下，Azure PowerShell cmdlet 将遥测数据发送到Microsoft以提高客户体验。 有关详细信息，请参阅我们的隐私声明： aka.ms/privacy。
Update-AzConfig -EnableDataCollection $false
错误记录
默认情况下，Azure PowerShell 错误记录将写入 $HOME/.Azure/ErrorRecords到其中。
若要禁用永久性错误记录，请使用Update-AzConfig带 EnableErrorRecordsPersistence 参数的 cmdlet，如以下示例所示。
Update-AzConfig -EnableErrorRecordsPersistence $false
Web 帐户管理器 (WAM)
从 Az PowerShell 模块版本 12.0.0 开始，Windows 系统默认使用 Web 帐户管理器（WAM），Linux 和 macOS 系统默认使用基于浏览器的登录。
若要在 Windows 10 及更高版本或 Windows Server 2019 及更高版本上使用基于浏览器的登录以及 Az 12.0.0 及更高版本，必须禁用 WAM 才能用于 Azure PowerShell。 使用以下命令禁用 WAM 并返回到基于浏览器的登录，这是 Az 12.0.0 之前的默认值。
Update-AzConfig -EnableLoginByWam $false
新的登录体验
从 Az PowerShell 模块版本 12.0.0 开始，如果有权访问多个订阅，系统会提示你选择要登录的 Azure 订阅。
如果禁用了新的登录体验，并且你有权访问多个订阅，则登录到第一个订阅 Azure 将返回，除非你指定了 Connect-AzAccount订阅。 默认情况下，命令将针对此订阅运行。 此行为可能很危险，例如，如果返回的第一个订阅是生产环境。
若要禁用新的登录体验，请使用 Update-AzConfig cmdlet，如以下示例所示。
Update-AzConfig -LoginExperienceV2 Off
复制设置
若要将设置从一个环境复制到另一个环境，请使用 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
