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

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 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 będzie już utrzymywany, otrzymywać aktualizacje lub pomoc techniczną, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka 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.

Uaktualnianie do modułu Az programu PowerShell

Skrypty napisane dla poleceń cmdlet modułu AzureRM nie będą automatycznie działać z modułem Az. Aby ułatwić przeniesienie, opracowano zestaw narzędzi do migracji modułu AzureRM do Az. Każda migracja do nowego zestawu poleceń jest kłopotliwa, jednak ten artykuł pomoże Ci rozpocząć przejście do modułu Az programu PowerShell. Aby dowiedzieć się więcej na temat przyczyn utworzenia modułu Az programu PowerShell, zobacz Wprowadzenie do nowego modułu Az usługi Azure PowerShell.

Nowe nazwy poleceń cmdlet zaprojektowano tak, aby były łatwe do zapamiętania. Zamiast używać ciągu AzureRm lub Azure w nazwach poleceń cmdlet, wystarczy użyć ciągu Az. Na przykład stare polecenie cmdlet New-AzureRMVm to teraz polecenie New-AzVm. Jednak migracja jest bardziej niż zapoznanie się z nowymi nazwami poleceń cmdlet. Zmieniono nazwy modułów i parametrów oraz wprowadzono inne ważne zmiany.

Aby wyświetlić pełną listę zmian powodujących niezgodność między modułami AzureRM i Az, zobacz wszystkie różnice między modułem AzureRM i Az.

Upewnianie 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 są już uruchomione w najnowszej wersji i poinformuj o tym, jakie 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

Najnowszadostępna wersja modułu AzureRM to 6.13.2. Jeśli ta wersja nie jest zainstalowana, może być konieczne dodatkowe zmodyfikowanie istniejących skryptów, aby działały z modułem Az, w sposób wykraczający poza zakres opisany 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 wcześniejszej wersji modułu AzureRM, dostępne są przewodniki migracji dla wszystkich wersji głównych.

Ta zalecana opcja minimalizuje nakład pracy wymagany do migracji skryptów modułu AzureRM do modułu Az.

Za pomocą zestawu narzędzi do migracji modułu AzureRM do Az można wygenerować plan określający, jakie zmiany zostaną wykonane w skryptach przed wprowadzeniem jakichkolwiek modyfikacji i przed zainstalowaniem modułu Az programu PowerShell.

Przewodnik Szybki start Automatyczne migrowanie skryptów programu PowerShell z modułu AzureRM do Az programu PowerShell przeprowadzi Cię przez cały proces automatycznego aktualizowania skryptów programu PowerShell z modułu AzureRM do Az programu PowerShell.

Opcja 2. Używanie trybu zgodności z opcją Enable-AzureRmAlias

Moduł Az oferuje tryb zgodności, który ułatwia korzystanie z istniejących skryptów podczas pracy nad aktualizacjami do nowej składni. Polecenie cmdlet Enable-AzureRmAlias włącza tryb zgodności przy użyciu aliasów. Ten tryb pozwala na użycie istniejących skryptów z minimalnymi zmianami podczas pracy nad pełną migracją do modułu Az. Domyślnie polecenie Enable-AzureRmAlias włącza tylko aliasy zgodności dla bieżącej sesji programu PowerShell. Użyj parametru Scope, aby zachować aliasy zgodności między sesjami programu PowerShell. Aby uzyskać więcej informacji, zobacz dokumentację dotyczącą polecenia Enable-AzureRmAlias.

Ważne

Chociaż dostępne są aliasy dla nazw poleceń cmdlet, w przypadku poleceń cmdlet modułu Az mogły zostać dodane (lub zmienione) parametry albo zmienione wartości zwracane. Nie oczekuj włączenia aliasów do obsługi migracji. Zobacz pełną listę zmian powodujących niezgodność, aby dowiedzieć się, w których miejscach skryptów trzeba wprowadzić aktualizacje.

Obsługa modułu Enable-AzureRmAlias AzureRM PowerShell nie zostanie wycofana.

Następne kroki