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

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

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