Знакомство с новым модулем Az для Azure PowerShellIntroducing the new Azure PowerShell Az module

С декабря 2018 г. модуль Az для Azure PowerShell существует в общедоступной версии и теперь является модулем PowerShell, предназначенным для работы с Azure.Starting in December 2018, the Azure PowerShell Az module is in general release and is now the intended PowerShell module for interacting with Azure. Модуль Az предлагает более короткие имена команд, улучшенную стабильность, а также кроссплатформенную поддержку.Az offers shorter commands, improved stability, and cross-platform support. Кроме того, для AZ реализовано равенство функций с AzureRM, что обеспечивает простоту перехода.Az also has feature parity with AzureRM, giving you an easy migration path.

Благодаря модулю Az среда Azure PowerShell теперь совместима с PowerShell 5.1 в Windows и PowerShell Core 6.x и более поздней версии на всех поддерживаемых платформах, включая Windows, macOS и 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 — это новый модуль, поэтому нумерация версий начинается с 1.0.0.Az is a new module, so the version has been reset to 1.0.0.

Преимущества нового модуляWhy a new module?

Значительные обновления могут быть сопряжены со сложностями, поэтому важно узнать, почему было принято решение представить новый набор модулей с новыми командлетами для взаимодействия с Azure через 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.

Самое большое и важное изменение заключается в том, что PowerShell стал кроссплатформенным продуктом с момента появления PowerShell Core 6.x на основе библиотеки .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. Мы стремимся обеспечить поддержку Azure на всех платформах. Это означает, что модули Azure PowerShell необходимо обновить для использования .NET Standard и совместимости с 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. Вместо того чтобы вносить в существующий модуль AzureRM сложные изменения для добавления этой поддержки, был создан модуль Az.Rather than taking the existing AzureRM module and introduce complex changes to add this support, the Az module was created.

Это решение также дало нашим инженерам возможность согласовать проектирование и именование командлетов и модулей.Creating a new module also gave our engineers the opportunity to make the design and naming of cmdlets and modules consistent. Все модули теперь начинаются с префикса Az., а все командлеты используют форму команда-Azсуществительное.All modules now start with the Az. prefix and cmdlets all use the Verb-AzNoun form. Ранее имена командлетов не только были длиннее, но и в них были несоответствия.Previously, cmdlet names were not only longer, there were inconsistencies in cmdlet names.

Количество модулей уменьшилось. Некоторые модули, которые работали с одинаковыми службами, были объединены, а командлеты плоскости управления и плоскости данных теперь содержатся в едином модуле для работы с соответствующими службами.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. Это упрощает задачу для тех, кто вручную управляет зависимостями и импортом.For those of you who manually manage dependencies and imports, this makes things much simpler.

Выполняя эти важные изменения, которые привели к созданию модуля Azure PowerShell, команда стремилась максимально упростить использование Azure с помощью командлетов 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.

Обновление до AzUpgrade to Az

Для поддержки новых функций Azure в PowerShell необходимо как можно скорее перейти на модуль Az.To keep up with the latest Azure features in PowerShell, you should migrate to the Az module as soon as possible. Если вы не готовы установить модуль Az в качестве замены AzureRM, вам доступны несколько способов экспериментирования с 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:

  • Использование среды PowerShell с Azure Cloud Shell.Use a PowerShell environment with Azure Cloud Shell. Azure Cloud Shell — это браузерная среда оболочки, которая поставляется с пакетом установки модуля Az и поддерживает псевдонимы совместимости Enable-AzureRM.Azure Cloud Shell is a browser-based shell environment which comes with the Az module installed and Enable-AzureRM compatibility aliases enabled.
  • Оставив установленный модуль AzureRM с PowerShell 5.1 для Windows, установите модуль Az для PowerShell Core 6.x или более поздней версии.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 для Windows и PowerShell Core используют отдельные коллекции модулей.PowerShell 5.1 for Windows and PowerShell Core use separate collections of modules. Следуйте инструкциям, чтобы установить PowerShell Core, а затем установите модуль Az из терминала PowerShell Core.Follow the instructions to install PowerShell Core and then install the Az module from a PowerShell Core terminal.

Чтобы выполнить обновление из существующей установки AzureRM, сделайте следующее:To upgrade from an existing AzureRM install:

  1. Удалите модуль AzureRM для Azure PowerShell.Uninstall the Azure PowerShell AzureRM module
  2. Установите модуль Az для Azure PowerShell.Install the Azure PowerShell Az module
  3. НЕОБЯЗАТЕЛЬНО. Активируйте режим совместимости, чтобы добавить псевдонимы для командлетов AzureRM с помощью Enable-AzureRMAlias, пока вы не ознакомитесь с новым набором команд.OPTIONAL: Enable compatibility mode to add aliases for AzureRM cmdlets with Enable-AzureRMAlias while you become familiar with the new command set. Дополнительные сведения см. в следующем разделе или в статье Перенос Azure PowerShell с AzureRM на Az.See the next section or Start migration from AzureRM to Az for more details.

Миграция существующих скриптов на AzMigrate existing scripts to Az

Новые имена командлетов выбраны таким образом, чтобы их было легко запомнить.The new cmdlet names have been designed to be easy to learn. Вместо имен командлетов AzureRm или Azure используйте Az.Instead of using AzureRm or Azure in cmdlet names, use Az. Например, вместо старой команды New-AzureRMVm используется New-AzVm.For example, the old command New-AzureRMVm has become New-AzVm. При переносе вам нужно не просто ознакомиться с новыми именами командлетов. Были переименованы модули, параметры и внесено много других важных изменений.Migration is more than just becoming familiar with the new cmdlet names, though: There are renamed modules, parameters, and other important changes.

Чтобы упростить процесс перехода с AzureRM на Az, у нас есть ряд ресурсов:To help you with the process of migration from AzureRM to Az, we've got a number of resources:

В модуле Az предусмотрен режим совместимости, который позволяет использовать существующие скрипты, пока вы выполняете обновление для нового синтаксиса.The Az module has a compatibility mode to help you use existing scripts while you update to the new syntax. Командлет Enable-AzureRmAlias активирует режим совместимости через псевдонимы, чтобы можно было использовать существующие скрипты с минимальными изменениями во время подготовки к полному переходу на 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.

Важно!

Несмотря на то что для имен командлетов используются псевдонимы, все же могут существовать новые (или переименованные) параметры или измененные возвращаемые значения для командлетов Az.Even though the cmdlet names are aliased, there may still be new (or renamed) parameters or changed return values for the Az cmdlets. Не ожидайте, что активация псевдонимов обеспечит миграцию для вас.Don't expect enabling aliases to take care of the migration for you! Ознакомьтесь с полным списком критических изменений, чтобы узнать, где в скриптах могут потребоваться обновления.See the full breaking changes list to find where your scripts may require updates.

Дальнейшая поддержка AzureRMContinued support for AzureRM

В AzureRM больше не будут добавляться новые командлеты или функции.AzureRM will no longer receive new cmdlets or features. Но модуль AzureRM по-прежнему официально поддерживается. В нем будут исправляться ошибки до декабря 2020 года.However, the AzureRM module is still officially maintained and will get bug fixes through December 2020.