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 użycia 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, a wszelkie dalsze użycie odbywa się na ryzyko i odpowiedzialność 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.

Aktualizacja 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ć 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 obejmuje więcej niż tylko zapoznanie się z nowymi nazwami poleceń cmdlet. Zmieniono nazwy modułów, parametrów i innych ważnych zmian.

Aby wyświetlić pełną listę zmian powodujących niezgodność 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 są już uruchomione w najnowszej wersji oraz dowiedzieć 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 opisanym w tym artykule i na liście zmian powodujących przerwy w kompatybilności.

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 Automatyczne migrowanie skryptów programu PowerShell z modułu AzureRM do modułu Az programu PowerShell poprowadzi Cię przez cały proces automatycznej aktualizacji skryptów PowerShell z modułu AzureRM do modułu Az.

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, zobaczdokumentację referencyjną Enable-AzureRmAlias .

Ważny

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 wystarczy do wykonania migracji. Zobacz kompletną listę zmian niezgodnych , aby dowiedzieć się, gdzie Twoje skrypty mogą wymagać aktualizacji.

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

Następne kroki