Обзор модуля Az.Tools.Migration PowerShell

Модуль Az.Tools.Migration PowerShell упрощает переход с более старого модуля AzureRM на новый модуль Az , который рекомендуется для управления Azure.

Корпорация Майкрософт представила Az.Tools.Migration в ответ на отзывы клиентов, особенно в отношении усилий, необходимых для обновления скриптов, которые изначально были написаны для AzureRM. Признавая, что многие клиенты инвестировали в создание сложных сценариев для сред Azure, Az.Tools.Migration был создан для упрощения и автоматизации процесса миграции, что позволяет сократить рабочую нагрузку вручную и вероятность возникновения ошибок во время обновления скриптов.

Как использовать модуль Az.Tools.Migration

Процесс использования Az.Tools.Migration состоит из нескольких этапов.

1. Обновление до AzureRM версии 6.13.1: Перед использованием Az.Tools.Migration пользователи должны убедиться, что их скрипты обновляются до AzureRM версии 6.13.1, последняя версия перед миграцией в модуль Az .

2. Установка Az.Tools.Migration: Модуль можно установить из коллекции PowerShell с помощью Install-Module -Name Az.Tools.Migration команды.

3. Создание плана обновления: Командлет New-AzUpgradeModulePlan создает план обновления. Он не изменяет существующие скрипты, но предоставляет путь обновления путем создания плана детализации определенных файлов и точек смещения, требующих обновлений. Этот командлет принимает такие параметры, как FilePath и DirectoryPath , для целевых сценариев или папок.

4. Просмотр плана обновления: Перед выполнением обновления важно проверить план на наличие любых потенциальных проблем, которые могут препятствовать автоматическому обновлению, например команд, использующих сплаттинг, и исправить их вручную при необходимости.

5. Выполнение обновления: после проверки и устранения любых проблем фактическое обновление выполняется с помощью командлета Invoke-AzUpgradeModulePlan . Этот командлет может изменить существующие файлы или, более безопасно, сохранить изменения в новых файлах с добавлением _az_upgraded к их именам, чтобы защитить исходные скрипты.

Чтобы обеспечить плавную миграцию, рекомендуется создавать резервные копии скриптов перед выполнением обновлений, так как Invoke-AzUpgradeModulePlan командлет может быть разрушительным, если он не используется с параметром -FileEditMode SaveChangesToNewFiles .

Пользователям рекомендуется предоставить отзывы или сообщить о проблемах с процессом миграции в репозитории GitHub проекта azure-powershell-migration.