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

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie uznany za przestarzały 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 obsługiwany, co oznacza, że wszelkie dalsze użytkowanie odbywa się na własną odpowiedzialność i 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ć pełnotekstowe wyszukiwanie w skryptach dla wzorca, 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 zostało zmienione na nowe. Migracja to coś więcej niż tylko zapoznanie się z nowymi nazwami poleceń cmdlet. Zmieniono nazwy modułów, parametrów i innych ważnych zmian.

Aby zobaczyć pełną listę przełomowych zmian między modułami AzureRM a Az, zobacz pełne zmiany z AzureRM do 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 mieć pewność, że skrypty są już uruchomione w najnowszej wersji oraz dowiesz się, które wersje modułu AzureRM muszą zostać odinstalowane.

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 pracować z modułem Az poza zakresem opisanych w tym artykule i na liście zmian powodujących niezgodność.

Jeśli skrypty nie działają z modułem AzureRM 6.13.2, zaktualizuj je zgodnie z przewodnikiem migracji modułu 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.

Przewodnik "Szybki start" dotyczący automatycznej migracji skryptów PowerShell z modułu AzureRM do modułu Az prowadzi Cię przez cały proces aktualizacji skryptów z AzureRM do Az w sposób automatyczny.

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 włącza tryb zgodności za pomocą 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 włącza tylko aliasy zgodności dla bieżącej sesji programu PowerShell. Użyj jego parametru, aby utrwalić aliasy zgodności między sesjami programu PowerShell. Aby uzyskać więcej informacji, zobacz dokumentację referencyjną Enable-AzureRmAlias.

Ważna

Mimo że nazwy poleceń cmdlet są aliasami, nadal mogą istnieć nowe (lub zmienione nazwy) parametry lub zmienione wartości zwracane dla poleceń cmdlet Az. Nie oczekuj, że samo włączenie aliasów załatwi proces migracji za Ciebie. Zobacz pełną listę istotnych zmian w funkcjonowaniu, aby dowiedzieć się, gdzie skrypty mogą wymagać aktualizacji.

Obsługa nie zostanie wycofana wraz z wycofaniem modułu AzureRM PowerShell.

Dalsze kroki

• Automatyczne migrowanie skryptów programu PowerShell
• Wprowadzenie do modułu Az programu PowerShell
• Zmiany między modułem AzureRM i modułem Az
• Instalowanie modułu Az PowerShell
• Odinstalowywanie modułu AzureRM