Compartilhar via


O que é o Azure PowerShell?

O Azure PowerShell é o nome do produto da coleção de módulos oficiais do Microsoft PowerShell para gerenciar recursos do Azure. Ele requer o PowerShell, um shell de linha de comando e uma linguagem de script.

Você pode usar o Azure PowerShell interativamente executando comandos do PowerShell ou criando e executando scripts que consistem em vários comandos.

O módulo do Az PowerShell

A versão atual do Azure PowerShell é o módulo Az PowerShell. É o módulo recomendado do PowerShell para gerenciar recursos do Azure com o PowerShell em todas as plataformas, incluindo Windows, Linux e macOS. Ele inclui milhares de comandos que controlam quase todos os aspectos do Azure. O módulo Az PowerShell é multiplataforma.

Nota

O PowerShell 7 ou superior é a versão recomendada do PowerShell para uso com o módulo do Az PowerShell. Ele também é compatível com o Windows PowerShell 5.1.

Há algumas opções diferentes para usar o módulo do Az PowerShell:

  • do Azure Cloud Shell: um shell baseado em navegador que permite executar comandos do Azure PowerShell sem instalar nada no computador local.
  • Instalação local: para executar comandos diretamente do terminal, instale o Azure PowerShell em seu computador local.
  • Contêiner do Docker: execute o Azure PowerShell em um contêiner do Docker.

Autenticação

O Azure PowerShell dá suporte a vários métodos de autenticação. Para obter informações detalhadas sobre como fazer login no Azure a partir do módulo do Az PowerShell, consulte Fazer login no Azure do Azure PowerShell.

Design do módulo

O módulo do PowerShell Az é um módulo wrapper para módulos do PowerShell relacionados ao serviço do Azure, geralmente um módulo por serviço do Azure, como Az.Network para serviços de rede do Azure e do Az.Aks para o Serviço de Kubernetes do Azure.

Os cmdlets no módulo Az PowerShell fazem chamadas REST para a API do Azure Resource Manager. As alterações disruptivas no módulo Az PowerShell são limitadas a duas vezes por ano. Muitas alterações interruptivas no nível da API são processadas dentro dos cmdlets para evitar a percepção de uma alteração interruptiva.

O módulo Az PowerShell contém cmdlets para executar operações de plano de controle e de plano de dados no Azure. Você usa o plano de controle para gerenciar recursos em sua assinatura. O plano de dados é utilizado para controlar recursos expostos pela instância de um tipo de recurso que você tiver. Para obter mais informações, consulte plano de controle do Azure e plano de dados.

Objetos de saída

Os cmdlets no módulo Az PowerShell produzem objetos .NET. Assim como acontece com qualquer comando do PowerShell que produz saída, os cmdlets no módulo Az PowerShell podem ser canalizados para o cmdlet Get-Member para determinar que tipo de objeto é produzido, juntamente com uma lista das propriedades e métodos disponíveis. Para obter mais informações, confira Consultar saída do Azure PowerShell e Formatar a saída do cmdlet do Azure PowerShell.

O módulo do PowerShell do AzPreview

O módulo AzPreview PowerShell inclui todos os módulos de disponibilidade geral (GA) do módulo Az PowerShell e todos os módulos de pré-visualização para gerenciar recursos do Azure. Não é recomendado para ser utilizado em ambientes de produção, já que os módulos de pré-visualização não seguem políticas de alteração interruptiva.

O módulo AzPreview é sempre a mesma versão e é lançado ao mesmo tempo que o módulo Az PowerShell.

O módulo do PowerShell do AzureRM

Embora você possa encontrar exemplos online que usam o módulo AzureRM PowerShell, é a geração anterior do Azure PowerShell. Está obsoleta, não é mais mantida ou suportada e não é recomendada. Os comandos no módulo AzureRM PowerShell usam o formato *-AzureRM*. Para obter mais informações, consulte Visão geral do módulo do PowerShell do AzureRM.

O módulo do Azure PowerShell

Também é possível encontrar uma versão do Azure PowerShell denominada Módulo do Azure PowerShell. Este módulo destina-se ao gerenciamento de recursos herdados do Azure que usam APIs do ASM (Azure Service Manager). Ela não é recomendada para criar novos recursos, tendo em vista que o ASM está programado para ser desativado. Para obter mais informações, consulte Visão geral do módulo de Gerenciamento de Serviços do Azure PowerShell.

Esses produtos são usados para gerenciar recursos do Azure, mas não fazem parte do produto coletivo do Azure PowerShell. Eles nunca devem ser descritos usando o nome coletivo "Azure PowerShell".

  • Azure Active Directory PowerShell (AzureAD)
  • PowerShell da Proteção de Informações do Azure
  • PowerShell do Gerenciador de Implantação do Azure
  • PowerShell de trabalhos de Banco de Dados Elástico do Azure:
  • Azure Service Fabric PowerShell
  • Azure Stack PowerShell
  • Microsoft.Graph PowerShell
  • PowerShell do Microsoft.Graph.Entra
  • MSOnline PowerShell

Diretrizes

  • Sempre use o nome completo apropriado do produto ou o nome do módulo específico do PowerShell

Referências

Get-Member