Apresentação do novo módulo do Azure PowerShell AzIntroducing the new Azure PowerShell Az module

A partir de dezembro de 2018, o módulo do Az do Azure PowerShell passa a ser uma versão de disponibilidade geral e é agora o módulo indicado do PowerShell para interagir com o Azure.Starting in December 2018, the Azure PowerShell Az module is in general release and now the intended PowerShell module for interacting with Azure. O Az oferece comandos mais curtos, maior estabilidade e suporte para várias plataformas.Az offers shorter commands, improved stability, and cross-platform support. O Az também oferece paridade de funcionalidades e um caminho de migração fácil a partir do AzureRM.Az also offers feature parity and an easy migration path from AzureRM.

Com o módulo Az, o Azure PowerShell passa a ser compatível com o PowerShell 5.1 no Windows e com o PowerShell Core 6.x e versões posteriores em todas as plataformas suportadas, incluindo Windows, macOS e Linux.With the Az module, Azure PowerShell is now compatible with PowerShell 5.1 on Windows and PowerShell Core 6.x and later on all supported platforms - including Windows, macOS, and Linux.

O Az é um módulo novo, pelo que a versão foi reposta para 1.0.0.Az is a new module, so the version has been reset to 1.0.0.

Por quê um novo módulo?Why a new module?

As principais atualizações podem ser inconvenientes, pelo que é importante informá-lo das razões que nos levaram a optar por introduzir um novo conjunto de módulos, com novos cmdlets, para interagir com o Azure a partir do PowerShell.Major updates can be inconvenient, so it's important that we let you know why the decision was made to introduce a new set of modules, with new cmdlets, for interacting with Azure from PowerShell.

A alteração mais importante e mais significativa é que o PowerShell tem sido um produto compatível com várias plataformas desde o lançamento do PowerShell Core 6.x, com base na biblioteca do .NET Standard.The biggest and most important change is that PowerShell has been a cross-platform product since the introduction of PowerShell Core 6.x, based on the .NET Standard library. Assumimos o compromisso de levar o suporte do Azure a todas as plataformas e, para isso, os módulos do Azure PowerShell tinham de ser atualizados para utilizar o .NET Standard e ser compatíveis com o PowerShell Core.We're committed to bringing Azure support to all platforms, which means that the Azure PowerShell modules needed to be updated to use .NET Standard and be compatible with PowerShell Core. Em vez de introduzirmos alterações complexas ao módulo AzureRM para adicionar este suporte, criámos o módulo Az.Rather than taking the existing AzureRM module and introduce complex changes to add this support, the Az module was created.

A criação de um novo módulo também deu aos nossos engenheiros a oportunidade de garantir a consistência da estruturação e da nomenclatura dos cmdlets e módulos.Creating a new module also gave our engineers the opportunity to make the design and naming of cmdlets and modules consistent. Agora, todos os módulos começam com o prefixo Az. e todos os cmdlets utilizam a forma Verbo-AzSubstantivo.All modules now start with the Az. prefix and cmdlets all use the Verb-AzNoun form. Anteriormente, os nomes dos cmdlets não só eram mais longos como tinham mais inconsistências.Previously, cmdlet names were not only longer, there were inconsistencies in cmdlet names.

O número de módulos também foi reduzido: Alguns módulos que funcionavam com os mesmos serviços foram implementados em conjunto e os cmdlets do plano de gestão e do plano de dados passam todos a estar contidos em módulos únicos relativamente aos seus serviços.The number of modules was also reduced: Some modules which worked with the same services have been rolled together, and management plane and data plane cmdlets are now contained all within single modules for their services. Para quem faz a gestão manual das dependências e importações, a tarefa torna-se muito mais simples.For those of you who manually manage dependencies and imports, this makes things much simpler.

Ao levar a cabo estas alterações importantes que exigiram a criação de um novo módulo do Azure PowerShell, a equipa assumiu o compromisso de tornar a utilização do Azure com os cmdlets do PowerShell mais fácil do que nunca e em mais plataformas do que alguma vez foi antes possível.By making these important changes that required building a new Azure PowerShell module, the team has committed to making it easier than ever, and on more platforms than previously possible, to use Azure with PowerShell cmdlets.

Atualizar para AzUpgrade to Az

