Compartilhar via

Instalando o 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á programado para descontinuaçã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 gerenciamento de serviços do Azure PowerShell é um módulo cumulativo. A instalação do módulo gerenciamento de serviços do Azure PowerShell baixa os módulos geralmente disponíveis para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços e disponibilizam seus cmdlets para uso.

Pré-requisitos

Importante

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

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

    $PSVersionTable.PSVersion

  • Atualizar para o Windows PowerShell 5.1

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

    • Verifique 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 obter mais informações sobre políticas de execução, consulte about_Execution_Policies.

  • Atualizar o 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 Gerenciamento de Serviços do Azure PowerShell compartilha dependências com os módulos do Azure PowerShell Resource Manager. Se você tiver instalado os módulos do Azure PowerShell Resource Manager, o parâmetro AllowClobber , conforme mostrado no comando anterior, será necessário. Isso permite que as dependências compartilhadas existentes sejam atualizadas. 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 seus 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 de fazer logon no Azure, o módulo gerenciamento de serviços do Azure PowerShell cria um contexto para a sessão fornecida. Esse contexto contém o ambiente, a conta, o tenant e a assinatura do Azure usados para todos os cmdlets nessa sessão.

Resoluçã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.", você precisará instalar o módulo do PowerShell do Azure.Storage:

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 o módulo não pôde ser carregado.", você precisará definir a política de execução do PowerShell como remota assinada ou menos restritiva:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Consulte também

Para obter mais informações sobre comandos no módulo de Gerenciamento de Serviços do Azure PowerShell, consulte a documentação de referência do cmdlet.

  • Last updated on