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

使用 Az Predictor 完成智能上下文感知命令

概述

Az Predictor 是一个 PowerShell 模块，可帮助导航 Az PowerShell 模块的 cmdlet 和参数。 在使用 Azure PowerShell 时，它可提供命令完成的智能上下文感知建议。

Az Predictor 使用 PowerShell 7.2 中提供的子系统插件模型。 此更新版本需要 PSReadLine 2.2.2 或更高版本才能显示建议。

要求

Az Predictor 所需的配置：

• PowerShell 7.2 或更高版本
• PSReadline 2.2.2 或更高版本

安装最新版本的 PSReadLine：

Install-Module -Name PSReadline

入门

安装 Az Predictor

安装 Az.Tools.Predictor PowerShell 模块

Install-Module -Name Az.Tools.Predictor

启用 Az Predictor

1. 为当前和将来的 PowerShell 会话启用 Az Predictor。

   Enable-AzPredictor -AllSession
   

2. 设置建议的首选视图。

   启用列表视图：

   Set-PSReadLineOption -PredictionViewStyle ListView
   

   启用内联视图：

   Set-PSReadLineOption -PredictionViewStyle InlineView
   

注意

可以使用 F2 键在视图模式之间切换。

卸载

安装并启用后，Az Predictor 将加载到 PowerShell 配置文件中。 若要卸载 Az.Tools.Predictor 模块：

1. 关闭所有 PowerShell 会话，包括 VS Code。

2. 启动没有配置文件的 PowerShell 会话。

   pwsh -noprofile
   

3. 卸载 Az Predictor

   Uninstall-Module -Name Az.Tools.Predictor -Force
   

4. 关闭 PowerShell

隐私和数据收集

隐私

Az predictor 使用前面的两个 Az cmdlet 提出建议，并忽略不属于 Az PowerShell 模块的任何 cmdlet。 仅将 cmdlet 和参数的名称发送到 API 以获取建议。 参数值将被丢弃。 使用的资源组名称和位置保留在本地，并为方便起见与后续 cmdlet 一起重复使用，但不会发送到 API。 在预览版本中，模块生成并向 API 发送有关用于预测的当前会话的匿名信息。 该信息用于评估建议的质量。

数据收集

Az Predictor 的当前版本收集有关其使用情况的匿名信息，以识别常见问题并改进将来版本的体验。 Az Predictor 不会收集任何私有或个人数据。

例如，使用情况数据有助于识别不准确的建议和问题，如对 PSReadLine 的干扰。 虽然此数据提供的见解非常有用，但我们了解并非人人都愿意发送使用情况数据。 可以使用 Disable-AzDataCollection cmdlet 来禁用数据收集。 还可以阅读我们的隐私声明，了解更多信息。