Update-AzConfig
Aktualizuje konfigurace Azure PowerShellu.
Syntaxe
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>] Description
Aktualizuje konfigurace Azure PowerShellu. V závislosti na konfiguraci, která se má aktualizovat, můžete určit obor, ve kterém je konfigurace trvalá, a na který modul nebo rutinu se vztahuje.
Poznámka:
Nedoporučuje se aktualizovat konfigurace v několika procesech PowerShellu. Buď to udělejte v jednom procesu, nebo se ujistěte, že jsou aktualizace v oboru procesu (-Scope Process), aby se zabránilo neočekávaným vedlejším účinkům.
Příklady
Příklad 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…Nastaví konfiguraci DefaultSubscriptionForLogin na název předplatného. Když Connect-AzAccount se zadané předplatné vybere jako výchozí předplatné.
Příklad 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,…Nastaví konfiguraci DisplayBreakingChangeWarnings jako $false pro modul Az.KeyVault. Tím se zabrání zobrazení výzvy všech zpráv upozornění pro nadcházející zásadní změny v modulu Az.KeyVault.
Příklad 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…Nastaví konfiguraci EnableDataCollection na "$true". To umožňuje odesílání telemetrických dat.
Nastavení této konfigurace je ekvivalentní hodnotě Enable-AzDataCollection a Disable-AzDataCollection.
Příklad 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…Nastaví konfiguraci DisplaySecretsWarning na "$true". To umožňuje detekci tajných kódů během provádění rutiny a zobrazí zprávu s upozorněním, pokud se ve výstupu nacházejí nějaké tajné kódy.
Parametry
-AppliesTo
Určuje, na jakou část Azure PowerShellu se konfigurace vztahuje. Možné hodnoty jsou:
- Az: Konfigurace se vztahuje na všechny moduly a rutiny Azure PowerShellu.
- Název modulu: Konfigurace se vztahuje na určitý modul Azure PowerShellu. Například Az.Storage.
- Název rutiny: Konfigurace se vztahuje na určitou rutinu Azure PowerShellu. Například Get-AzKeyVault. Pokud není zadáno, při získávání nebo vymazání konfigurací se ve výchozím nastavení použije všechny výše uvedené hodnoty; při aktualizaci se ve výchozím nastavení nastaví na Az.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-CheckForUpgrade
Pokud je tato možnost povolená, Azure PowerShell automaticky vyhledá aktualizace a zobrazí zprávu nápovědy, když je k dispozici aktualizace. Výchozí hodnota je true.
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DefaultSubscriptionForLogin
Název předplatného nebo identifikátor GUID. Nastaví výchozí kontext Azure PowerShellu při přihlašování bez zadání předplatného.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-DisableInstanceDiscovery
Nastavte hodnotu true, aby se zakázalo zjišťování instancí i ověřování autority. Tato funkce je určená pro použití ve scénářích, kdy není možné dosáhnout koncového bodu metadat, například v privátních cloudech nebo ve službě Azure Stack. Proces zjišťování instancí zahrnuje načtení metadat autority z https://login.microsoft.com/ ověření autority. Když tuto hodnotu nastavíte na true, ověření autority je zakázané. V důsledku toho je důležité zajistit, aby byl nakonfigurovaný hostitel autority platný a důvěryhodný.
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-DisplayBreakingChangeWarning
Určuje, jestli se zobrazují nebo potlačí zprávy upozornění na zásadní změny. Pokud je tato možnost povolená, zobrazí se při spouštění rutin s zásadními změnami v budoucí verzi upozornění na změnu způsobující chybu.
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-DisplayRegionIdentified
Když je tato možnost povolená, Azure PowerShell zobrazí doporučení pro oblasti, které můžou snížit náklady.
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-DisplaySecretsWarning
Pokud je tato možnost povolená, zobrazí se zpráva s upozorněním, když výstup rutiny obsahuje tajné kódy. Další informace najdete na adrese https://go.microsoft.com/fwlink/?linkid=2258844
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-DisplaySurveyMessage
Pokud je tato možnost povolená, budete vyzváni zřídka k účasti v průzkumech uživatelského prostředí pro Azure PowerShell.
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-EnableDataCollection
Pokud je tato možnost povolená, rutiny Azure PowerShellu odesílají do Microsoftu telemetrická data, aby se zlepšilo uživatelské prostředí. Další informace najdete v našem prohlášení o zásadách ochrany osobních údajů: https://aka.ms/privacy
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-EnableErrorRecordsPersistence
Pokud je tato možnost povolená, zapíšou se do ~/. Azure/ErrorRecords.
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-EnableLoginByWam
[Preview] Pokud je tato možnost povolená, bude výchozím interaktivním přihlašováním správce webových účtů (WAM). Pokud platforma nepodporuje WAM, vrátí se zpět do prohlížeče. Upozorňujeme, že tato funkce je ve verzi Preview. Účet Microsoft (MSA) se v současné době nepodporuje. Pokud máte nějaké připomínky, můžete se obrátit na tým Azure PowerShellu: https://aka.ms/azpsissue
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-LoginExperienceV2
Pouze aktivní při interaktivním ověřování umožňuje uživateli zvolit předplatné a tenanta použitého v následných příkazech. Možné hodnoty ad "Zapnuto" (Výchozí) a "Vypnuto". Zapnuto vyžaduje vstup uživatele. Možnost Vypnuto použije první tenanta a předplatné vrácené Azure, může se bez předchozího upozornění změnit a vést k provádění příkazů v nežádoucím kontextu (nedoporučuje se).
| Typ: | LoginExperienceConfig |
| Přípustné hodnoty: | On, Off |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Scope
Určuje rozsah změn konfigurace, například zda se změny vztahují pouze na aktuální proces, nebo na všechny relace spuštěné tímto uživatelem. Ve výchozím nastavení je to CurrentUser.
| Typ: | ConfigScope |
| Přípustné hodnoty: | CurrentUser, Process, Default, Environment |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
Výstupy
Azure PowerShell