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 do Az

Se tiver o módulo Az instalado no seu sistema e quiser desinstalá-lo, existem duas opções. O método utilizado depende da forma como instalou o módulo Az. Se não tiver a certeza do método de instalação original, siga os passos do MSI para primeiro desinstalar.

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

Se instalou o módulo do Az PowerShell através do pacote de MSI, tem de fazer a desinstalação através do sistema Windows e não através do PowerShell.

Plataforma	Instruções
Windows 10	Iniciar > Aplicações de Definições >
Windows 7 , Windows 8	Iniciar > programas > do painel > de controle Desinstalar um programa

Quando estiver neste ecrã, verá Azure PowerShell na lista de programas. Esta é a aplicação a desinstalar. Se não vir este programa listado, então instalou 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 elevado como administrador se qualquer versão do módulo Az PowerShell estiver instalada em todos os usuários $env:PSModulePath.

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

Nota

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 do AzureRM

Se tiver o módulo do Az instalado no seu sistema e quiser desinstalar o AzureRM, existem duas opções. O método utilizado depende da forma como instalou o módulo AzureRM. Se não tiver a certeza do método de instalação original, siga os passos do MSI para primeiro desinstalar.

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

Se instalou o módulo do AzureRM PowerShell através do pacote de MSI, tem de fazer a desinstalação através do sistema Windows e não através do PowerShell.

Plataforma	Instruções
Windows 10	Iniciar > Aplicações de Definições >
Windows 7 , Windows 8	Iniciar > programas > do painel > de controle Desinstalar um programa

Quando estiver neste ecrã, verá Azure PowerShell ou Microsoft Azure PowerShell - Month Year na lista de programas. Esta é a aplicação a desinstalar. Se não vir este programa na lista, instalou através de PowerShellGet e deve seguir o conjunto seguinte de instruções.

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

Se 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 Uninstall-AzureRM a partir do Az.Accounts módulo, 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

Quando o módulo AZ estiver instalado, o comando seguinte remove todos os módulos AzureRM do seu computador. Requer privilégios de administrador.

Uninstall-AzureRm