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

Перед выполнением действий по миграции определите, какие версии 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