你当前正在访问 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 PowerShellMicrosoft Azure PowerShell - 计划列表中的月份年 。 这是要卸载的应用。 如果未列出此程序,请通过 PowerShellGet 安装,并应按照下一组说明进行作。

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

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

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

Install-Module -Name Az -AllowClobber -Scope CurrentUser

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

Uninstall-AzureRm