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

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

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