Présentation du nouveau module Azure PowerShell AzIntroducing the new Azure PowerShell Az module

À compter de décembre 2018, le module Azure PowerShell Az est en version générale et désormais le module PowerShell prévu pour interagir avec Azure.Starting in December 2018, the Azure PowerShell Az module is in general release and now the intended PowerShell module for interacting with Azure. Az propose des commandes plus courtes, améliore la stabilité et prend en charge plusieurs plateformes.Az offers shorter commands, improved stability, and cross-platform support. AZ dispose également des mêmes fonctionnalités qu’AzureRM, ce qui vous donne une voie de migration facile.Az also has feature parity with AzureRM, giving you an easy migration path.

Avec le module Az, Azure PowerShell est désormais compatible avec PowerShell 5.1 sur Windows, et avec PowerShell Core 6.x et ultérieur, sur toutes les plateformes prises en charge,notamment Windows, macOS et 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.

Az étant un nouveau module, la version a été réinitialisée sur 1.0.0.Az is a new module, so the version has been reset to 1.0.0.

Pourquoi un nouveau module ?Why a new module?

Les mises à jour majeures peuvent poser des problèmes : il est donc important pour vous de savoir pourquoi la décision a été prise d’introduire un nouvel ensemble de modules, avec de nouvelles applets de commande, pour interagir avec Azure à partir de 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.

Le plus gros changement, et aussi le plus important, est que PowerShell est devenu un produit multiplateforme depuis l’introduction de PowerShell Core 6.x, basé sur la bibliothèque .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. Nous sommes attachés à fournir la prise en charge d’Azure sur toutes les plateformes, ce qui signifie que les modules Azure PowerShell devaient être mis à jour de façon à utiliser .NET Standard et à être compatible avec 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. Au lieu de prendre le module AzureRM existant et d’y introduire des modifications complexes pour ajouter cette prise en charge, nous avons créé le module Az.Rather than taking the existing AzureRM module and introduce complex changes to add this support, the Az module was created.

La création d’un nouveau module a également donné à nos ingénieurs l’occasion de mettre en cohérence la conception et le nommage des applets de commande et des modules.Creating a new module also gave our engineers the opportunity to make the design and naming of cmdlets and modules consistent. Les noms de tous les modules commencent désormais par le préfixe Az. et les applets de commande utilisent toutes la forme Verbe-AzNom.All modules now start with the Az. prefix and cmdlets all use the Verb-AzNoun form. Auparavant, les noms des applets de commande n’étaient pas seulement plus longs : il s’y trouvait aussi des incohérences.Previously, cmdlet names were not only longer, there were inconsistencies in cmdlet names.

Le nombre de modules a également été réduit : Certains modules qui fonctionnaient avec les mêmes services ont été regroupés ensemble, et les applets de commande de plan de gestion et de plan de données sont désormais contenues dans des modules uniques pour leurs services.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. Pour ceux d’entre vous qui gèrent manuellement les dépendances et les importations, ceci rend les choses beaucoup plus simples.For those of you who manually manage dependencies and imports, this makes things much simpler.

En faisant ces modifications importantes nécessitant la création d’un nouveau module Azure PowerShell, l’équipe s’est attachée à rendre plus facile que jamais, et sur plus de plateformes qu’auparavant, l’utilisation d’Azure avec des applets de commande PowerShell.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.

Mettre à niveau vers AzUpgrade to Az

