Compartilhar via

O que é o Azure PowerShell?

O Azure PowerShell é o nome do produto para a coleção de módulos oficiais do Microsoft PowerShell destinados a gerir recursos do Azure. Ele requer o PowerShell, um shell de linha de comando e 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 Az PowerShell

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

Observação

A versão recomendada do PowerShell para uso com o módulo Az PowerShell é o PowerShell 7 ou superior. Também é compatível com o Windows PowerShell 5.1.

Existem algumas opções diferentes para usar o módulo Az PowerShell:

  • Azure Cloud Shell: Uma shell baseada em navegador que permite executar comandos do Azure PowerShell sem instalar nada na sua máquina local.
  • Instalação local: Para executar comandos diretamente a partir do seu terminal, instale o Azure PowerShell na sua máquina local.
  • Contêiner do Docker: execute o Azure PowerShell em um contêiner do Docker.

Autenticação

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

Design de módulos

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

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

O módulo Az PowerShell contém cmdlets para executar operações tanto de plano de controlo como de plano de dados no Azure. Você usa o plano de controle para gerenciar recursos em sua assinatura. Você usa o plano de controlo de dados para gerir as capacidades expostas pela sua instância de um tipo de recurso. Para obter mais informações, consulte plano de controle do Azure e plano de dados.

Objetos de saída

Os cmdlets no módulo PowerShell Az produzem objetos .NET. Tal como acontece com qualquer comando PowerShell que produz saída, os cmdlets no módulo PowerShell Az 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, consulte saída de consulta do Azure PowerShell e Formatar a saída do cmdlet do Azure PowerShell.

O módulo AzPreview PowerShell

O módulo PowerShell AzPreview inclui todos os módulos disponíveis de forma geral (GA) do módulo PowerShell Az e todos os módulos de pré-visualização para gestão de recursos do Azure. Não é recomendado para uso em ambientes de produção, uma vez que os módulos de pré-visualização não aderem às políticas de alterações disruptivas.

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

O módulo PowerShell do AzureRM

Embora possa encontrar exemplos online que utilizam o módulo PowerShell AzureRM, este é da geração anterior do Azure PowerShell. Está obsoleto, já não é mantido nem suportado, e não é recomendado. Os comandos no módulo PowerShell AzureRM utilizam o formato *-AzureRM*. Para mais informações, consulte Overview of the AzureRM PowerShell module.

O módulo do Azure PowerShell

Também poderá encontrar uma versão do Azure PowerShell denominada o módulo PowerShell do Azure. Este módulo destina-se a gerir recursos herdados do Azure que utilizam APIs do Azure Service Manager (ASM). Não é recomendado criar novos recursos, pois o ASM está programado para ser descontinuado. Para mais informações, consulte Visão Geral do módulo de Gestão 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. Nunca devem ser descritos usando o nome coletivo "Azure PowerShell".

  • Azure Ative Directory PowerShell (AzureAD)
  • Azure Information Protection PowerShell
  • Azure Deployment Manager PowerShell
  • Azure Elastic Database Jobs PowerShell
  • Azure Service Fabric PowerShell
  • Azure Stack PowerShell
  • Microsoft.Graph PowerShell
  • Microsoft.Graph.Entra PowerShell
  • MSOnline PowerShell

Orientações

  • Use sempre o nome completo e correto do produto ou o nome específico do módulo PowerShell.

Referências

Get-Member