Udostępnij za pośrednictwem

Konfigurowanie ustawień globalnych programu Azure PowerShell

  • Artykuł

Program Azure PowerShell oferuje różne ustawienia globalne, takie jak opcja wyłączania komunikatów ostrzegawczych o zmianach powodujących niezgodność. Przed wersją 9 modułu Az PowerShell nie było scentralizowanej ani szczegółowej metody konfigurowania tych ustawień globalnych.

Scentralizowana konfiguracja

Moduł Az PowerShell w wersji 9 i nowszej zawiera polecenia cmdlet do zarządzania konfiguracją ustawień globalnych dla programu Azure PowerShell. Te polecenia cmdlet *-AzConfig są częścią modułu Az.Accounts PowerShell:

Szczegółowe ustawienia

Możesz zastosować ustawienia obowiązujące w określonym zakresie. Prawidłowe wartości parametru zakresu to:

  • Current User: zakres domyślny podczas stosowania ustawienia.
  • Process: ustawienie jest stosowane tylko do bieżącej sesji programu PowerShell.
  • Default: zakres tylko do odczytu, w którym wartość domyślna nie została zmieniona.
  • Environment: zakres tylko do odczytu, w którym wartość jest skonfigurowana za pośrednictwem zmiennej środowiskowej.

Oprócz zakresów można zastosować ustawienia do wszystkich modułów Az programu PowerShell lub tylko jednego modułu. Korzystając z parametru AppliedTo, możesz określić, jak szerokie ma być stosowane ustawienie. Wartość Az wskazuje, że ustawienie jest stosowane do wszystkich modułów, które są częścią programu Azure PowerShell.

Opcje konfiguracji

Istnieje wiele opcji konfiguracji, które można ustawić za pomocą poleceń cmdlet *-AzConfig. Wiele z tych opcji konfiguracji jest wyświetlanych w tej sekcji. Uruchom następujące polecenie, aby wyświetlić pełną listę opcji konfiguracji programu Azure PowerShell, które można ustawić za pomocą poleceń cmdlet *-AzConfig.

Get-AzConfig | Format-List

Powiadomienia o uaktualnieniu

Powiadomienia w narzędziu dotyczące uaktualnień wersji programu Azure PowerShell to funkcja wydana w module Az PowerShell w wersji 10.3.0. Gdy jest dostępna nowa wersja programu Azure PowerShell, w interakcyjnej sesji programu PowerShell zostanie wyświetlone powiadomienie o uaktualnieniu.

Aby określić, czy powiadomienia o uaktualnieniu są włączone, użyj polecenia cmdlet Get-AzConfig z parametrem CheckForUpgrade, jak pokazano w poniższym przykładzie.

Get-AzConfig -CheckForUpgrade

Aby włączyć powiadomienia o uaktualnieniu dla programu Azure PowerShell, użyj polecenia cmdlet Update-AzConfig z parametrem CheckForUpgrade i $true dla jego wartości, jak pokazano w poniższym przykładzie.

Update-AzConfig -CheckForUpgrade $true

Aby wyłączyć powiadomienia o uaktualnieniu, użyj polecenia cmdlet Update-AzConfig z parametrem CheckForUpgrade i $false dla jego wartości, jak pokazano w poniższym przykładzie.

Update-AzConfig -CheckForUpgrade $false

Subskrypcja domyślna

Domyślnie począwszy od modułu Az PowerShell w wersji 12.0.0, jeśli masz dostęp do wielu subskrypcji, zostanie wyświetlony monit o wybranie subskrypcji platformy Azure w celu zalogowania się.

Aby zapobiec monitowaniu o wybranie subskrypcji za każdym razem, gdy logujesz się interaktywnie, użyj polecenia cmdlet Update-AzConfig z DefaultSubscriptionForLogin parametru, aby ustawić subskrypcję domyślną, jak pokazano w poniższym przykładzie.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Notatka

Nie należy mylić z subskrypcją domyślnego kontekstu, konfiguracja DomyślnejSubskrypcjiForLogin stosuje się tylko przy uwierzytelnianiu w Azure.

Odkrywanie instancji

Opcja wyłączania wykrywania wystąpień jest zaprojektowana dla sytuacji, w których punkt końcowy metadanych jest niedostępny, na przykład w przypadku chmur prywatnych lub środowisk Azure Stack. Odnajdywanie wystąpień obejmuje pobieranie metadanych autorytetu z https://login.microsoft.com/ w celu zweryfikowania autorytetu. Po włączeniu tego ustawienia (ustawieniu go na true) wyłączasz zarówno odnajdywanie wystąpień, jak i walidację urzędu. W związku z tym należy upewnić się, że skonfigurowany host urzędu jest prawidłowy i godny zaufania.

Aby wyłączyć zarówno odnajdywanie wystąpień, jak i walidację autorytetu, włącz to ustawienie, ustawiając je na wartość true.

Update-AzConfig -DisableInstanceDiscovery $true

Komunikaty ostrzegawcze dotyczące zmiany powodującej niezgodność

Aby wyłączyć ostrzeżenia o zmianach niekompatybilnych dla poleceń cmdlet we wszystkich modułach Az, użyj polecenia cmdlet Update-AzConfig z parametrem DisplayBreakingChangeWarning, jak pokazano w poniższym przykładzie:

Update-AzConfig -DisplayBreakingChangeWarning $false

Aby wyłączyć komunikat ostrzegawczy o zmianie powodującej niezgodność specyficznie dla poleceń cmdlet w module Az.Compute, użyj polecenia cmdlet Update-AzConfig z parametrami DisplayBreakingChangeWarning i AppliesTo, jak pokazano w poniższym przykładzie:

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute

W tym scenariuszu komunikat ostrzegawczy dotyczący niekompatybilności pozostaje aktywny dla poleceń cmdlet we wszystkich modułach Az programu PowerShell z wyjątkiem Az.Compute.

Identyfikacja regionów platformy Azure

Klienci platformy Azure mogą zdecydować się na wdrożenie zasobów w kilku różnych regionach. Czasami klienci mogą obniżyć koszty, wybierając regiony w pobliżu oferujące te same usługi. Jeśli zostanie zidentyfikowany region w pobliżu, zostanie wyświetlony komunikat o regionie do wyboru dla przyszłych wdrożeń.

Aby wyłączyć komunikaty związane z zaleceniami dotyczącymi regionu, użyj polecenia cmdlet Update-AzConfig z parametrem DisplayRegionIdentified, zgodnie z poniższym przykładem.

Update-AzConfig -DisplayRegionIdentified $false

Aby uzyskać więcej informacji na temat regionów świadczenia usługi Azure, zobacz Wybieranie odpowiedniego regionu platformy Azure dla Ciebie.

Wyświetlanie ostrzeżeń o tajemnicach

Program Azure PowerShell domyślnie wyświetla komunikat ostrzegawczy, począwszy od wersji 12.0.0, aby pomóc chronić poufne informacje przy identyfikacji potencjalnej tajemnicy w danych wyjściowych polecenia.

W poniższym przykładzie polecenie cmdlet Update-AzConfig służy do wyłączania komunikatu ostrzegawczego.

Update-AzConfig -DisplaySecretsWarning $false

Badania

W przypadku korzystania z programu Azure PowerShell możesz zostać zaproszony do udziału w ankiecie, aby poinformować nas o swoim doświadczeniu. Chociaż doceniamy szczegółowe informacje, które udostępniają te dane, rozumiemy, że nie wszyscy chcą być monitowani o ukończenie ankiety.

Możesz wyłączyć monit o uczestnictwo w ankietach za pomocą polecenia cmdlet Update-AzConfig, jak pokazano w poniższym przykładzie.

Update-AzConfig -DisplaySurveyMessage $false

Zbieranie danych

Domyślnie polecenia cmdlet programu Azure PowerShell wysyłają dane telemetryczne do firmy Microsoft, aby poprawić doświadczenia użytkownika. Aby uzyskać więcej informacji, zobacz nasze zasady zachowania poufności informacji: aka.ms/privacy.

Update-AzConfig -EnableDataCollection $false

Rekordy błędów

Domyślnie rekordy błędów programu Azure PowerShell są zapisywane w $HOME/.Azure/ErrorRecords.

Aby wyłączyć trwałe rekordy błędów, użyj polecenia cmdlet Update-AzConfig z parametrem EnableErrorRecordsPersistence, jak pokazano w poniższym przykładzie.

Update-AzConfig -EnableErrorRecordsPersistence $false

Menedżer kont sieci Web (WAM)

Począwszy od modułu Az PowerShell w wersji 12.0.0, systemy Windows używają menedżera kont sieci Web (WAM), a systemy Linux i macOS domyślnie używają logowania opartego na przeglądarce.

Aby używać logowania opartego na przeglądarce w systemie Windows 10 lub nowszym albo w systemie Windows Server 2019 lub nowszym z Az 12.0.0 i nowszymi, należy wyłączyć WAM do użytku z programem Azure PowerShell. Użyj następującego polecenia, aby wyłączyć wam i powrócić do logowania opartego na przeglądarce, domyślnego przed az 12.0.0.

Update-AzConfig -EnableLoginByWam $false

Nowe środowisko logowania

Począwszy od modułu Az PowerShell w wersji 12.0.0, jeśli masz dostęp do wielu subskrypcji, zostanie wyświetlony monit o wybranie subskrypcji platformy Azure w celu zalogowania się.

Gdy nowe środowisko logowania jest wyłączone i masz dostęp do wielu subskrypcji, automatycznie zalogujesz się do pierwszej subskrypcji zwracanej przez platformę Azure, chyba że określisz subskrypcję za pomocą Connect-AzAccount. Polecenia są domyślnie uruchamiane względem tej subskrypcji. Takie zachowanie może być niebezpieczne, na przykład jeśli pierwsza zwrócona subskrypcja jest środowiskiem produkcyjnym.

Aby wyłączyć nowe doświadczenie logowania, użyj polecenia cmdlet Update-AzConfig, jak pokazano w poniższym przykładzie.

Update-AzConfig -LoginExperienceV2 Off

Ustawienia replikowania

Aby replikować ustawienia z jednego środowiska do innego, należy użyć polecenia cmdlet Export-AzConfig, aby wyeksportować ustawienia do pliku JSON.

Export-AzConfig -Path $HOME\AzConfig.json

Aby zaimportować ustawienia, użyj polecenia cmdlet Import-AzConfig i odwołaj się do wcześniej wyeksportowanego pliku JSON.

Import-AzConfig -Path $HOME\AzConfig.json

Czyszczenie konfiguracji

Aby zresetować ustawienie konfiguracji co najmniej jednego ustawienia globalnego programu Azure PowerShell domyślnie, użyj polecenia cmdlet Clear-AzConfig. W poniższym przykładzie ustawienie DefaultSubscriptionForLogin zostało wyczyszczone.

Clear-AzConfig -DefaultSubscriptionForLogin