Omówienie modułu Az.Tools.Migration programu PowerShell

Moduł Az.Tools.Migration programu PowerShell ułatwia przejście ze starszego modułu AzureRM do nowszego modułu Az , który jest zalecany do zarządzania platformą Azure.

Ważne

Moduł AzureRM PowerShell jest przestarzały od 29 lutego 2024 r.

Firma Microsoft wprowadziła moduł Az.Tools.Migration w odpowiedzi na opinie klientów, szczególnie dotyczące nakładu pracy wymaganej do zaktualizowania skryptów, które zostały pierwotnie napisane dla modułu AzureRM. Uznając, że wielu klientów zainwestowało w tworzenie złożonych skryptów dla środowisk platformy Azure, utworzono narzędzie Az.Tools.Migration , aby usprawnić i zautomatyzować proces migracji, zmniejszając w ten sposób ręczne obciążenie i potencjalne błędy podczas uaktualniania skryptów.

Jak używać modułu Az.Tools.Migration

Proces korzystania z narzędzia Az.Tools.Migration obejmuje kilka kroków:

1. Aktualizacja do modułu AzureRM w wersji 6.13.1: Przed użyciem narzędzia Az.Tools.Migration użytkownicy muszą upewnić się, że skrypty są aktualizowane do modułu AzureRM w wersji 6.13.1, ostatniej wersji przed migracją do modułu Az .

2. Instalowanie narzędzia Az.Tools.Migration: moduł można zainstalować z Galeria programu PowerShell za Install-Module -Name Az.Tools.Migration pomocą polecenia .

3. Generowanie planu uaktualnienia: New-AzUpgradeModulePlan polecenie cmdlet generuje plan uaktualnienia. Nie zmienia on istniejących skryptów, ale udostępnia ścieżkę uaktualniania przez utworzenie planu zawierającego szczegółowe informacje o określonych plikach i punktach przesunięcia wymagających aktualizacji. To polecenie cmdlet przyjmuje parametry, takie jak FilePath i DirectoryPath, aby kierować określone skrypty lub foldery.

4. Przeglądanie planu uaktualniania: przed wykonaniem uaktualnienia należy zapoznać się z planem wszelkich potencjalnych problemów, które mogą uniemożliwić automatyczne uaktualnienia, takie jak polecenia korzystające z wplatania, i w razie potrzeby ręcznie je poprawić.

5. Wykonanie uaktualnienia: po przejrzeniu i rozwiązaniu wszelkich problemów rzeczywiste uaktualnienie jest wykonywane przy użyciu Invoke-AzUpgradeModulePlan polecenia cmdlet . To polecenie cmdlet może modyfikować istniejące pliki lub, bezpieczniej, zapisywać zmiany w nowych plikach z _az_upgraded dołączonym do ich nazw, aby zachować oryginalne skrypty.

Aby zapewnić bezproblemową migrację, zaleca się tworzenie kopii zapasowych skryptów przed wykonaniem uaktualnień, ponieważ Invoke-AzUpgradeModulePlan polecenie cmdlet może być destrukcyjne, jeśli nie jest używane z opcją -FileEditMode SaveChangesToNewFiles .

Zachęcamy użytkowników do przekazywania opinii lub zgłaszania problemów z procesem migracji w repozytorium GitHub na potrzeby migracji azure-powershell-migration.