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