Перенос Azure 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, существуют руководства по миграции для каждой основной версии.

Вариант 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.

Поддержка Enable-AzureRmAlias не будет прекращена с прекращением поддержки модуля AzureRM PowerShell.

Дальнейшие шаги

• Автоматическая миграция скриптов PowerShell
• Знакомство с модулем Az PowerShell
• Изменения между AzureRM и Az
• Установите модуль Az PowerShell.
• \Деинсталлируйте AzureRM \