Pour bénéficier des dernières fonctionnalités d’Azure dans PowerShell, vous devez migrer vers le module Az dès que possible.To keep up with the latest Azure features in PowerShell, you should migrate to the Az module as soon as possible. Si vous n’êtes pas prêt à installer le module Az en remplacement d’AzureRM, vous disposez de deux des options pour faire des essais avec 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:

  • Utilisez un environnement PowerShell avec Azure Cloud Shell.Use a PowerShell environment with Azure Cloud Shell. Azure Cloud Shell est un environnement shell basé sur un navigateur, qui est fourni avec le module Az installé et les alias de compatibilité de Enable-AzureRM activés.Azure Cloud Shell is a browser-based shell environment which comes with the Az module installed and Enable-AzureRM compatibility aliases enabled.
  • Conservez le module AzureRM installé avec PowerShell 5.1 pour Windows, mais installez le module Az pour PowerShell Core 6.x ou ultérieur.Keep the AzureRM module installed with PowerShell 5.1 for Windows, but install the Az module for PowerShell Core 6.x or later. PowerShell 5.1 pour Windows et PowerShell Core utilisent des collections distinctes de modules.PowerShell 5.1 for Windows and PowerShell Core use separate collections of modules. Suivez les instructions pour installer PowerShell Core, puis installez le module Az à partir d’un terminal PowerShell Core.Follow the instructions to install PowerShell Core and then install the Az module from a PowerShell Core terminal.

Pour mettre à niveau à partir d’une installation existante d’AzureRM :To upgrade from an existing AzureRM install:

  1. Désinstaller le module Azure PowerShell Azure RMUninstall the Azure PowerShell AzureRM module
  2. Installer le module Azure PowerShell AzInstall the Azure PowerShell Az module
  3. FACULTATIF : Activez le mode de compatibilité afin d’ajouter des alias pour les applets de commande AzureRM avec Enable-AzureRMAlias pendant la période où vous vous familiarisez avec le nouveau jeu de commandes.OPTIONAL: Enable compatibility mode to add aliases for AzureRM cmdlets with Enable-AzureRMAlias while you become familiar with the new command set. Pour plus d’informations, consultez la section suivante ou Démarrer la migration depuis AzureRM vers Az.See the next section or Start migration from AzureRM to Az for more details.

Migrer des scripts existants vers AzMigrate existing scripts to Az

Les nouveaux noms de cmdlets ont été conçus pour être facile à apprendre.The new cmdlet names have been designed to be easy to learn. Plutôt que d’utiliser AzureRm ou Azure dans les noms de cmdlets, utilisez Az.Instead of using AzureRm or Azure in cmdlet names, use Az. Par exemple, l’ancienne commande New-AzureRMVm est devenue New-AzVm.For example, the old command New-AzureRMVm has become New-AzVm. La migration ne consiste cependant pas seulement à vous familiariser avec les nouveaux noms des applets de commande : Des modules et des paramètres ont été renommés, et il y a d’autres changements importants.Migration is more than just becoming familiar with the new cmdlet names, though: There are renamed modules, parameters, and other important changes.

Pour vous aider dans le processus de migration depuis AzureRM vers Az, vous disposez de plusieurs ressources :To help you with the process of migration from AzureRM to Az, we've got a number of resources:

Le module Az a un mode de compatibilité pour vous aider à utiliser des scripts existants quand vous faites la mise à jour vers la nouvelle syntaxe.The Az module has a compatibility mode to help you use existing scripts while you update to the new syntax. L’applet de commande Enable-AzureRmAlias active un mode de compatibilité via des alias, pour vous permettre d’utiliser des scripts existants avec des modifications minimales pendant la période où vous travaillez à une migration complète vers 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.

Important

Même si les noms des applets de commande sont associés à des alias, il peut néanmoins y avoir de nouveaux paramètres (ou des paramètres renommés) ou des changements dans les valeurs retournées pour les applets de commande Az.Even though the cmdlet names are aliased, there may still be new (or renamed) parameters or changed return values for the Az cmdlets. Ne pensez donc pas que la simple activation des alias va prendre soin de la migration pour vous !Don't expect enabling aliases to take care of the migration for you! Consultez la liste complète des changements cassants pour voir où vos scripts peuvent nécessiter des mises à jour.See the full breaking changes list to find where your scripts may require updates.

Poursuite du support d’AzureRMContinued support for AzureRM

AzureRM ne recevra plus les nouvelles fonctionnalités ou applets de commande.AzureRM will no longer receive new cmdlets or features. Toutefois, le module AzureRM dispose encore d’une maintenance officielle et recevra des correctifs de bogues jusqu’en décembre 2020.However, the AzureRM module is still officially maintained and will get bug fixes through December 2020.