Como desinstalar os módulos do Azure PowerShell

Este artigo explica como desinstalar o Azure PowerShell ou removê-lo completamente do sistema. Se você decidiu desinstalar o Azure PowerShell completamente e não planeja reinstalá-lo, envie comentários por meio do cmdlet Send-Feedback. Se você encontrou um bug, registre um problema no GitHub.

Desinstalar o módulo Az

Caso você tenha instalado o módulo Az no seu sistema e queira desinstalá-lo, há duas opções. Qual método você segue depende de como instalou o módulo Az. Caso não tenha certeza do método de instalação original, siga as etapas do MSI para fazer a desinstalação primeiro.

Opção 1: Desinstalar o módulo Az PowerShell do MSI

Se você tiver instalado o módulo Az PowerShell usando o pacote MSI, desinstale-o por meio do sistema do Windows, em vez de por meio do PowerShell.

Plataforma	Instruções
Windows 10	Iniciar > Configurações > Aplicativos
Windows 7 Windows 8	Iniciar > Painel de Controle > Programas > Desinstalar um programa

Nessa tela, você deverá ver Azure PowerShell na lista de programas. Esse é o aplicativo a ser desinstalado. Caso você não encontre esse programa na lista, então o instalou por meio do PowerShellGet e deve seguir as instruções descritas na opção 2.

Opção 2: Desinstalar o módulo Az PowerShell do PowerShellGet

Quando o módulo Az PowerShell é instalado, ele instala vários módulos do PowerShell para diferentes serviços do Azure. Todos os módulos começam com o prefixo Az.

Importante

Execute o PowerShell elevado como administrador se alguma versão do módulo Az PowerShell está instalada no $env:PSModulePath de todos os usuários.

Para desinstalar o módulo Az PowerShell, use o cmdlet Uninstall-Module. No entanto, o Uninstall-Module apenas desinstala os módulos especificados para o parâmetro Name. Para remover completamente o módulo Az PowerShell, desinstale cada módulo individualmente.

Observação

Pode ser complicado fazer a desinstalação se você tem mais de uma versão do módulo Az PowerShell instalada. Por causa dessa complexidade, só permitimos a desinstalação de todas as versões do módulo Az PowerShell que estão instaladas.

Em primeiro lugar, você precisará de uma lista de todas as versões do módulo Az PowerShell instaladas no sistema.

Get-InstalledModule -Name Az -AllVersions -OutVariable AzVersions

Você pode usar o exemplo a seguir para gerar uma lista de todos os módulos Az PowerShell que precisa desinstalar além do módulo Az.

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

Remova os módulos Az da memória e, depois, desinstale-os.

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

A etapa final é remover o módulo Az PowerShell.

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

Desinstalar o módulo AzureRM

Caso você tenha instalado o módulo Az no seu sistema e queira desinstalar o AzureRM, há duas opções. Qual método você segue depende de como instalou o módulo AzureRM. Caso não tenha certeza do método de instalação original, siga as etapas do MSI para fazer a desinstalação primeiro.

Opção 1: Desinstalar o módulo AzureRM PowerShell do MSI

Se você tiver instalado o módulo AzureRM PowerShell usando o pacote MSI, desinstale-o por meio do sistema do Windows, em vez de por meio do PowerShell.

Plataforma	Instruções
Windows 10	Iniciar > Configurações > Aplicativos
Windows 7 Windows 8	Iniciar > Painel de Controle > Programas > Desinstalar um programa

Nessa tela, você deverá ver o Azure PowerShell ou o Microsoft Azure PowerShell – mês e ano na lista de programas. Esse é o aplicativo a ser desinstalado. Se você não vir esse programa listado, então instalou por meio do PowerShellGet e deve seguir as próximas instruções.

Opção 2: Desinstalar o módulo AzureRM PowerShell do PowerShellGet

Se você instalou o AzureRM com o PowerShellGet, pode remover os módulos com o cmdlet Uninstall-AzureRM, disponível como parte do módulo Az.Accounts.

Para usar o Uninstall-AzureRM do módulo Az.Accounts, você precisa ter o módulo Az PowerShell instalado. Não é permitido ter os módulos AzureRM e Az instalados ao mesmo tempo. No entanto, você pode usar o módulo Az para desinstalar o módulo AzureRM imediatamente. Você pode instalar o módulo Az e ignorar o aviso do módulo AzureRM com o seguinte comando caso ainda não tenha o módulo Az instalado:

Install-Module -Name Az -AllowClobber -Scope CurrentUser

Depois que o módulo Az estiver instalado, o comando a seguir removerá todos os módulos AzureRM do seu computador. Ele requer privilégios de administrador.

Uninstall-AzureRm