Compartilhar via


Instalação do módulo de Gerenciamento de Serviços do Azure PowerShell

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

O módulo de Gerenciamento de Serviços do Azure PowerShell é cumulativo. A instalação do módulo de Gerenciamento de Serviços do Azure PowerShell baixa os módulos com disponibilidade geral para o gerenciamento de recursos herdados do Azure que usam APIs de Gerenciamento de Serviços e disponibiliza os respectivos cmdlets para uso.

Pré-requisitos

Importante

O módulo de Gerenciamento de serviços do Azure PowerShell funciona apenas com o Windows PowerShell. Não é compatível com o PowerShell versão 6 ou posterior e não é executado no Linux nem no macOS.

  • Execute o seguinte comando no PowerShell para determinar a versão do PowerShell:

    $PSVersionTable.PSVersion
    
  • Atualizar para o Windows PowerShell 5.1

  • Definir a política de execução do PowerShell como assinada remotamente ou menos restritiva

    • Veja a política de execução do PowerShell:

      Get-ExecutionPolicy -List
      
    • Defina a política de execução do PowerShell como assinada remotamente:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
      

      Para saber mais sobre as políticas de execução, confira about_Execution_Policies.

  • Atualização de PowerShellGet para Windows PowerShell 5.1

Instalação

Use o cmdlet Install-Module para instalar o módulo de Gerenciamento de Serviços do Azure PowerShell:

Install-Module -Name Azure, Azure.Storage -Repository PSGallery -AllowClobber -Force

O módulo de Gerenciamento de Serviços do Azure PowerShell compartilha dependências com os módulos do Resource Manager do Azure PowerShell. Se você tiver instalado os módulos do Resource Manager do Azure PowerShell, será necessário usar o parâmetro AllowClobber, conforme mostrado no comando anterior. Isso permite a atualização dessas dependências compartilhadas existentes. Sem esse parâmetro, a instalação do módulo falha.

Depois de instalar o módulo de Gerenciamento de Serviços do Azure PowerShell , importe o módulo:

Import-Module -Name Azure

Entrar

Para começar a gerenciar os recursos herdados do Azure com o módulo de Gerenciamento de Serviços do Azure PowerShell, inicie uma sessão do PowerShell e execute Add-AzureAccount para entrar no Azure:

Add-AzureAccount

Depois que você faz logon no Azure, o módulo de Gerenciamento de Serviços do Azure PowerShell cria um contexto para a sessão específica. Esse contexto contém o ambiente, a conta, o locatário e a assinatura do Azure usados para todos os cmdlets na sessão.

Solução de problemas

Se você receber o erro "O módulo especificado 'Azure.Storage' com a versão '4.3.0' não foi carregado porque nenhum arquivo de módulo válido foi encontrado em nenhum diretório de módulo.", será necessário instalar o módulo Azure.Storage do PowerShell:

Install-Module -Name Azure.Storage -Repository PSGallery -AllowClobber -Force

Se você receber o erro "O comando 'Install-Module' foi encontrado no módulo 'PowerShellGet', mas não foi possível carregar o módulo.", será necessário definir a política de execução do PowerShell como assinada remotamente ou menos restritiva:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Confira também

Para saber mais sobre os comandos no módulo de Gerenciamento de Serviços do Azure PowerShell, confira a documentação de referência de cmdlet.