Udostępnij za pośrednictwem

Migrowanie programu Azure PowerShell z modułu AzureRM do modułu Az

  • Artykuł

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.

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.

Następne kroki