Ler em inglês

Compartilhar via


Apresentação do módulo do Az PowerShell

A partir de dezembro de 2018, o módulo Az PowerShell está em versão geral e é agora o módulo PowerShell pretendido para interagir com o Azure. O Az oferece comandos menores, maior estabilidade e dá suporte à plataforma cruzada. O Az também tem paridade de recursos com o AzureRM, oferecendo um fácil caminho de migração.

Com o módulo Az, o Azure PowerShell agora é compatível com o PowerShell 5.1 no Windows e com o PowerShell Core 6.x e posterior em todas as plataformas compatíveis – incluindo Windows, Linux e macOS.

O Az é um novo módulo, portanto, a versão foi redefinida para 1.0.0.

Por que um novo módulo?

Atualizações importantes podem ser inconvenientes. Dessa forma, é importante informá-lo por que a decisão de introduzir um novo conjunto de módulos foi tomada, com novos cmdlets para interagir com o Azure por meio do PowerShell.

A maior e mais importante alteração é que o PowerShell tem sido um produto multiplataforma desde a introdução do PowerShell, com base na biblioteca .NET Standard. Estamos comprometidos em levar o suporte do Azure a todas as plataformas, o que significa que os módulos do Azure PowerShell precisavam ser atualizados para usarem o .NET Standard e serem compatíveis com o PowerShell Core. Em vez de usar o módulo AzureRM existente e introduzir alterações complexas para adicionar esse suporte, o módulo Az foi criado.

A criação de um módulo também deu a nossos engenheiros a oportunidade de tornar consistentes o design e a nomeação de cmdlets e módulos. Todos os módulos agora começam com o prefixo Az. e todos os cmdlets usam o formato Verbo-AzSubstantivo. Anteriormente, os nomes dos cmdlets não eram só mais longos, mas continham inconsistências.

O número de módulos também foi reduzido: alguns módulos que funcionavam com os mesmos serviços foram agrupados e os cmdlets do plano de dados e do plano de gerenciamento agora estão contidos em módulos únicos para os serviços. Para aqueles que gerenciam dependências e importações manualmente, isso simplifica muito as tarefas.

Ao fazer essas alterações importantes que precisavam da criação de um módulo do Azure PowerShell, a equipe se comprometeu em tornar o uso do Azure com cmdlets do PowerShell mais fácil do que nunca e em mais plataformas do que o que era possível anteriormente.

Atualizar para o Az

Para se manter atualizado com os recursos mais recentes do Azure no PowerShell, você deverá migrar para o módulo Az assim que possível. 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.
  • Manter o módulo AzureRM instalado com o PowerShell 5.1 para Windows, mas instalar o módulo Az para o PowerShell Core 6.x ou posterior. O PowerShell 5.1 para Windows e o PowerShell Core usam coleções separadas de módulos. Siga as instruções para instalar o PowerShell Core e, em seguida, instalar o módulo Az em um terminal do PowerShell Core.

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

  1. Desinstalar o módulo AzureRM do Azure PowerShell
  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. Confira a próxima seção ou Iniciar uma migração do AzureRM para o Az para obter mais detalhes.

Migrar os scripts existentes para o Az

Os novos nomes de cmdlets foram projetados para serem fáceis de aprender. Em vez de usar AzureRm ou Azure nos nomes de cmdlets, use Az. Por exemplo, o comando antigo New-AzureRMVm tornou-se New-AzVm. Entretanto, a migração é mais do que apenas familiarizar-se com os novos nomes de cmdlet: há módulos renomeados, parâmetros e outras alterações importantes.

Para ajudá-lo com o processo de migração do AzureRM para o Az, temos uma série de recursos:

O módulo Az tem um modo de compatibilidade para ajudá-lo a usar os scripts existentes enquanto você atualiza para a nova sintaxe. O cmdlet Enable-AzureRmAlias habilita um modo de compatibilidade por meio de aliases, para permitir que você use os scripts existentes com modificação mínima enquanto estiver trabalhando para realizar uma migração completa para o Az.

Importante

Embora os nomes dos cmdlets sejam convertidos em alias, ainda poderá haver parâmetros novos (ou renomeados) ou valores retornados alterados para os cmdlets do Az. Não espere que a habilitação de aliases cuide da migração para você. Confira a lista completa de alterações da falha para descobrir quando seus scripts podem exigir atualizações.

Suporte para o AzureRM

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.