Поделиться через

Перенос 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 PowerShell.

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

Полный список критических изменений между AzureRM и Az см. в разделе , где указаны все изменения из 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.

Дальнейшие действия