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

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

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