Para se manter a par das mais recentes funcionalidades do Azure no PowerShell, deve migrar para o módulo Az assim que for possível.To keep up with the latest Azure features in PowerShell, you should migrate to the Az module as soon as possible. Se não estiver pronto para instalar o módulo Az como substituto do AzureRM, tem algumas opções disponíveis para experimentar o Az:If you're not ready to install the Az module as a replacement for AzureRM, you have a couple of options available to experiment with Az:

  • Utilize um ambiente PowerShell com o Azure Cloud Shell.Use a PowerShell environment with Azure Cloud Shell. O Azure Cloud Shell é um ambiente de shell baseado no browser que é fornecido com o módulo Az instalado e com os aliases de compatibilidade Enable-AzureRM ativados.Azure Cloud Shell is a browser-based shell environment which comes with the Az module installed and Enable-AzureRM compatibility aliases enabled.
  • Mantenha o módulo AzureRM instalado com o PowerShell 5.1 para Windows, mas instale o módulo Az para o PowerShell Core 6.x ou versões posteriores.Keep the AzureRM module installed with PowerShell 5.1 for Windows, but install the Az module for PowerShell Core 6.x or later. O PowerShell 5.1 para Windows e o PowerShell Core utilizam coleções separadas de módulos.PowerShell 5.1 for Windows and PowerShell Core use separate collections of modules. Siga as instruções de instalação do PowerShell Core e, em seguida, instale o módulo Az a partir de um terminal do PowerShell Core.Follow the instructions to install PowerShell Core and then install the Az module from a PowerShell Core terminal.

Para atualizar a partir de uma instalação existente do AzureRM:To upgrade from an existing AzureRM install:

  1. Desinstalar o módulo do Azure PowerShell AzureRMUninstall the Azure PowerShell AzureRM module
  2. Instalar o módulo do Azure PowerShell AzInstall the Azure PowerShell Az module
  3. OPCIONAL: Ative o modo de compatibilidade para adicionar aliases para cmdlets do AzureRM com Enable-AzureRMAlias enquanto se familiariza com o novo conjunto de comandos.OPTIONAL: Enable compatibility mode to add aliases for AzureRM cmdlets with Enable-AzureRMAlias while you become familiar with the new command set. Veja a secção seguinte ou Inicie a migração do AzureRM para o Az para obter mais detalhes.See the next section or Start migration from AzureRM to Az for more details.

Migrar scripts existentes para o AzMigrate existing scripts to Az

Os novos nomes de cmdlet foram criados para serem fáceis de aprender.The new cmdlet names have been designed to be easy to learn. Em vez de utilizar AzureRm ou Azure em nomes de cmdlet, utilize Az.Instead of using AzureRm or Azure in cmdlet names, use Az. Por exemplo, o comando antigo New-AzureRMVm tornou-se New-AzVm.For example, the old command New-AzureRMVm has become New-AzVm. Contudo, a migração exige mais do que apenas se familiarizar com os novos nomes dos cmdlets: Existem módulos com nomes alterados, parâmetros e outras alterações importantes.Migration is more than just becoming familiar with the new cmdlet names, though: There are renamed modules, parameters, and other important changes.

Para ajudá-lo no processo de migração do AzureRM para o Az, temos uma série de recursos:To help you with the process of migration from AzureRM to Az, we've got a number of resources:

O módulo Az tem um modo de compatibilidade para o ajudar a utilizar os scripts existentes enquanto atualiza para a nova sintaxe.The Az module has a compatibility mode to help you use existing scripts while you update to the new syntax. O cmdlet Enable-AzureRmAlias ativa um modo de compatibilidade através de aliases, para que possa utilizar scripts existentes com alterações mínimas ao mesmo tempo que faz a migração completa para o Az.The Enable-AzureRmAlias cmdlet enables a compatibility mode through aliases, to allow you to use existing scripts with minimal modification while working towards a full migration to Az.

Importante

Embora os nomes dos cmdlets tenham aliases, poderá continuar a existir parâmetros novos (ou com nome alterado) ou valores de retorno alterados dos cmdlets do Az.Even though the cmdlet names are aliased, there may still be new (or renamed) parameters or changed return values for the Az cmdlets. Não espere que a ativação dos aliases trate da migração por si!Don't expect enabling aliases to take care of the migration for you! Veja a lista completa de alterações interruptivas para saber onde os seus scripts poderão precisar de atualizações.See the full breaking changes list to find where your scripts may require updates.

Suporte contínuo para o AzureRMContinued support for AzureRM

O módulo do AzureRM existente deixará de receber novos cmdlets ou funcionalidades.The existing AzureRM module will no longer receive new cmdlets or features. No entanto, o AzureRM ainda é oficialmente mantido e será alvo de correções de erros até, pelo menos, dezembro de 2020.However, AzureRM is still officially maintained and will get bug fixes up through at least December 2020.

Se tiver dúvidas sobre se o módulo Az está totalmente funcional, testado ou pronto para produção: Todo o trabalho de engenharia investido no AzureRM está a ser dedicado ao Az, incluindo o máximo possível de reutilização de código dos módulos existentes e a realização de variados testes para fazer com que os novos módulos sejam compatíveis com as funcionalidades.If you have concerns about whether or not the Az module is as fully-featured, tested, or production ready: All of the engineering work that went into AzureRM has now been focused on Az, including as much code reuse of the existing modules as was possible, and extensive testing to make the new modules feature-compatible. A migração para o Az deve depender apenas da agenda da sua organização, sem que seja preciso esperar pelo lançamento de funcionalidades específicas.Moving onto Az should be influenced by your organization's schedule alone, without needing to wait on specific features to appear.