Share via


Update-AzConfig

Hiermee worden de configuraties van Azure PowerShell bijgewerkt.

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

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.

Notitie

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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultSubscriptionForLogin

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

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

-DisableErrorRecordsPersistence

Als deze optie is uitgeschakeld, worden foutrecords niet naar ~/geschreven. Azure/ErrorRecords. Deze configuratie wordt vervangen door EnableErrorRecordsPersistence als opt-in in de volgende grote release van Az rond november 2023.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 metagegevens van de instantie om https://login.microsoft.com/ 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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-DisplayRegionIdentified

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

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

-DisplaySecretsWarning

Wanneer deze optie is ingeschakeld, wordt er een waarschuwingsbericht weergegeven wanneer de cmdlet-uitvoer geheimen bevat. Meer informatie vindt u op 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

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:ConfigScope
Accepted values:CurrentUser, Process, Default, Environment
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

Boolean

String

Uitvoerwaarden

PSConfig