Como desinstalar módulos do Azure PowerShell

Este artigo explica como desinstalar o Azure PowerShell ou removê-lo completamente do seu sistema. Se você decidiu desinstalar completamente o Azure PowerShell e não planeja reinstalá-lo, envie-nos alguns comentários por meio do cmdlet Send-Feedback. Se encontraste um bug, abre uma issue no GitHub.

Desinstale o módulo Az

Se você tem o módulo Az instalado no seu sistema e gostaria de desinstalá-lo, há duas opções. O método que você segue depende de como você instalou o módulo Az. Se você não tiver certeza do seu método de instalação original, siga as etapas MSI para desinstalar primeiro.

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

Se você instalou o módulo Az PowerShell usando o pacote MSI, deverá desinstalar através do sistema Windows em vez do PowerShell.

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

Uma vez nessa tela, você verá do Azure PowerShell na listagem do programa. Este é o aplicativo para desinstalar. Se não vir este programa listado, é porque foi instalado através 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 um prefixo Az.

Importante

Execute o PowerShell com privilégios de administrador se alguma versão do módulo Az PowerShell estiver instalada para todos os utilizadores $env:PSModulePath.

Para desinstalar o módulo Az PowerShell, pode-se usar o cmdlet Uninstall-Module. No entanto, Uninstall-Module apenas desinstala os módulos especificados para o Name parâmetro. Para remover completamente o módulo Az PowerShell, você deve desinstalar cada módulo individualmente.

Observação

A desinstalação pode ser complicada se você tiver mais de uma versão do módulo Az PowerShell instalada. Devido a essa complexidade, oferecemos suporte apenas à desinstalação de todas as versões do módulo Az PowerShell instaladas.

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

Get-InstalledModule -Name Az -AllVersions -OutVariable AzVersions

Você pode usar o exemplo a seguir para gerar uma lista de todos os módulos do Az PowerShell que precisam ser desinstalados, 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, em seguida, 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

Se você tiver o módulo Az instalado em seu sistema e quiser desinstalar o AzureRM, há duas opções. O método que você segue depende de como você instalou o módulo AzureRM. Se você não tiver certeza do seu método de instalação original, siga as etapas MSI para desinstalar primeiro.

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

Se você instalou o módulo AzureRM PowerShell usando o pacote MSI, deverá desinstalar por meio do sistema Windows em vez do PowerShell.

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

Uma vez nesta tela, você verá Azure PowerShell ou Microsoft Azure PowerShell - Mês Ano na listagem do programa. Este é o aplicativo para desinstalar. Caso não veja este programa listado, é porque o instalou através do PowerShellGet e deverá seguir o próximo conjunto de instruções.

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

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

Para usar Uninstall-AzureRM do módulo Az.Accounts, você precisa ter o módulo Az PowerShell instalado. Não há suporte para ter os módulos AzureRM e Az instalados ao mesmo tempo, no entanto, o módulo Az pode ser usado para desinstalar imediatamente o módulo AzureRM. Você pode instalar o módulo Az e ignorar o aviso do módulo AzureRM com o seguinte comando se ainda não tiver o módulo Az instalado:

Install-Module -Name Az -AllowClobber -Scope CurrentUser

Depois que o módulo Az é instalado, o comando a seguir remove todos os módulos AzureRM da sua máquina. Requer privilégios de administrador.

Uninstall-AzureRm