Delen via


Update-AzConfig

Hiermee worden de configuraties van Azure PowerShell bijgewerkt.

Syntax

Default (Standaard)

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

Hiermee worden de configuraties van Azure PowerShell bijgewerkt. Afhankelijk van de configuratie die moet worden bijgewerkt, kunt u het bereik opgeven waarop de configuratie wordt bewaard en op welke module of cmdlet deze van toepassing is.

Opmerking

Het wordt afgeraden om configuraties in meerdere PowerShell-processen bij te werken. Doe dit in één proces of zorg ervoor dat de updates zich op procesbereik (-Scope Process) bevinden om onverwachte bijwerkingen te voorkomen.

Voorbeelden

Voorbeeld 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…

Hiermee stelt u de configuratie DefaultSubscriptionForLogin in als 'Naam van abonnement'. Wanneer Connect-AzAccount het opgegeven abonnement wordt geselecteerd als het standaardabonnement.

Voorbeeld 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,…

Hiermee stelt u de configuratie 'DisplayBreakingChangeWarnings' in op '$false' voor de module Az.KeyVault. Hiermee voorkomt u dat alle waarschuwingsberichten voor aanstaande belangrijke wijzigingen in de Az.KeyVault-module worden gevraagd.

Voorbeeld 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…

Hiermee stelt u de configuratie 'EnableDataCollection' in op '$true'. Hierdoor kunnen de telemetriegegevens worden verzonden. Het instellen van deze configuratie is gelijk aan Enable-AzDataCollection en Disable-AzDataCollection.

Voorbeeld 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…

Hiermee stelt u de configuratie 'DisplaySecretsWarning' in op '$true'. Hierdoor wordt de detectie van geheimen tijdens de uitvoering van de cmdlet ingeschakeld en wordt er een waarschuwingsbericht weergegeven als er geheimen in de uitvoer worden gevonden.

Parameters

-AppliesTo

Hiermee geeft u op op welk deel van Azure PowerShell de configuratie van toepassing is. Mogelijke waarden zijn:

  • 'Az': de configuratie is van toepassing op alle modules en cmdlets van Azure PowerShell.
  • Modulenaam: de configuratie is van toepassing op een bepaalde module van Azure PowerShell. Bijvoorbeeld 'Az.Storage'.
  • Cmdlet-naam: de configuratie is van toepassing op een bepaalde cmdlet van Azure PowerShell. Bijvoorbeeld 'Get-AzKeyVault'. Als dit niet is opgegeven, wordt bij het verkrijgen of wissen van configuraties standaard ingesteld op alle bovenstaande; bij het bijwerken wordt standaard 'Az' gebruikt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-CheckForUpgrade

Wanneer deze optie is ingeschakeld, controleert Azure PowerShell automatisch op updates en wordt er een hintbericht weergegeven wanneer er een update beschikbaar is. De standaardwaarde is waar.

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultSubscriptionForLogin

Abonnementsnaam of GUID. Hiermee stelt u de standaardcontext voor Azure PowerShell in wanneer u zich aanmeldt zonder een abonnement op te geven.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DisableInstanceDiscovery

Stel deze in op True om zowel de detectie van exemplaren als de validatie van de instantie uit te schakelen. Deze functionaliteit is bedoeld voor gebruik in scenario's waarin het eindpunt voor metagegevens niet kan worden bereikt, zoals in privéclouds of Azure Stack. Het proces van exemplaardetectie omvat het ophalen van instantiemetagegevens van https://login.microsoft.com/ om de instantie te valideren. Door dit in te stellen op waar, wordt de validatie van de instantie uitgeschakeld. Als gevolg hiervan is het van cruciaal belang om ervoor te zorgen dat de geconfigureerde instantiehost geldig en betrouwbaar is.

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DisplayBreakingChangeWarning

Hiermee bepaalt u of waarschuwingsberichten voor wijzigingen die fouten veroorzaken, worden weergegeven of onderdrukt. Wanneer deze optie is ingeschakeld, wordt er een waarschuwing voor belangrijke wijzigingen weergegeven bij het uitvoeren van cmdlets met belangrijke wijzigingen in een toekomstige release.

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DisplayRegionIdentified

Wanneer azure PowerShell is ingeschakeld, worden aanbevelingen weergegeven voor regio's die uw kosten kunnen verlagen.

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DisplaySecretsWarning

Wanneer deze optie is ingeschakeld, wordt er een waarschuwingsbericht weergegeven wanneer de cmdlet-uitvoer geheimen bevat. Meer informatie vindt u op {0}

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DisplaySurveyMessage

Wanneer deze optie is ingeschakeld, wordt u niet vaak gevraagd om deel te nemen aan enquêtes voor gebruikerservaring voor Azure PowerShell.

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-EnableDataCollection

Wanneer deze functie is ingeschakeld, verzenden Azure PowerShell-cmdlets telemetriegegevens naar Microsoft om de klantervaring te verbeteren. Zie onze privacyverklaring voor meer informatie: https://aka.ms/privacy

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-EnableErrorRecordsPersistence

Wanneer deze optie is ingeschakeld, worden foutrecords naar ~/geschreven. Azure/ErrorRecords.

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-EnableLoginByWam

[Preview] Wanneer deze functie is ingeschakeld, is Web Account Manager (WAM) de standaard interactieve aanmeldingservaring. Het wordt teruggezet op het gebruik van de browser als het platform GEEN ONDERSTEUNING biedt voor WAM. Houd er rekening mee dat deze functie in preview is. Microsoft-account (MSA) wordt momenteel niet ondersteund. Neem contact op met het Azure PowerShell-team als u feedback hebt: https://aka.ms/azpsissue

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-LoginExperienceV2

Alleen actief bij het interactief verifiëren, stelt de gebruiker in staat om het abonnement en de tenant te kiezen die in volgende opdrachten worden gebruikt. Mogelijke waarden ad 'Aan' (standaard) en 'Uit'. 'Aan' vereist invoer van de gebruiker. 'Uit' gebruikt de eerste tenant en het abonnement dat door Azure wordt geretourneerd, kunnen zonder kennisgeving worden gewijzigd en leiden tot uitvoering van opdrachten in een ongewenste context (niet aanbevolen).

Parametereigenschappen

Type:LoginExperienceConfig
Default value:None
Geaccepteerde waarden:On, Off
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Scope

Bepaalt het bereik van configuratiewijzigingen, bijvoorbeeld of wijzigingen alleen van toepassing zijn op het huidige proces of op alle sessies die door deze gebruiker zijn gestart. Standaard is dit CurrentUser.

Parametereigenschappen

Type:ConfigScope
Default value:None
Geaccepteerde waarden:CurrentUser, Process, Default, Environment
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

Boolean

String

Uitvoerwaarden

PSConfig