Apresentando o módulo do Az PowerShell

Visão geral

O módulo Az PowerShell é um conjunto de cmdlets para gerenciar recursos do Azure diretamente no PowerShell. O PowerShell fornece recursos avançados para automação que podem ser aproveitados para gerenciar seus recursos de Azure, por exemplo, no contexto de um pipeline de CI/CD.

O módulo do Az PowerShell é a substituição do AzureRM e é o módulo recomendado a ser usado para interagir com Azure.

Você pode usar o módulo do Az PowerShell com um dos seguintes métodos:

• Instale o módulo do Az PowerShell.
• Use Azure Cloud Shell.
• Use o contêiner do Docker do Az PowerShell.

Características

O módulo do Az PowerShell apresenta os seguintes benefícios:

• Segurança e estabilidade
  • Criptografia de cache de token
  • Prevenção de ataques do tipo man-in-the-middle
  • Suporte à autenticação com o ADFS 2019
  • Autenticação de nome de usuário e senha no PowerShell 7
  • Suporte para recursos como avaliação contínua de acesso
• Suporte para todos os serviços de Azure
  • Todos os serviços de Azure disponíveis em geral têm um módulo do PowerShell com suporte correspondente
  • Várias correções de bug e atualizações de versão da API desde o AzureRM
• Novos recursos
  • Suporte em Cloud Shell e multiplataforma
  • Pode obter e usar o token de acesso para acessar Azure recursos
  • Cmdlet disponível para operações REST avançadas com recursos de Azure

O módulo do Az PowerShell é baseado na biblioteca .NET Standard e funciona com o PowerShell 7.2 e posterior em todas as plataformas, incluindo Windows, Linux e macOS. Ele também é compatível com Windows PowerShell 5.1.

Estamos comprometidos em trazer Suporte do Azure para todas as plataformas e todos os módulos do Az PowerShell são multiplataformas.

Atualize seu ambiente para Az

Para acompanhar os recursos de Azure mais recentes no PowerShell, você deve migrar para o módulo Az. Se você não estiver pronto para instalar o módulo Az como substituto do AzureRM, terá algumas opções disponíveis para experimentar o Az:

• Use um ambiente PowerShell com Azure Cloud Shell. Azure Cloud Shell é um ambiente de shell baseado em navegador que vem com o módulo Az instalado e Enable-AzureRM aliases de compatibilidade habilitados.
• Mantenha o módulo do AzureRM instalado no Windows PowerShell 5.1 e instale o módulo Az no PowerShell 7 ou posterior. Windows PowerShell 5.1 e PowerShell 7 e posteriores usam coleções separadas de módulos. Siga as instruções para instalar a versão mais recente do PowerShell e, em seguida, instalar o módulo Az do PowerShell 7 ou posterior.

Para atualizar de uma instalação existente do AzureRM:

1. Desinstalar o módulo Azure PowerShell AzureRM
2. Instalar o módulo do Az PowerShell
3. OPCIONAL: habilite o modo de compatibilidade para adicionar aliases para cmdlets do AzureRM com Enable-AzureRMAlias enquanto você se familiariza com o novo conjunto de comandos. Para obter mais informações, consulte a próxima seção ou iniciar a migração do AzureRM para o Az.

Migrar scripts existentes do AzureRM para o Az

Se seus scripts ainda forem baseados no módulo AzureRM, teremos vários recursos para ajudá-lo com a migração:

• Introdução à migração do AzureRM para o Az
• Lista completa de alterações de impacto do AzureRM para Az 1.0.0
• O cmdlet Enable-AzureRmAlias

Suportabilidade

O Az é o módulo mais atual do PowerShell para Azure. Problemas ou solicitações de recursos podem ser registrados diretamente no GitHub repositório ou por meio de Microsoft suporte se você tiver um contrato de suporte. As solicitações de funcionalidades foram implementadas na versão mais recente do Az. Problemas críticos são implementados nas duas últimas versões do Az.

Como os módulos do Az PowerShell agora têm todos os recursos dos módulos do AzureRM PowerShell e muito mais, descontinuamos os módulos do PowerShell do AzureRM a partir de 29 de fevereiro de 2024.

Para evitar interrupções de serviço, atualize seus scripts que usam módulos do PowerShell do AzureRM para usar módulos do Az PowerShell. Para atualizar automaticamente seus scripts, siga o guia de início rápido.

Recolha de dados

Azure PowerShell coleta dados de telemetria por padrão. Microsoft agrega dados coletados para identificar padrões de uso para identificar problemas comuns e melhorar a experiência de Azure PowerShell. O Microsoft Azure PowerShell não coleta dados pessoais ou privados. Por exemplo, os dados de uso ajudam a identificar problemas como cmdlets com baixo êxito e ajudam a priorizar nosso trabalho.

Embora apreciemos os insights que esses dados fornecem, também entendemos que nem todos querem enviar dados de uso. Você pode desabilitar a coleta de dados com o Disable-AzDataCollection cmdlet. Você também pode ler a nossa política de privacidade para saber mais.