你当前正在访问 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 所需的配置:

安装最新版本的 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 来禁用数据收集。 还可以阅读我们的 隐私声明 以了解详细信息。