Konfigurowanie ustawień globalnych programu Azure PowerShell

  • Artykuł

Program Azure PowerShell obsługuje kilka ustawień globalnych, takich jak wyłączanie komunikatów ostrzegawczych o zmianach powodujących niezgodność. Przed modułem Az programu PowerShell w wersji 9 nie było scentralizowanego ani szczegółowego sposobu konfigurowania ustawień globalnych dla programu Azure PowerShell.

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, które są skuteczne tylko w określonym zakresie. Prawidłowe wartości parametru Scope to:

  • Current User. Wartość domyślna 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ść została 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. Za pomocą parametru AppliedTo można określić, jak szerokie ma być zastosowane ustawienie. Wartość Az wskazuje, że ustawienie jest stosowane do wszystkich dostępnych modułów, które są częścią programu Azure PowerShell.

Aby wyłączyć komunikat ostrzegawczy zmiany powodującej niezgodność 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.

Subskrypcja domyślna

Domyślnie podczas uwierzytelniania na platformie Azure pobierane są wszystkie subskrypcje, do których masz dostęp. Pierwsza subskrypcja zwrócona przez platformę Azure jest używana, chyba że określisz subskrypcję z wartością Connect-AzAccount. Takie zachowanie może być niebezpieczne, na przykład jeśli pierwsza zwrócona subskrypcja jest środowiskiem produkcyjnym.

Aby skonfigurować subskrypcję domyślną, użyj Update-AzConfig polecenia cmdlet z parametrem DefaultSubscriptionForLogin , 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.

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

Identyfikacja regionów platformy Azure

Klienci platformy Azure mogą zdecydować się na wdrożenie zasobów w wielu różnych regionach. W niektórych przypadkach klienci mogą zmniejszyć 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 z regionem do wybrania dla przyszłych wdrożeń.

Komunikat z zaleceniem dotyczący wyłączania regionu

W poniższym przykładzie Update-AzConfig polecenie cmdlet służy do wyłączania komunikatu zalecenia dotyczącego regionu:

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.

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