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

  • Статья

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

Внимание

Модуль AzureRM PowerShell устарел с 29 февраля 2024 г.

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

Использование модуля Az.Tools.Migration

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

  1. Обновление до Версии 6.13.1. Перед использованием Az.Tools.Migration пользователи должны убедиться, что их скрипты обновляются до Версии 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.