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 você encontrou um bug, registre um problema no GitHub.

Desinstalar o módulo Az

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

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

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

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

Uma vez nesta tela, você deverá ver do Azure PowerShell na listagem do programa. Este é o aplicativo a ser desinstalado. Se você não vir esse programa listado, você será instalado por meio do PowerShellGet e deverá seguir as instruções descritas na opção 2.

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

Quando o módulo do 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 elevados como administrador se qualquer versão do módulo do Az PowerShell estiver instalada em todos os usuários $env:PSModulePath.

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

Nota

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

Primeiro, você precisará de uma lista de todas as versões do módulo do Az PowerShell instaladas em 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 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 do Az PowerShell.

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

Desinstalar o módulo do AzureRM

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

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

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

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

Uma vez nesta tela, você deverá ver Azure PowerShell ou Microsoft Azure PowerShell – Mês Ano na listagem do programa. Este é o aplicativo a ser desinstalado. Se você não vir esse programa listado, então ele foi instalado através do PowerShellGet e você deverá seguir o próximo conjunto de instruções.

Opção 2: desinstalar o módulo do 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 do Az PowerShell instalado. Não há suporte para o AzureRM e os módulos do Az instalados ao mesmo tempo, no entanto, o módulo Az pode ser usado para desinstalar imediatamente o módulo do 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 do seu computador. Ele requer privilégios de administrador.

Uninstall-AzureRm