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

  • Artykuł

Wszystkie wersje modułu AzureRM programu PowerShell są nieaktualne. Moduł Az programu PowerShell jest obecnie zalecanym modułem programu PowerShell na potrzeby interakcji z platformą Azure.

Uwaga

Ponieważ moduły Az programu PowerShell mają teraz wszystkie możliwości modułów programu PowerShell modułu AzureRM i nie tylko, wycofamy moduły programu AzureRM PowerShell 29 lutego 2024 r.

Aby uniknąć przerw w działaniu usługi, zaktualizuj skrypty korzystające z modułów programu AzureRM PowerShell, aby użyć modułów Az programu PowerShell do 29 lutego 2024 r. Aby automatycznie zaktualizować skrypty, postępuj zgodnie z przewodnikiem Szybki start.

Dlaczego wprowadzamy nowy moduł?

Największa i najważniejsza zmiana wiąże się z tym, że program PowerShell oparty na bibliotece .NET Standard stał się produktem dla wielu platform od czasu jego wprowadzenia.

Podobnie jak w przypadku języka programu PowerShell, dążymy do tego, aby pomoc techniczna platformy Azure była możliwa na wszystkich platformach. Nasze zobowiązanie oznaczało konieczność aktualizacji modułów programu Azure PowerShell, aby korzystały z biblioteki .NET Standard i były zgodne z programem PowerShell Core. Zamiast modyfikować istniejący moduł AzureRM i wprowadzać złożone zmiany w celu dodania tej obsługi, utworzyliśmy moduł Az.

Ponadto utworzenie nowego modułu pozwoliło naszym inżynierom na uspójnienie projektu, nazw poleceń cmdlet oraz modułów. Wszystkie moduły rozpoczynają się teraz prefiksem Az., a wszystkie polecenia cmdlet używają konwencji nazewnictwa Verb-AzNoun. Wcześniej nazwy poleceń cmdlet były dłuższe i niespójne.

Liczba modułów została również zmniejszona: niektóre moduły, które współpracowały z tymi samymi usługami, zostały połączone. Polecenia cmdlet płaszczyzny zarządzania i płaszczyzny danych w ramach tej samej usługi są teraz zawarte w pojedynczym module. Ta konsolidacja znacznie upraszcza pracę osobom, które ręcznie zarządzają zależnościami i importowaniem.

Wprowadzając te istotne zmiany, zespół zobowiązał się do uproszczenia korzystania z platformy Azure za pomocą poleceń cmdlet programu PowerShell oraz zapewnienia obsługi na jak największej liczbie platform niż kiedykolwiek wcześniej.

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.

Instalowanie zestawu narzędzi do migracji modułu AzureRM do Az

Install-Module -Name Az.Tools.Migration

Automatyczne konwertowanie skryptów

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