你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

如何卸载 Azure PowerShell 模块

本文介绍如何卸载 Azure PowerShell 或将其从系统中完全删除。 如果你决定彻底卸载 Azure PowerShell,而且未计划重新安装它,那么请通过 Send-Feedback cmdlet 为我们提供一些反馈。 如果遇到 bug,请提出 GitHub 问题

卸载 Az 模块

如果已在系统上安装了 Az 模块并且希望卸载它,有两种选择。 采用哪种方法取决于你安装 Az 模块的方式。 如果无法确定原始安装方法,请先按 MSI 卸载步骤操作。

选项 1:从 MSI 卸载 Az PowerShell 模块

若是使用 MSI 包安装的 Az PowerShell 模块,则必须通过 Windows 系统而不是 PowerShell 进行卸载。

平台 说明
Windows 10 “开始”>“设置”>“应用”
Windows 7
Windows 8
“开始”>“控制面板”>“程序”>“卸载程序”

转到此屏幕后,会在程序列表中看到 Azure PowerShell。 这是要卸载的应用。 如果没看到列出此程序,则表示你是通过 PowerShellGet 安装的,应按照选项 2 中的说明操作。

选项 2:从 PowerShellGet 卸载 Az PowerShell 模块

Az PowerShell 模块安装后,将为不同的 Azure 服务安装许多 PowerShell 模块。 所有模块的前缀都是 Az。

重要

如果所有用户 $env:PSModulePath 中都安装了 Az PowerShell 模块的任一版本,那么以提升为管理员的身份运行 PowerShell。

若要卸载 Az PowerShell 模块,可使用 Uninstall-Module cmdlet。 不过,Uninstall-Module 仅卸载为 Name 参数指定的模块。 若要彻底删除 Az PowerShell 模块,必须单独卸载每个模块。

注意

如果安装了多个版本的 Az PowerShell 模块,则卸载操作可能很复杂。 由于很复杂,我们仅支持卸载已安装的 Az PowerShell 模块的所有版本。

首先,你需要一个列表,其中列出在你的系统上安装的所有 Az PowerShell 模块版本。

Get-InstalledModule -Name Az -AllVersions -OutVariable AzVersions

可按照以下示例生成一个除 Az 模块外还需卸载的所有 Az PowerShell 模块的列表。

($AzVersions |
  ForEach-Object {
    Import-Clixml -Path (Join-Path -Path $_.InstalledLocation -ChildPath PSGetModuleInfo.xml)
  }).Dependencies.Name | Sort-Object -Descending -Unique -OutVariable AzModules

从内存中删除 Az 模块,然后卸载它们。

$AzModules |
  ForEach-Object {
    Remove-Module -Name $_ -ErrorAction SilentlyContinue
    Write-Output "Attempting to uninstall module: $_"
    Uninstall-Module -Name $_ -AllVersions
  }

最后是删除 Az PowerShell 模块。

Remove-Module -Name Az -ErrorAction SilentlyContinue
Uninstall-Module -Name Az -AllVersions

卸载 AzureRM 模块

如果已在系统上安装了 Az 模块并且希望卸载 AzureRM,有两种选择。 采用哪种方法取决于你安装 AzureRM 模块的方式。 如果无法确定原始安装方法,请先按 MSI 卸载步骤操作。

选项 1:从 MSI 卸载 AzureRM PowerShell 模块

若是使用 MSI 包安装的 AzureRM PowerShell 模块,则必须通过 Windows 系统而不是 PowerShell 进行卸载。

平台 说明
Windows 10 “开始”>“设置”>“应用”
Windows 7
Windows 8
“开始”>“控制面板”>“程序”>“卸载程序”

转到此屏幕后,应会在程序列表中看到“Azure PowerShell”或“Microsoft Azure PowerShell - 年月” 。 这是要卸载的应用。 如果未看到该程序已列出,那么是通过 PowerShellGet 安装的,应按照下一组说明进行操作。

选项 2:从 PowerShellGet 卸载 AzureRM PowerShell 模块

如果使用 PowerShellGet 安装了 AzureRM,则可使用作为 Az.Accounts 模块的一部分提供的 Uninstall-AzureRM cmdlet 删除这些模块。

若要从 Az.Accounts 模块使用 Uninstall-AzureRM,你需要安装 Az PowerShell 模块。 不支持同时安装 AzureRM 模块和 Az 模块;但可使用 Az 模块以立即卸载 AzureRM 模块。 如果尚未安装 Az 模块,可以使用以下命令安装 Az 模块并忽略 AzureRM 模块警告:

Install-Module -Name Az -AllowClobber -Scope CurrentUser

安装了 Az 模块后,可通过以下命令从计算机中删除所有 AzureRM 模块。 需要管理员权限。

Uninstall-AzureRm