共用方式為


使用 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 停用資料收集。 若要深入了解,您也可以閱讀我們的隱私權聲明