你当前正在访问 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