Перенос Azure PowerShell с AzureRM на Az

Предупреждение

Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 года. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не будет поддерживаться, получать обновления или поддержку, размещая любое продолжение использования по усмотрению и риску пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Определение того, используется ли модуль AzureRM PowerShell

Используйте следующую команду, чтобы определить, установлен ли модуль AzureRM PowerShell:

Get-Module -Name AzureRM -ListAvailable

Вы также можете выполнить полнотекстовый поиск скриптов для шаблона *-AzureRM* , чтобы определить, используют ли они модуль AzureRM PowerShell.

Обновление до модуля Az PowerShell

Скрипты, написанные для командлетов AzureRM, не смогут автоматически работать с Az. Чтобы упростить этот переход, был разработан набор средств для миграции с AzureRM на Az. Миграция всегда сопряжена со сложностями, и эта статья поможет вам начать переход на новый модуль Az PowerShell. Дополнительные сведения о том, для чего был создан модуль Az PowerShell, см. в статье Знакомство с новым модулем Az для Azure PowerShell.

Новые имена командлетов выбраны таким образом, чтобы их было легко запомнить. Вместо имен командлетов AzureRm или Azure используйте Az. Например, вместо старого командлета New-AzureRMVm используется New-AzVm. Однако миграция более чем знакома с новыми именами командлетов. Были переименованы модули, параметры и внесено много других важных изменений.

Полный список критических изменений между AzureRM и Az см. здесь.

Убедитесь, что существующие скрипты работают с последним выпуском AzureRM

Перед выполнением действий по миграции определите, какие версии AzureRM установлены в вашей системе. Это позволяет убедиться, что скрипты уже запущены в последнем выпуске и сообщите вам, какие версии AzureRM необходимо удалить.

Чтобы определить, какие версии AzureRM установлены, выполните следующий пример:

Get-Module -Name AzureRM -ListAvailable -All

Последний доступный выпуск AzureRM — 6.13.2. Если у вас нет этой версии, возможно, ваши существующие скрипты нужно будет изменить для работы с модулем Az наряду с изменениями, описанными в этой статье и списке критических изменений.

Если скрипты не работают с AzureRM 6.13.2, обновите их в соответствии с руководством по переходу AzureRM с версии 5.x на 6.x. Если вы используете более раннюю версию модуля AzureRM, найдите нужное руководство. Руководства по миграции существуют для каждого основного номера версии.

Этот рекомендуемый вариант предполагает минимум усилий с вашей стороны для переноса скриптов AzureRM в Az.

Используя набор средств для миграции с AzureRM на Az, вы можете подготовить план, который определяет изменения, которые будут внесены в скрипты до их внесения и установки модуля Az PowerShell.

В статье Краткое руководство. Автоматическая миграция скриптов PowerShell из AzureRM в модуль Az PowerShell показано, как выполнить автоматический перенос скриптов PowerShell из AzureRM в модуль Az PowerShell.

Вариант 2. Использование режима совместимости с помощью Enable-AzureRmAlias

В модуле Az предусмотрен режим совместимости, который позволяет использовать существующие скрипты, пока вы выполняете обновление для нового синтаксиса. Командлет Enable-AzureRmAlias включает режим совместимости с использованием псевдонимов. Так вы сможете использовать существующие скрипты с минимальными изменениями во время подготовки к полному переходу на Az. По умолчанию Enable-AzureRmAlias включает псевдонимы совместимости только для текущего сеанса PowerShell. Используйте его параметр Scope, чтобы псевдонимы совместимости поддерживались во всех сеансах PowerShell. Дополнительные сведения см. в справочной статье о командлете Enable-AzureRmAlias.

Внимание

Несмотря на то что для имен командлетов используются псевдонимы, все же могут существовать новые (или переименованные) параметры или измененные возвращаемые значения для командлетов Az. Не ожидайте включения псевдонимов, которые будут заботиться о миграции. Ознакомьтесь с полным списком критических изменений, чтобы узнать, где в скриптах могут потребоваться обновления.

Enable-AzureRmAlias Поддержка не рекомендуется использовать при отключении модуля AzureRM PowerShell.

Следующие шаги