安裝 Azure Az PowerShell 模組

本文說明如何使用 PowerShellGet安裝 Azure Az PowerShell 模組。 這些指示可Windows macOS 和 Linux 平臺。

Azure Az PowerShell 模組預先安裝于 Azure Cloud ShellDocker 影像中

Azure Az PowerShell 模組是匯總模組。 安裝程式會下載一般可用的 Az PowerShell 模組,並讓他們的 Cmdlet 可供使用。

要求

注意

PowerShell 7.0.6 LTS、PowerShell 7.1.3 或更新版本是 PowerShell 的建議版本,適用于所有平臺上的 Azure Az PowerShell 模組。

Azure PowerShell在 PowerShell 7.0.6 LTS 和 PowerShell 7.1.3 或更高版本上執行時,沒有額外的需求。

若要檢查 PowerShell 版本,請在 PowerShell 會話內執行下列命令:

$PSVersionTable.PSVersion

PowerShell 腳本執行策略必須設定為遠端簽署或限制較嚴格。 Get-ExecutionPolicy -List 可用來判斷目前的執行策略。 詳細資訊,請參閱about_Execution_Policies。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

安裝

使用 Install-Module Cmdlet 是 Az PowerShell 模組的偏好安裝方法。 僅針對目前使用者安裝 Az 模組。 這是建議的安裝範圍。 這個方法在 Windows macOS 和 Linux 平臺上也一樣。 從 PowerShell 會話執行下列命令:

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

其他安裝選項

雖然 PowerShell 7.0.6 LTS、PowerShell 7.1.3 或更新版本是建議的 PowerShell 版本,也是建議的安裝選項,但如果需要,有其他安裝 Install-Module 選項。

在 Windows PowerShell

重要

如果您已安裝 AzureRM PowerShell 模組,請參閱本文的 Az 和 AzureRM 共存 一節,然後再繼續進行。

Azure Az PowerShell 模組也支援與 PowerShell 5.1 一Windows。 若要使用 PowerShell 5.1 中的 Azure Az PowerShell 模組,請Windows:

  1. 更新至Windows PowerShell 5.1。 如果您是使用 1607 Windows 10版本,表示您已安裝 PowerShell 5.1。
  2. 安裝.NET Framework 4.7.2 或更新版
  3. 請確定您擁有最新版本的 PowerShellGet。 執行 Install-Module -Name PowerShellGet -Force

離線安裝

在某些環境中,無法連接到 PowerShell 圖庫。 在這些情況下,您可以使用以下其中一種方法離線安裝 Az PowerShell 模組:

  • 下載 Azure PowerShell MSI。 請記住,MSI 安裝程式僅適用于 PowerShell 5.1 Windows。
  • 將模組下載到您網路的另一個位置,並使用它做為安裝來源。 此方法可讓您在單一伺服器或檔案共用上,將 PowerShellGet 部署的 PowerShell 模組緩存至任何中斷連接的系統。 瞭解如何使用使用本地 PowerShellGet存放庫來設定本地存放庫,以及如何在中斷連接的系統上安裝。
  • 使用儲存 模組 將模組儲存到檔案共用,或將其儲存到另一個來源,然後手動複製到其他電腦。

登錄

若要開始使用 Azure PowerShell,請以 Azure 認證來登錄。

Connect-AzAccount

執行此命令之後,新的瀏覽器視窗會彈出,您可以登入您的 Azure 帳戶。

更新 Azure PowerShell模組

若要更新任何 PowerShell 模組,您應該使用與安裝模組相同的方法。 例如,如果您原本是使用 Install-Module ,您應該使用 Update-Module 取得最新版本。 如果您原本是使用 MSI 套件,您應該下載並安裝新的 MSI 套件。

PowerShellGet Cmdlet 無法更新從 MSI 套件安裝的模組。 MSI 套件不會更新使用 PowerShellGet 安裝的模組。 如果您使用 PowerShellGet 進行更新時有任何問題,您應該 重新安裝,而不是 更新。 重新安裝的方式與安裝相同。 請確定在 Force 重新安裝時 Install-Module 使用該參數。

與 MSI 型安裝不同,使用 PowerShellGet 安裝或更新不會移除您系統上可能有的舊版。

注意

如果您已安裝多個版本的 Az PowerShell 模組,卸載可能會很複雜。 由於這個複雜度,我們僅支援卸載目前安裝的 Az PowerShell 模組的所有版本。

若要從系統移除所有版本的 Az PowerShell 模組,請參閱卸載 Azure PowerShell模組。 有關 MSI 型安裝詳細資訊,請參閱使用 MSI Azure PowerShell安裝。

故障 排除

以下是安裝 Azure Az PowerShell 模組時看到的一些常見問題。 如果您遇到此處未列出的問題,請于 GitHub中GitHub。

Az 和 AzureRM 共存

警告

我們不支援同時安裝 PowerShell 5.1 的 AzureRM 和 Az 模組Windows安裝。

在您想要同時在同一個系統上安裝 AzureRM 和 Az PowerShell 模組的情況下,AzureRM 必須安裝在使用者範圍內才能Windows PowerShell。 在同一個系統安裝 PowerShell 7.0.6 LTS、PowerShell 7.1.3 或更高版本的 Az PowerShell 模組。

重要

由於 Az PowerShell 模組現在擁有 AzureRM PowerShell 模組等所有功能,因此我們將在 2024 年 2 月 29 日淘汰 AzureRM PowerShell 模組。

若要避免服務中斷, 請更新 使用 AzureRM PowerShell 模組的腳本,在 2024 年 2 月 29 日之前使用 Az PowerShell 模組。 若要自動更新腳本,請遵循 快速入門手冊

Visual Studio

舊版的用戶端Visual Studio安裝Azure PowerShell Azure 開發工作負載的一部分,而 Azure 開發工作負載會安裝 AzureRM 模組。 Azure PowerShell安裝程式移除Visual Studio,或在應用程式或功能中使用「卸載」&移除。 如果您已經安裝 PowerShell 7.x,您可能需要手動安裝Azure Az PowerShell 模組。

Proxy 會阻止連接

如果您收到 PowerShell 圖庫無法達及的錯誤, Install-Module 表示您可能在 Proxy 後面。 不同的作業系統和網路環境對於配置系統範圍的 Proxy 有不同的需求。 如需 Proxy 設定,以及如何針對您的環境設定,請與您的系統管理員聯繫。

PowerShell 本身可能未配置為自動使用此 Proxy。 使用 PowerShell 5.1 及更高版本,將 PowerShell 會話設定為使用 Proxy 使用下列命令:

$webClient = New-Object -TypeName System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

如果您的作業系統認證已正確配置,此組式會透過 Proxy 路由 PowerShell 要求。 若要讓此設定在會話之間保留,請新增命令至 您的 PowerShell 設定檔

若要安裝套件,您的 Proxy 必須允許 HTTPS www.powershellgallery.com。

提供意見回饋

如果您在 Azure Az PowerShell 模組中發現錯誤,請GitHub。 若要在 PowerShell 會話內提供意見回饋,請使用 Send-Feedback Cmdlet。

下一個步驟

若要深入瞭解 Azure Az PowerShell 模組及其功能,請參閱使用 入門Azure PowerShell。 如果您熟悉此Azure PowerShell需要從 AzureRM 進行遷移,請參閱從 AzureRM 遷移到Az