Udostępnij za pośrednictwem


Wprowadzenie do modułu Az programu PowerShell

Przegląd

Moduł Az programu PowerShell to zestaw poleceń cmdlet do zarządzania zasobami Azure bezpośrednio z poziomu programu PowerShell. PowerShell oferuje zaawansowane funkcje automatyzacji, które mogą być wykorzystywane do zarządzania zasobami Azure, na przykład w kontekście potoku CI/CD.

Moduł Az programu PowerShell zastępuje moduł AzureRM i jest zalecanym modułem do interakcji z Azure.

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.

Moduł Az programu PowerShell można użyć z jedną z następujących metod:

Features

Moduł Az programu PowerShell oferuje następujące korzyści:

  • Bezpieczeństwo i stabilność
    • Szyfrowanie pamięci podręcznej tokenu
    • Zapobieganie atakom typu man-in-the-middle
    • Obsługa uwierzytelniania w usłudze ADFS 2019
    • Uwierzytelnianie nazwy użytkownika i hasła w programie PowerShell 7
    • Obsługa funkcji, takich jak ciągła ocena dostępu
  • Obsługa wszystkich usług Azure
    • Wszystkie ogólnie dostępne usługi Azure mają odpowiedni obsługiwany moduł programu PowerShell
    • Wiele poprawek błędów i uaktualnień wersji interfejsu API od czasu modułu AzureRM
  • Nowe możliwości
    • Wsparcie w Cloud Shell i międzyplatformowe.
    • Może uzyskać token dostępu i używać go do uzyskiwania dostępu do zasobów Azure
    • Cmdlet dostępny do zaawansowanych operacji REST-owych z zasobami Azure

Uwaga / Notatka

Program PowerShell w wersji 7.2 lub nowszej jest zalecaną wersją programu PowerShell do użycia z modułem Az programu PowerShell na wszystkich platformach.

Moduł Az programu PowerShell jest oparty na bibliotece .NET Standard i współpracuje z programem PowerShell 7.2 lub nowszym na wszystkich platformach, w tym Windows, Linux i macOS. Jest również zgodny z programem Windows PowerShell 5.1.

Zobowiązujemy się do wprowadzenia obsługi programu Azure na wszystkich platformach, a wszystkie moduły Az programu PowerShell działają na różnych platformach.

Uaktualnianie środowiska do modułu Az

Aby nadążyć za najnowszymi funkcjami Azure w programie PowerShell, należy przeprowadzić migrację do modułu Az. Jeśli moduł Az nie jest gotowy do zainstalowania jako zamiennik modułu AzureRM, dostępnych jest kilka opcji eksperymentowania z modułem Az:

  • Użyj środowiska PowerShell z Azure Cloud Shell. Azure Cloud Shell to środowisko powłoki oparte na przeglądarce, posiadające zainstalowany moduł Az oraz włączone aliasy zgodności.
  • Zachowaj moduł AzureRM zainstalowany w programie Windows PowerShell 5.1 i zainstaluj moduł Az w programie PowerShell 7 lub nowszym. Windows PowerShell 5.1 i PowerShell 7 oraz nowsze używają oddzielnych kolekcji modułów. Postępuj zgodnie z instrukcjami, aby zainstalować najnowszą wersję programu PowerShell , a następnie zainstalować moduł Az z programu PowerShell 7 lub nowszego.

Aby przeprowadzić uaktualnienie z istniejącej instalacji modułu AzureRM:

  1. Odinstaluj moduł AzureRM Azure PowerShell
  2. Instalowanie modułu Az programu PowerShell
  3. OPCJONALNIE: Włącz tryb zgodności, aby dodać aliasy dla poleceń cmdlet modułu AzureRM za pomocą polecenia Enable-AzureRMAlias , gdy zapoznasz się z nowym zestawem poleceń. Aby uzyskać więcej informacji, zobacz następną sekcję lub Rozpocznij migrację z modułu AzureRM do modułu Az.

Migrowanie istniejących skryptów z modułu AzureRM do modułu Az

Jeśli skrypty są nadal oparte na module AzureRM, mamy kilka zasobów, które ułatwiają migrację:

Wspieralność

Moduł Az jest najbardziej aktualnym modułem programu PowerShell dla Azure. Problemy lub żądania funkcji można zarejestrować bezpośrednio w repozytorium GitHub lub za pośrednictwem wsparcia technicznego Microsoft, jeśli masz abonament wsparcia technicznego. Prośby o dodanie funkcji są zaimplementowane w najnowszej wersji Az. Krytyczne problemy są rozwiązywane w dwóch ostatnich wersjach Az.

Moduły Az programu PowerShell mają teraz wszystkie możliwości modułów AzureRM PowerShell i nie tylko, dlatego z dniem 29 lutego 2024 r. wycofaliśmy moduły AzureRM PowerShell.

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

Zbieranie danych

Azure PowerShell domyślnie zbiera dane telemetryczne. Microsoft agreguje zebrane dane w celu identyfikowania wzorców użycia w celu identyfikowania typowych problemów i ulepszania środowiska Azure PowerShell. Firma Microsoft Azure PowerShell nie zbiera żadnych danych prywatnych ani osobowych. Na przykład dane użycia pomagają identyfikować problemy, takie jak cmdlets o niskiej skuteczności, i pomagają ustalać priorytety naszej pracy.

Doceniamy szczegółowe informacje, jakie są udostępniane przez te dane, ale rozumiemy również, że nie każdy chce wysyłać dane dotyczące użycia. Można wyłączyć zbieranie danych za pomocą polecenia Disable-AzDataCollection cmdlet. Aby dowiedzieć się więcej, przeczytaj nasze zasady zachowania poufności informacji.