Partilhar via

Instalar o módulo Gestão do Serviço do Azure PowerShell

  • Artigo

Nota

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

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

O módulo Azure PowerShell Service Management é um módulo cumulativo. A instalação do módulo de 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 só funciona com o Windows PowerShell. Não é compatível com o PowerShell versão 6 ou superior e não é executado em Linux ou macOS.

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

    $PSVersionTable.PSVersion

  • Atualização para o Windows PowerShell 5.1

  • Definir a política de execução do PowerShell como assinada remotamente 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 Azure PowerShell Service Management 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 este 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

Iniciar sessão

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

Add-AzureAccount

Depois de iniciar sessão no Azure, o módulo de Gestão de Serviços do Azure PowerShell cria um contexto para uma determinada sessão. Esse contexto contém o ambiente do Azure, a conta, o locatário e a assinatura 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 qualquer diretório de módulo.", você precisará instalar o módulo Azure.Storage 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 o módulo não pôde ser carregado.", será necessário definir a política de execução do PowerShell como assinada remotamente ou menos restritiva:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Consulte também

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