Update-AzConfig

Moduł:

Az.Accounts Module

Aktualizuje konfiguracje Azure PowerShell.

Składnia

Default (domyślnie)

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 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.

Uwaga / Notatka

Nie zaleca się aktualizowania konfiguracji w wielu procesach programu PowerShell. Zrób 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". Gdy 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 parametrom 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 Azure PowerShell ma zastosowanie konfiguracja. Dopuszczalne wartości:

• "Az": konfiguracja ma zastosowanie do wszystkich modułów i poleceń cmdlet Azure PowerShell.
• Nazwa modułu: konfiguracja ma zastosowanie do określonego modułu Azure PowerShell. Na przykład "Az.Storage".
• Nazwa polecenia cmdlet: konfiguracja ma zastosowanie do określonego polecenia cmdlet 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".

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-CheckForUpgrade

Po włączeniu Azure PowerShell automatycznie sprawdzi dostępność aktualizacji i wyświetli komunikat wskazówek, gdy aktualizacja jest dostępna. Wartość domyślna to true.

Właściwości parametru

Typ:	Boolean
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	por

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z Azure.

Właściwości parametru

Typ:	IAzureContextContainer
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-DefaultSubscriptionForLogin

Nazwa subskrypcji lub identyfikator GUID. Ustawia domyślny kontekst dla Azure PowerShell podczas logowania bez określania subskrypcji.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	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 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.

Właściwości parametru

Typ:	Boolean
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	Boolean
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-DisplayRegionIdentified

Po włączeniu Azure PowerShell wyświetla zalecenia dotyczące regionów, które mogą zmniejszyć koszty.

Właściwości parametru

Typ:	Boolean
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-DisplaySecretsWarning

Po włączeniu komunikat ostrzegawczy zostanie wyświetlony, gdy dane wyjściowe polecenia cmdlet zawierają wpisy tajne. Dowiedz się więcej na stronie https://go.microsoft.com/fwlink/?linkid=2258844

Właściwości parametru

Typ:	Boolean
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-DisplaySurveyMessage

Po włączeniu jest wyświetlany monit o częste uczestnictwo w ankietach środowiska użytkownika dla Azure PowerShell.

Właściwości parametru

Typ:	Boolean
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-EnableDataCollection

Po włączeniu polecenia cmdlet Azure PowerShell wysyłają dane telemetryczne do Microsoft w celu poprawy jakości obsługi klienta. Aby uzyskać więcej informacji, zobacz nasze zasady zachowania poufności informacji: https://aka.ms/privacy

Właściwości parametru

Typ:	Boolean
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-EnableErrorRecordsPersistence

Po włączeniu rekordy błędów zostaną zapisane na ~/. Azure/ErrorRecords.

Właściwości parametru

Typ:	Boolean
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	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. Możesz skontaktować się z zespołem Azure PowerShell, jeśli masz jakieś opinie: https://aka.ms/azpsissue

Właściwości parametru

Typ:	Boolean
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	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 Azure, może ulec zmianie bez powiadomienia i prowadzić do wykonywania poleceń w niepożądanym kontekście (niezalecane).

Właściwości parametru

Typ:	LoginExperienceConfig
Domyślna wartość:	None
Dopuszczalne wartości:	On, Off
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	ConfigScope
Domyślna wartość:	None
Dopuszczalne wartości:	CurrentUser, Process, Default, Environment
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Wi

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

Boolean

String

Dane wyjściowe

PSConfig