Konfigurowanie ustawień globalnych programu Azure PowerShell
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