Update-AzConfig
Aktualizuje konfiguracje programu Azure PowerShell.
Składnia
Update-AzConfig
[-AppliesTo <String>]
[-Scope <ConfigScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-CheckForUpgrade <Boolean>]
[-DefaultSubscriptionForLogin <String>]
[-DisableInstanceDiscovery <Boolean>]
[-DisplayBreakingChangeWarning <Boolean>]
[-DisplayRegionIdentified <Boolean>]
[-DisplaySecretsWarning <Boolean>]
[-DisplaySurveyMessage <Boolean>]
[-EnableDataCollection <Boolean>]
[-EnableErrorRecordsPersistence <Boolean>]
[-EnableLoginByWam <Boolean>]
[<CommonParameters>] Opis
Aktualizuje konfiguracje programu Azure PowerShell. W zależności od konfiguracji do zaktualizowania można określić zakres, w którym konfiguracja jest utrwalone, oraz do którego modułu lub polecenia cmdlet ma zastosowanie.
Nuta
Nie zaleca się aktualizowania konfiguracji w wielu procesach programu PowerShell. Wykonaj to w jednym procesie lub upewnij się, że aktualizacje znajdują się w zakresie procesu (-Scope Process), aby uniknąć nieoczekiwanych skutków ubocznych.
Przykłady
Przykład 1
Update-AzConfig -DefaultSubscriptionForLogin "Name of subscription"
Key Value Applies To Scope Help Message
--- ----- ---------- ----- ------------
DefaultSubscriptionForLogin Name of subscription Az CurrentUser Subscription name or GUID. Sets the default context for Azure PowerShell when lo…Ustawia konfigurację "DefaultSubscriptionForLogin" jako "Nazwa subskrypcji". Po Connect-AzAccount określona subskrypcja zostanie wybrana jako domyślna subskrypcja.
Przykład 2
Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo "Az.KeyVault"
Key Value Applies To Scope Help Message
--- ----- ---------- ----- ------------
DisplayBreakingChangeWarning False Az.KeyVault CurrentUser Controls if warning messages for breaking changes are displayed or suppressed. When enabled,…Ustawia konfigurację "DisplayBreakingChangeWarnings" jako "$false" dla modułu "Az.KeyVault". Zapobiega to monitowaniu wszystkich komunikatów ostrzegawczych dotyczących nadchodzących zmian powodujących niezgodność w module Az.KeyVault.
Przykład 3
Update-AzConfig -EnableDataCollection $true
Key Value Applies To Scope Help Message
--- ----- ---------- ----- ------------
EnableDataCollection True Az CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the customer experi…Ustawia konfigurację "EnableDataCollection" jako "$true". Umożliwia to wysyłanie danych telemetrycznych.
Ustawienie tej konfiguracji jest równoważne Enable-AzDataCollection i Disable-AzDataCollection.
Przykład 4
Update-AzConfig -DisplaySecretsWarning $true
Key Value Applies To Scope Help Message
--- ----- ---------- ----- ------------
DisplaySecretsWarning True Az CurrentUser When enabled, a warning message for secrets redaction will be displ…Ustawia konfigurację "DisplaySecretsWarning" jako "$true". Umożliwia to wykrywanie wpisów tajnych podczas wykonywania polecenia cmdlet i wyświetla komunikat ostrzegawczy, jeśli jakiekolwiek wpisy tajne zostaną znalezione w danych wyjściowych.
Parametry
-AppliesTo
Określa, do której części programu Azure PowerShell ma zastosowanie konfiguracja. Możliwe wartości to:
- "Az": konfiguracja ma zastosowanie do wszystkich modułów i poleceń cmdlet programu Azure PowerShell.
- Nazwa modułu: konfiguracja ma zastosowanie do określonego modułu programu Azure PowerShell. Na przykład "Az.Storage".
- Nazwa polecenia cmdlet: konfiguracja ma zastosowanie do określonego polecenia cmdlet programu Azure PowerShell. Na przykład "Get-AzKeyVault". Jeśli nie zostanie określony, podczas pobierania lub czyszczenia konfiguracji wartość domyślna to wszystkie powyższe wartości; podczas aktualizowania wartość domyślna to "Az".
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-CheckForUpgrade
Po włączeniu programu Azure PowerShell będzie automatycznie sprawdzać dostępność aktualizacji i wyświetlać komunikat wskazówek po udostępnieniu aktualizacji. Wartość domyślna to true.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DefaultSubscriptionForLogin
Nazwa subskrypcji lub identyfikator GUID. Ustawia domyślny kontekst programu Azure PowerShell podczas logowania bez określania subskrypcji.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DisableInstanceDiscovery
Ustaw wartość true, aby wyłączyć zarówno odnajdywanie wystąpień, jak i walidację urzędu. Ta funkcja jest przeznaczona do użycia w scenariuszach, w których nie można uzyskać dostępu do punktu końcowego metadanych, na przykład w chmurach prywatnych lub w usłudze Azure Stack. Proces odnajdywania wystąpień wiąże się z pobieraniem metadanych urzędu z https://login.microsoft.com/ w celu zweryfikowania urzędu. Ustawiając wartość true, walidacja urzędu jest wyłączona. W związku z tym niezwykle ważne jest upewnienie się, że skonfigurowany host urzędu jest prawidłowy i godny zaufania.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DisplayBreakingChangeWarning
Określa, czy komunikaty ostrzegawcze dotyczące zmian powodujących niezgodność są wyświetlane lub pomijane. Po włączeniu ustawienia zmiany powodującej niezgodność jest wyświetlane podczas wykonywania poleceń cmdlet z powodu zmian powodujących niezgodność w przyszłej wersji.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DisplayRegionIdentified
Po włączeniu program Azure PowerShell wyświetla zalecenia dotyczące regionów, które mogą obniżyć koszty.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DisplaySecretsWarning
Po włączeniu komunikat ostrzegawczy zostanie wyświetlony, gdy dane wyjściowe polecenia cmdlet zawierają wpisy tajne. Dowiedz się więcej na https://go.microsoft.com/fwlink/?linkid=2258844
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DisplaySurveyMessage
Po włączeniu często pojawia się monit o uczestnictwo w ankietach środowiska użytkownika dla programu Azure PowerShell.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-EnableDataCollection
Po włączeniu polecenia cmdlet programu Azure PowerShell wysyłają dane telemetryczne do firmy Microsoft, aby poprawić jakość obsługi klienta. Aby uzyskać więcej informacji, zobacz nasze zasady zachowania poufności informacji: https://aka.ms/privacy
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-EnableErrorRecordsPersistence
Po włączeniu rekordy błędów zostaną zapisane na ~/. Azure/ErrorRecords.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-EnableLoginByWam
[Wersja zapoznawcza] Po włączeniu menedżera kont sieci Web (WAM) będzie domyślnym interaktywnym środowiskiem logowania. Jeśli platforma nie obsługuje WAM, wróci do korzystania z przeglądarki. Pamiętaj, że ta funkcja jest w wersji zapoznawczej. Konto Microsoft (MSA) nie jest obecnie obsługiwane. Jeśli masz jakiekolwiek opinie, możesz skontaktować się z zespołem programu Azure PowerShell: https://aka.ms/azpsissue
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-LoginExperienceV2
Tylko aktywne podczas uwierzytelniania interakcyjnego umożliwia użytkownikowi wybranie subskrypcji i dzierżawy używanej w kolejnych poleceniach. Możliwe wartości reklamy "Włączone" (ustawienie domyślne) i "Wyłączone". Wartość "Włączone" wymaga danych wejściowych użytkownika. Opcja "Wyłączone" będzie używać pierwszej dzierżawy i subskrypcji zwróconej przez platformę Azure, może ulec zmianie bez powiadomienia i prowadzić do wykonywania poleceń w niepożądanym kontekście (niezalecane).
| Typ: | LoginExperienceConfig |
| Dopuszczalne wartości: | On, Off |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Scope
Określa zakres zmian konfiguracji, na przykład, czy zmiany mają zastosowanie tylko do bieżącego procesu, czy do wszystkich sesji uruchomionych przez tego użytkownika. Domyślnie jest to CurrentUser.
| Typ: | ConfigScope |
| Dopuszczalne wartości: | CurrentUser, Process, Default, Environment |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
