共用方式為

在 Windows 上安裝 Azure PowerShell

  • 發行項

Az PowerShell 模組為彙總模組。 安裝此 Az PowerShell 模組會下載所有正式推出的模組，並使其 Cmdlet 可供使用。

Az PowerShell 模組的建議安裝方法和 PowerShell 版本：

  • 從 PowerShell 資源庫安裝
  • 搭配 PowerShell 第 7 版或更高版本使用

本文說明如何在 Windows 上從 PowerShell 資源庫安裝 Az PowerShell 模組。

必要條件

  • 從 PowerShell 中執行下列命令，以確定您的 PowerShell 版本：

    $PSVersionTable.PSVersion

  • 判斷您是否已安裝 AzureRM PowerShell 模組：

    Get-Module -Name AzureRM -ListAvailable

    重要

    如果您已安裝 AzureRM PowerShell 模組，請先參閱 Az 和 AzureRM 共存，再繼續進行。

  • 將 PowerShell 執行原則設定為遠端簽署或較少限制

    • 檢查 PowerShell 執行原則：

      Get-ExecutionPolicy -List

    • 將 PowerShell 執行原則設定為遠端簽署：

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    如需執行原則的詳細資訊，請參閱 about_Execution_Policies。

安裝

請使用 Install-Module Cmdlet 來安裝 Az PowerShell 模組：

Install-Module -Name Az -Repository PSGallery -Force

更新 Az PowerShell 模組

使用 Update-Module 更新至最新版的 Az PowerShell 模組：

Update-Module -Name Az -Force

使用 Update-Module 更新 Az PowerShell 模組並不會移除系統中舊版的 Az PowerShell 模組。

解除安裝

若要移除 Az PowerShell 模組，請參閱解除安裝 Azure PowerShell 模組。

本文說明如何使用 MSI 安裝程式，在 Windows 上安裝 Az PowerShell 模組。 MSI 安裝程式是針對 PowerShell 資源庫可能受防火牆封鎖，或需要離線安裝程式的環境所提供。

重要

MSI 安裝選項只能用來安裝 Az PowerShell 模組，以搭配 Windows PowerShell 5.1 使用。

必要條件

  • 從 PowerShell 中執行下列命令，以確定您的 PowerShell 版本：

    $PSVersionTable.PSVersion

  • 判斷您是否已安裝 AzureRM PowerShell 模組

    Get-Module -Name AzureRM -ListAvailable

    重要

    如果您已安裝 AzureRM PowerShell 模組，請先參閱 Az 和 AzureRM 共存，再繼續進行。

  • 更新至 Windows PowerShell 5.1

  • 安裝 .NET Framework 4.7.2 或更新版本

  • 將 PowerShell 指令碼執行設定為遠端簽署或較少限制

    • 檢查 PowerShell 執行原則：

      Get-ExecutionPolicy -List

    • 將 PowerShell 執行原則設定為遠端簽署：

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    如需執行原則的詳細資訊，請參閱 about_Execution_Policies。

安裝和更新

可從 GitHub 取得 Azure PowerShell 的 MSI 套件：

  1. 造訪 github.com/Azure/azure-powershell/releases
  2. 找出最新的 Az PowerShell 模組。 它們依時間順序列出，沒有名稱。 例如，9.5.0
  3. 向下捲動至修補程式附註的尾端，然後按一下 [資產] 旁的箭號，以顯示 MSI 選項。
  4. 按一下您選擇的 Az Cmdlet MSI 以開始下載

安裝程式會自動移除已使用 MSI 安裝的舊版 Az PowerShell 模組。 MSI 套件會在 "${env:ProgramFiles}\WindowsPowerShell\Modules" 中安裝模組

登入

若要開始使用 Az PowerShell 模組管理 Azure 資源，請啟動 PowerShell 工作階段並執行 Connect-AzAccount 以登入 Azure：

Connect-AzAccount

使用您的 Azure 帳戶登入認證來登入隨即開啟的瀏覽器視窗。

您必須針對每個啟動的新 PowerShell 工作階段重複此步驟。 若要了解如何在整個 PowerShell 工作階段保持您的 Azure 登入，請參閱 Azure PowerShell 內容物件。

疑難排解

如需 Az PowerShell 模組常見安裝問題的解決方案，請參閱針對 Az PowerShell 模組的安裝問題進行疑難排解。

提供意見反應

若要提出 Az PowerShell 模組的相關問題，請參閱：在 GitHub 上提出問題

若要在 PowerShell 工作階段中提供意見反應，請使用 Send-Feedback Cmdlet。

後續步驟

若要深入了解如何使用 Az PowerShell 模組管理 Azure 資源，請參閱 [Azure PowerShell 入門]。