Перенос 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
Перед выполнением действий по миграции определите, какие версии AzureRM установлены в вашей системе. Это позволяет убедиться, что скрипты уже запущены в последнем выпуске и сообщите вам, какие версии AzureRM необходимо удалить.
Чтобы определить, какие версии AzureRM установлены, выполните следующий пример:
Get-Module -Name AzureRM -ListAvailable -All
Последний доступный выпуск AzureRM — 6.13.2. Если у вас нет этой версии, возможно, ваши существующие скрипты нужно будет изменить для работы с модулем Az наряду с изменениями, описанными в этой статье и списке критических изменений.
Если скрипты не работают с AzureRM 6.13.2, обновите их в соответствии с руководством по переходу AzureRM с версии 5.x на 6.x. Если вы используете более раннюю версию модуля AzureRM, найдите нужное руководство. Руководства по миграции существуют для каждого основного номера версии.
Вариант 1 (рекомендуется). Автоматический перенос скриптов PowerShell
Этот рекомендуемый вариант предполагает минимум усилий с вашей стороны для переноса скриптов 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.
Следующие шаги
Azure PowerShell