Wprowadzenie do modułu Az programu PowerShell

  • Artykuł

Omówienie

Moduł Az programu PowerShell to zbiór poleceń cmdlet umożliwiających zarządzanie zasobami platformy Azure bezpośrednio z poziomu programu PowerShell. Program PowerShell udostępnia zaawansowane funkcje automatyzacji, które mogą być używane do zarządzania zasobami platformy Azure, na przykład w kontekście potoku ciągłej integracji/ciągłego wdrażania.

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 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 jest już utrzymywany ani obsługiwany, 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.

Możesz użyć modułu Az programu PowerShell przy użyciu jednej 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 tokenów
    • Zapobieganie atakom typu man-in-the-middle
    • Obsługa uwierzytelniania za pomocą usługi ADFS 2019
    • Uwierzytelnianie za pomocą 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ą odpowiadający im obsługiwany moduł programu PowerShell
    • Wiele poprawek usterek i uaktualnień wersji interfejsu API od czasu modułu AzureRM
  • Nowe możliwości
    • Obsługa w usłudze Cloud Shell i na wielu platformach
    • Możliwość uzyskania token dostępu i używania go w celu uzyskiwania dostępu do zasobów platformy Azure
    • Dostępne polecenie cmdlet do zaawansowanych operacji REST dla zasobów platformy Azure

Uwaga

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 on również zgodny z programem Windows PowerShell 5.1.

Dążymy do tego, aby pomoc techniczna platformy Azure była możliwa na wszystkich platformach, a wszystkie moduły Az programu PowerShell obsługiwane na wielu platformach.

Uaktualnienie środowiska do modułu Az

Aby być na bieżąco z najnowszymi funkcjami platformy Azure w programie PowerShell, przeprowadź migrację do modułu Az. Jeśli Twoje środowisko nie jest gotowe do zainstalowania modułu Az w celu zastąpienia modułu AzureRM, dostępnych jest kilka opcji umożliwiających eksperymentowanie z modułem Az:

  • Korzystaj ze środowiska PowerShell w usłudze Azure Cloud Shell. Usługa Azure Cloud Shell to środowisko powłoki oparte na przeglądarce, w którym zainstalowano moduł Az oraz włączono aliasy zapewniające zgodność przy użyciu polecenia cmdlet Enable-AzureRM.
  • Pozostaw moduł AzureRM zainstalowany w programie Windows PowerShell 5.1 i zainstaluj moduł Az dla programu PowerShell w wersji 7 lub nowszej. Programy Windows PowerShell 5.1 i PowerShell 7 lub nowsze korzystają z oddzielnych kolekcji modułów. Postępuj zgodnie z instrukcjami, aby zainstalować najnowszą wersję programu PowerShell, a następnie zainstaluj moduł Az z programu PowerShell 7 lub nowszego.

Aby uaktualnić istniejącą instalację modułu AzureRM:

  1. Odinstaluj moduł AzureRM programu 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 zapoznaj się z tematem Rozpoczynanie migracji z modułu AzureRM do modułu Az.

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

Jeśli skrypty nadal są oparte na module AzureRM, udostępniamy kilka zasobów ułatwiających migrację:

Możliwość obsługi

Moduł Az to najnowszy moduł programu PowerShell dla platformy Azure. Problemy lub żądania funkcji można rejestrować bezpośrednio w repozytorium GitHub lub za pośrednictwem pomocy technicznej firmy Microsoft, jeśli masz umowę pomocy technicznej. Żądania funkcji są implementowane w najnowszej wersji modułu Az. Krytyczne problemy są implementowane w dwóch ostatnich wersjach modułu Az.

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

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

Zbieranie danych

Domyślnie program Azure PowerShell zbiera dane telemetryczne. Firma Microsoft agreguje zebrane dane, aby wykrywać wzorce użycia i typowe problemy oraz usprawnić środowisko Azure PowerShell. Program Microsoft Azure PowerShell nie zbiera żadnych danych osobowych ani prywatnych. Na przykład dane użycia pomagają identyfikować problemy, takie jak polecenia cmdlet, które nie powiodły się, i ułatwiają określanie priorytetów 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. Zbieranie danych można wyłączyć za pomocą polecenia cmdlet Disable-AzDataCollection. Aby dowiedzieć się więcej, przeczytaj nasze zasady zachowania poufności informacji.