Udostępnij za pośrednictwem

Wprowadzenie do modułu Az dla programu PowerShell

  • Artykuł

Przegląd

Moduł Az programu PowerShell to zestaw cmdletów do zarządzania zasobami platformy Azure bezpośrednio w PowerShellu. PowerShell udostępnia zaawansowane funkcje automatyzacji, które można wykorzystać do zarządzania zasobami platformy Azure, na przykład w kontekście potoku CI/CD.

Moduł Az programu PowerShell jest zamiennikiem modułu AzureRM i jest zalecanym modułem używanym do interakcji z platformą Azure.

Ostrzeżenie

Moduł AzureRM PowerShell oficjalnie wycofano 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 jest już utrzymywany ani obsługiwany, co oznacza, że wszelkie dalsze użycie odbywa się na ryzyko i według uznania 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:

Funkcje

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 platformy Azure
    • Wszystkie ogólnie dostępne usługi platformy 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
    • Obsługa w usłudze Cloud Shell i międzyplatformowa
    • Może uzyskać token dostępu i używać go do uzyskiwania dostępu do zasobów platformy Azure
    • Cmdlet dostępny do zaawansowanych operacji REST z zasobami platformy Azure

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.

Dokładamy wszelkich starań, aby zapewnić obsługę platformy Azure wszystkim platformom, a wszystkie moduły Az programu PowerShell są międzyplatformowe.

Zaktualizuj swoje środowisko do Az

Aby nadążyć za najnowszymi funkcjami platformy 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 usługą Azure Cloud Shell. Azure Cloud Shell to oparte na przeglądarce środowisko powłoki, które jest dostarczane z zainstalowanym modułem Az i włączonymi aliasami zgodności Enable-AzureRM.
  • Zachowaj moduł AzureRM zainstalowany w programie Windows PowerShell 5.1 i zainstaluj moduł Az w programie PowerShell 7 lub nowszym. Program Windows PowerShell 5.1 i program PowerShell 7 lub nowszy 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 programu Azure PowerShell
  2. Instalowanie modułu Az programu PowerShell
  3. opcjonalne: włącz tryb kompatybilności, aby dodać aliasy dla poleceń cmdlet modułu AzureRM za pomocą Enable-AzureRMAlias podczas zapoznawania 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ę:

Podatność na wsparcie

Moduł Az jest najbardziej aktualnym modułem programu PowerShell dla platformy Azure. Problemy lub żądania funkcji można zgłosić bezpośrednio w repozytorium GitHub, lub za pośrednictwem pomocy technicznej firmy Microsoft, jeśli posiadasz umowę wspierającą. Żądania funkcji są implementowane w najnowszej wersji modułu 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 wycofujemy moduły AzureRM PowerShell z dniem 29 lutego 2024 r.

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

Zbieranie danych

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

Chociaż doceniamy szczegółowe informacje, które udostępniają te dane, rozumiemy również, że nie wszyscy chcą wysyłać dane użycia. Zbieranie danych można wyłączyć za pomocą polecenia cmdlet Disable-AzDataCollection. Aby dowiedzieć się więcej, przeczytaj nasze oświadczenie o ochronie prywatności.