Edit

Intelligent context-aware command completion with Az Predictor

  • Article

Overview

Az Predictor is a PowerShell module that helps you navigate the cmdlets and parameters of the Az PowerShell module. It provides intelligent context-aware suggestions for command completion when using Azure PowerShell.

Az Predictor uses the subsystem plugin model available in PowerShell 7.2. This updated version requires PSReadLine 2.2.2 or higher to display suggestions.

Requirements

Required configuration for Az Predictor:

Install the latest version of PSReadLine:

Install-Module -Name PSReadline

Getting started

Install Az Predictor

Install the Az.Tools.Predictor PowerShell module

Install-Module -Name Az.Tools.Predictor

Enable Az Predictor

  1. Enable Az Predictor for the current and future PowerShell sessions.

    Enable-AzPredictor -AllSession

  2. Set your preferred view for suggestions.

    Enable list view:

    Set-PSReadLineOption -PredictionViewStyle ListView

    Enable inline view:

    Set-PSReadLineOption -PredictionViewStyle InlineView

Note

You can switch between view modes with the F2 key.

Uninstallation

Once installed and enabled, Az Predictor is loaded in the PowerShell profile. To uninstall the Az.Tools.Predictor module:

  1. Close all PowerShell sessions including VS Code.

  2. Launch a PowerShell session with no profile.

    pwsh -noprofile

  3. Uninstall Az Predictor

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

  4. Close PowerShell

Privacy and data collection

Privacy

Az predictor uses the previous two Az cmdlets to make suggestions and ignores any cmdlet that's not part of the Az PowerShell module. Only the names of cmdlets and parameters are sent to our API to obtain the suggestion. Parameter values are discarded. The resource group name and location used are kept locally and reused with subsequent cmdlets for convenience but are never sent to the API. In the preview version, the module generates and sends anonymized information about the current session used for predictions to the API. This information is used to assess the quality of suggestions.

Data collection

The current version of Az Predictor collects anonymized information about its usage to identify common issues and improve the experience of future releases. Az Predictor doesn't collect any private or personal data.

For example, the usage data helps identify inaccurate suggestions and issues like interferences with PSReadLine. While we appreciate the insights this data provides, we understand not everyone wants to send usage data. You can disable data collection with the Disable-AzDataCollection cmdlet. You can also read our privacy statement to learn more.