安裝 Azure PowerShell 服務管理模組

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。

Azure PowerShell 服務管理模組是匯總模組。 安裝 Azure PowerShell 服務管理模組會下載一般可用的模組來管理使用服務管理 API 的舊版 Azure 資源，並讓其 Cmdlet 可供使用。

必要條件

重要

Azure PowerShell 服務管理模組僅適用於 Windows PowerShell。 它與 PowerShell 第 6 版或更新版本不相容，而且不會在 Linux 或 macOS 上執行。

• 從 PowerShell 執行下列命令，以判斷您的 PowerShell 版本：

  $PSVersionTable.PSVersion
  

• 更新至 Windows PowerShell 5.1

• 將 PowerShell 執行原則設定為遠端簽署或較不嚴格

  • 檢查 PowerShell 執行原則：

    Get-ExecutionPolicy -List
    

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

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
    

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

• 更新適用於 Windows PowerShell 5.1 的 PowerShellGet

安裝

使用 Install-Module Cmdlet 來安裝 Azure PowerShell 服務管理模組：

Install-Module -Name Azure, Azure.Storage -Repository PSGallery -AllowClobber -Force

Azure PowerShell 服務管理模組會與 Azure PowerShell Resource Manager 模組共用相依性。 如果您已安裝 Azure PowerShell Resource Manager 模組， 則需要如上一個命令所示的 AllowClobber 參數。 這可讓現有的共用相依性更新。 如果沒有此參數，模組的安裝就會失敗。

安裝 Azure PowerShell 服務管理模組之後，請匯入模組：

Import-Module -Name Azure

登入

若要使用 Azure PowerShell 服務管理模組開始管理舊版 Azure 資源，請啟動 PowerShell 會話並執行 Add-AzureAccount 以登入 Azure：

Add-AzureAccount

登入 Azure 之後，Azure PowerShell 服務管理模組會為指定的會話建立內容。 該內容包含用於該會話內所有 Cmdlet 的 Azure 環境、帳戶、租用戶和訂用帳戶。

疑難排解

如果您收到「未載入版本為 『4.3.0』 的指定模組 'Azure.Storage'，因為任何模組目錄中找不到有效的模組檔案」錯誤，您需要安裝 Azure.Storage PowerShell 模組：

Install-Module -Name Azure.Storage -Repository PSGallery -AllowClobber -Force

如果您在模組 'PowerShellGet' 中找到 'Install-Module' 命令錯誤 ，但無法載入模組。」，您必須將 PowerShell 執行原則設定為遠端簽署或較不嚴格：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

另請參閱

如需 Azure PowerShell 服務管理模組中命令的詳細資訊，請參閱 Cmdlet 參考檔。