Introdução do módulo Az PowerShell do Azure

Visão geral

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

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

Importante

Como os módulos do AZ PowerShell agora têm todas as funcionalidades dos módulos do AzureRM PowerShell e muito mais, vamos desativar os módulos do AzureRM PowerShell em 29 de fevereiro de 2024.

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

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

Recursos

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

  • Segurança e estabilidade
    • Criptografia de cache de token
    • Prevenção de ataque 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 do Azure
    • Todos os serviços do Azure em disponibilidade geral têm um módulo PowerShell correspondente com suporte
    • Várias correções de bug e atualizações de versão de API desde o AzureRM
  • Novos recursos
    • Suporte no Cloud Shell e em multiplataforma
    • Pode obter e usar o token de acesso para acessar recursos do Azure
    • Cmdlet disponível para operações REST avançadas com recursos do Azure

Observação

Recomenda-se o PowerShell 7.0.6 LTS, o PowerShell 7.1.3 ou versão posterior para uso com o módulo Az PowerShell do Azure em todas as plataformas.

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

Estamos comprometidos em oferecer o suporte do Azure em todas as plataformas e todos os módulos Az PowerShell são multiplataforma.

Atualizar o ambiente para o Az

Para se manter atualizado com os recursos mais recentes do Azure no PowerShell, você deverá migrar para o módulo Az. Caso você não esteja pronto para instalar o módulo Az como uma substituição para o AzureRM, você terá duas opções disponíveis para experimentar o Az:

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

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

  1. Desinstalar o módulo AzureRM do Azure PowerShell
  2. Instalar o módulo Az do Azure 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, confira a próxima seção ou Inicie a migração do AzureRM para o Az.

Migrar os scripts existentes do AzureRM para o Az

Se os scripts ainda estiverem baseados no módulo AzureRM, temos vários recursos para ajudar você na migração:

Capacidade de suporte

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

Como os módulos do AZ PowerShell agora têm todas as funcionalidades dos módulos do AzureRM PowerShell e muito mais, vamos desativar os módulos do AzureRM PowerShell em 29 de fevereiro de 2024.

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

Coleta de dados

O Azure PowerShell coleta dados telemétricos por padrão. A Microsoft agrega dados coletados não só para identificar padrões de uso e problemas comuns, mas também para aprimorar a experiência do Azure PowerShell. O Microsoft Azure PowerShell não coleta dados privados ou pessoais. Por exemplo, os dados de uso ajudam a identificar problemas – como cmdlets com baixo índice de sucesso – e a priorizar o trabalho.

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