Update-AzConfig
Aktualizace konfigurace Azure PowerShellu.
Syntax
Update-AzConfig
[-AppliesTo <String>]
[-Scope <ConfigScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-CheckForUpgrade <Boolean>]
[-DefaultSubscriptionForLogin <String>]
[-DisableErrorRecordsPersistence <Boolean>]
[-DisableInstanceDiscovery <Boolean>]
[-DisplayBreakingChangeWarning <Boolean>]
[-DisplayRegionIdentified <Boolean>]
[-DisplaySurveyMessage <Boolean>]
[-EnableDataCollection <Boolean>]
[-EnableLoginByWam <Boolean>]
[<CommonParameters>]
Description
Aktualizace 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Typ: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisableErrorRecordsPersistence
Pokud je tato možnost zakázaná, záznamy chyb nebudou zapsány do ~/. Azure/ErrorRecords. Tuto konfiguraci nahradí "EnableErrorRecordsPersistence" jako výslovný souhlas v příští hlavní verzi Az kolem listopadu 2023.
Typ: | Boolean |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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řijímané hodnoty: | CurrentUser, Process, Default, Environment |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |