安裝 Azure Az PowerShell 模組

  • 發行項

本文說明如何從The PowerShell 資源庫安裝 Azure Az PowerShell 模組。 這些指示適用于 Windows、Linux 和 macOS 平臺。

Azure Az PowerShell 模組會預先安裝在 Azure Cloud Shell 和 Docker 映像中。

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

規格需求

注意

若要搭配所有平台上的 Azure Az PowerShell 模組使用，建議的 PowerShell 版本是 PowerShell 7.0.6 LTS、PowerShell 7.1.3 或更新版本。

在 PowerShell 7.0.6 LTS、PowerShell 7.1.3 或更新版本時，Azure PowerShell 沒有額外的需求。

若要判斷 PowerShell 版本，請從 PowerShell 會話內執行下列命令：

$PSVersionTable.PSVersion

PowerShell 指令碼執行原則必須設定為遠端已簽署或較不嚴格的原則。 Get-ExecutionPolicy -List 可用於判斷目前的執行原則。 如需詳細資訊，請參閱 about_Execution_Policies。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

安裝

使用 Install-Module Cmdlet 是 Az PowerShell 模組慣用的安裝方法。 僅安裝適用於目前使用者的 Az 模組。 這是建議的安裝範圍。 此方法在 Windows、Linux 和 macOS 平臺上的運作方式相同。 從 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 共存， 再繼續進行。

在 Windows 上，也支援 Azure Az PowerShell 模組與 PowerShell 5.1 搭配使用。 若要在 Windows 的 PowerShell 5.1 中使用 Azure PowerShell 模組：

  1. 更新至 Windows PowerShell 5.1。 如果您是在 Windows 10 版本 1607 或更高版本上，則已安裝 PowerShell 5.1。
  2. 安裝 .NET Framework 4.7.2 或更新版本。
  3. 確定您有最新版的 PowerShellGet。 執行 Install-Module -Name PowerShellGet -Force。

離線安裝

在某些環境中，無法連線到 PowerShell 資源庫。 在這些情況下，您仍然可以使用下列其中一種方法，以離線方式安裝 Az PowerShell 模組：

  • 下載 Azure PowerShell MSI。 請記住，MSI 安裝程式僅適用於 Windows 上的 PowerShell 5.1。
  • 將模組下載到您網路中的另一個位置，並使用該位置做為安裝來源。 此方法可讓您將單一伺服器或檔案共用上的 PowerShell 模組 (已使用 PowerShellGet 部署) 快取到任何已中斷連線的系統上。 了解如何透過使用本機 PowerShellGet 存放庫設定本機存放庫，並安裝在中斷連線的系統上。
  • 使用 Save-Module 將模組儲存至檔案共用，或將儲存至另一個來源，並手動將模組複製到其他電腦。

登入

若要開始使用 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 模組的安裝問題進行疑難排解。

提供意見反應

如果您發現 Azure PowerShell 模組發生錯誤 (bug)，請在 GitHub 上提出問題。 若要在 PowerShell 工作階段中提供意見反應，請使用 Send-Feedback Cmdlet。

後續步驟

若要深入了解 Azure Az PowerShell 模組和其功能，請參閱開始使用 Azure PowerShell。 如果您熟悉 Azure PowerShell 且需要從 AzureRM 遷移，請參閱從 AzureRM 遷移至 Az。