Migrowanie programu Azure PowerShell z modułu AzureRM do modułu Az
Ostrzeżenie
Moduł AzureRM PowerShell został oficjalnie wycofany z dniem 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.
Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani wspierany, co oznacza, że dalsze korzystanie odbywa się na własne ryzyko użytkownika. Zapoznaj się z naszymi zasobami migracji , aby uzyskać wskazówki dotyczące przejścia do modułu Az.
Określanie, czy używasz modułu AzureRM PowerShell
Użyj następującego polecenia, aby określić, czy masz zainstalowany moduł AzureRM PowerShell:
Get-Module -Name AzureRM -ListAvailable
Możesz również przeprowadzić wyszukiwanie pełnotekstowe skryptów dla wzorca *-AzureRM*
, aby określić, czy którykolwiek z nich korzysta z modułu AzureRM PowerShell.
Uaktualnij moduł Az programu PowerShell
Skrypty napisane dla poleceń cmdlet modułu AzureRM nie będą automatycznie działać z modułem Az. Aby ułatwić przejście, opracowano zestaw narzędzi AzureRM to Az migration toolkit. Migracja do nowego zestawu poleceń nigdy nie jest wygodna, ale ten artykuł pomoże Ci rozpocząć przechodzenie do modułu Az programu PowerShell. Aby dowiedzieć się więcej o tym, dlaczego moduł Az programu PowerShell został utworzony, zobacz Wprowadzenie do modułu Az programu PowerShell.
Nowe nazwy poleceń cmdlet zostały zaprojektowane tak, aby były łatwe do nauki. Zamiast używać AzureRm
lub Azure
w nazwach poleceń cmdlet, użyj Az
. Na przykład stare polecenie cmdlet New-AzureRMVm
stało się New-AzVm
.
Jednak migracja to nie tylko zapoznanie się z nowymi nazwami cmdletów. Zmieniono nazwy modułów, parametrów i innych ważnych zmian.
Aby zobaczyć pełną listę zmian łamiących zgodność między modułem AzureRM i modułem Az, zobacz pełne zmiany z modułu AzureRM do modułu Az.
Upewnij się, że istniejące skrypty działają z najnowszą wersją modułu AzureRM
Przed podjęciem jakichkolwiek kroków migracji określ, jakie wersje modułu AzureRM są zainstalowane w systemie. Dzięki temu można upewnić się, że skrypty działają już na najnowszej wersji i uzyskać informację, które wersje modułu AzureRM należy odinstalować.
Aby określić, jakie wersje modułu AzureRM zostały zainstalowane, uruchom następujący przykład:
Get-Module -Name AzureRM -ListAvailable -All
Najnowsza dostępna wersja modułu AzureRM to 6.13.2. Jeśli nie masz zainstalowanej tej wersji, istniejące skrypty mogą wymagać dodatkowych modyfikacji, aby działały z modułem Az poza zakresem tego, co zostało opisane w tym artykule i na liście zmian niekompatybilnych.
Jeśli skrypty nie działają z modułem AzureRM 6.13.2, zaktualizuj je zgodnie z przewodnikiem migracji AzureRM 5.x do wersji 6.x. Jeśli używasz starszej wersji modułu AzureRM, dostępne są przewodniki migracji dla każdej wersji głównej.
Opcja 1 (zalecana): automatyczna migracja skryptów programu PowerShell
Ta zalecana opcja minimalizuje nakład pracy wymagany do migracji skryptów modułu AzureRM do modułu Az.
Za pomocą zestawu narzędzi AzureRM to Az migration toolkit można wygenerować plan określający, jakie zmiany będą wykonywane na skryptach przed wprowadzeniem do nich jakichkolwiek modyfikacji i przed zainstalowaniem modułu Az programu PowerShell.
Szybki start: Przewodnik Automatyczne migrowanie skryptów PowerShell z modułu AzureRM do Az przeprowadzi Cię przez cały proces automatycznego aktualizowania skryptów z AzureRM do modułu Az PowerShell.
Opcja 2. Używanie trybu zgodności z Enable-AzureRmAlias
Moduł Az ma tryb zgodności, który ułatwia korzystanie z istniejących skryptów podczas aktualizacji do nowej składni. Polecenie cmdlet Enable-AzureRmAlias umożliwia tryb zgodności za pośrednictwem aliasów. Ten tryb umożliwia używanie istniejących skryptów z minimalnymi modyfikacjami podczas pracy nad pełną migracją do modułu Az. Domyślnie Enable-AzureRmAlias
włącza tylko aliasy zgodności dla bieżącej sesji programu PowerShell. Użyj parametru Scope
, aby utrwałyć aliasy zgodności między sesjami programu PowerShell. Aby uzyskać więcej informacji, zobacz dokumentację referencyjną Enable-AzureRmAlias.
Ważny
Mimo że nazwy poleceń cmdlet są aliasami, nadal mogą wystąpić nowe (lub zmienione) parametry lub zmienione wartości zwrotne dla poleceń cmdlet Az. Nie oczekuj, że samo włączenie aliasów załatwi za Ciebie migrację. Zobacz pełną listę istotnych zmian , aby znaleźć miejsca, gdzie Twoje skrypty mogą wymagać aktualizacji.
Obsługa Enable-AzureRmAlias
nie zostanie wycofana z wycofaniem modułu AzureRM PowerShell.