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.
Type:String
Position:Named
Default value:None
Required: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required: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.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required: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.

Type:String
Position:Named
Default value:None
Required: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.

Type:Boolean
Position:Named
Default value:None
Required: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ý.

Type:Boolean
Position:Named
Default value:None
Required: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.

Type:Boolean
Position:Named
Default value:None
Required: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.

Type:Boolean
Position:Named
Default value:None
Required: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

Type:Boolean
Position:Named
Default value:None
Required: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.

Type:Boolean
Position:Named
Default value:None
Required: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

Type:Boolean
Position:Named
Default value:None
Required: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

Type:Boolean
Position:Named
Default value:None
Required: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.

Type:ConfigScope
Accepted values:CurrentUser, Process, Default, Environment
Position:Named
Default value:None
Required: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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

Boolean

String

Výstupy

PSConfig