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 programu PowerShell nie było scentralizowanej ani szczegółowej metody konfigurowania tych ustawień globalnych.

Konfiguracja scentralizowana

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

Szczegółowe ustawienia

Możesz zastosować ustawienia obowiązujące w określonym zakresie. Prawidłowe wartości parametru Scope 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 konfigurowana 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. Za pomocą parametru AppliedTo można 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 *-AzConfig pomocą poleceń cmdlet. 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 *-AzConfig pomocą poleceń cmdlet.

Get-AzConfig | Format-List

Powiadomienia o uaktualnieniu

Powiadomienia w narzędziu dotyczące uaktualnień wersji programu Azure PowerShell to funkcja wydana w module Az programu 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 Get-AzConfig polecenia cmdlet 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 Update-AzConfig polecenia cmdlet 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 Update-AzConfig polecenia cmdlet z parametrem CheckForUpgrade i $false 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 programu 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 Update-AzConfig polecenia cmdlet z parametrem DefaultSubscriptionForLogin , aby ustawić domyślną subskrypcję, jak pokazano w poniższym przykładzie.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Uwaga

Nie należy mylić z subskrypcją kontekstu domyślnego, konfiguracja DefaultSubscriptionForLogin ma zastosowanie tylko podczas uwierzytelniania na platformie Azure.

Odnajdywanie wystąpień

Ustawienie wyłącz odnajdywanie wystąpień jest przeznaczone dla sytuacji, w których punkt końcowy metadanych jest niedostępny, na przykład w chmurach prywatnych lub środowiskach usługi Azure Stack. Odnajdywanie wystąpień obejmuje pobieranie metadanych urzędu z https://login.microsoft.com/ , aby zweryfikować urząd. Po włączeniu tego ustawienia (ustawieniu go na true), należy wyłączyć 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ę urzędu, włącz to ustawienie (ustaw je na wartość true).

Update-AzConfig -DisableInstanceDiscovery $true

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

Aby wyłączyć komunikaty ostrzegawcze dotyczące zmiany powodującej niezgodność dla poleceń cmdlet we wszystkich modułach Az , użyj Update-AzConfig polecenia cmdlet z parametrem DisplayBreakingChangeWarning , jak pokazano w poniższym przykładzie:

Update-AzConfig -DisplayBreakingChangeWarning $false

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

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

W tym scenariuszu komunikat ostrzegawczy o zmianie powodującej niezgodność pozostaje aktywny dla poleceń cmdlet we wszystkich modułach az programu PowerShell z wyjątkiem modułu 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 zalecenia dotyczące regionu, użyj Update-AzConfig polecenia cmdlet z parametrem DisplayRegionIdentified , jak pokazano w poniższym przykładzie.

Update-AzConfig -DisplayRegionIdentified $false

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

Wyświetlanie ostrzeżeń o wpisach tajnych

Program Azure PowerShell domyślnie wyświetla komunikat ostrzegawczy rozpoczynający się od wersji 12.0.0, aby ułatwić ochronę poufnych informacji podczas identyfikowania potencjalnego wpisu tajnego w danych wyjściowych polecenia.

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

Update-AzConfig -DisplaySecretsWarning $false

Ankiety

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ą Update-AzConfig polecenia cmdlet, 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ć środowisko klienta. 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 pliku $HOME/.Azure/ErrorRecords.

Aby wyłączyć trwałe rekordy błędów, użyj Update-AzConfig polecenia cmdlet 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 programu 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 lub w systemie Windows Server 2019 i nowszych z modułem Az 12.0.0 lub nowszym, należy wyłączyć wam do użycia 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 programu PowerShell w wersji 12.0.0, jeśli masz dostęp do wielu subskrypcji, zostanie wyświetlony monit o wybranie subskrypcji platformy Azure do zalogowania się.

Gdy nowe środowisko logowania jest wyłączone i masz dostęp do wielu subskrypcji, logujesz się do pierwszej subskrypcji platformy Azure, chyba że określisz subskrypcję z usługą 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 środowisko logowania, użyj Update-AzConfig polecenia cmdlet , 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ć Export-AzConfig polecenia cmdlet , aby wyeksportować ustawienia do pliku JSON.

Export-AzConfig -Path $HOME\AzConfig.json

Aby zaimportować ustawienia, użyj Import-AzConfig polecenia cmdlet 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 do wartości domyślnej, użyj Clear-AzConfig polecenia cmdlet . W poniższym przykładzie wyczyszczone jest ustawienie DefaultSubscriptionForLogin .

Clear-AzConfig -DefaultSubscriptionForLogin