Update-AzConfig

Uppdateringar konfigurationerna för Azure PowerShell.

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

Uppdateringar konfigurationerna för Azure PowerShell. Beroende på vilken konfiguration som ska uppdateras kan du ange omfånget där konfigurationen finns kvar och vilken modul eller cmdlet den gäller för.

Kommentar

Det rekommenderas inte att uppdatera konfigurationer i flera PowerShell-processer. Gör det antingen i en process eller se till att uppdateringarna finns i Processomfång (-Scope Process) för att undvika oväntade biverkningar.

Exempel

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

Anger konfigurationen "DefaultSubscriptionForLogin" som "Prenumerationsnamn". När Connect-AzAccount den angivna prenumerationen väljs som standardprenumeration.

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

Anger konfigurationen "DisplayBreakingChangeWarnings" som "$false" för modulen "Az.KeyVault". Detta hindrar alla varningsmeddelanden för kommande icke-bakåtkompatibla ändringar i Az.KeyVault-modulen från att fråga.

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

Anger konfigurationen "EnableDataCollection" som "$true". Detta gör det möjligt att skicka telemetridata. Inställningen av den här konfigurationen motsvarar Enable-AzDataCollection och Disable-AzDataCollection.

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

Anger konfigurationen "DisplaySecretsWarning" som "$true". Detta möjliggör identifiering av hemligheter under cmdlet-körningen och visar ett varningsmeddelande om några hemligheter hittas i utdata.

Parametrar

-AppliesTo

Anger vilken del av Azure PowerShell som konfigurationen gäller för. Möjliga värden är:

  • "Az": konfigurationen gäller för alla moduler och cmdletar i Azure PowerShell.
  • Modulnamn: konfigurationen gäller för en viss modul i Azure PowerShell. Till exempel "Az.Storage".
  • Cmdlet-namn: konfigurationen gäller för en viss cmdlet av Azure PowerShell. Till exempel "Get-AzKeyVault". Om det inte anges, när du hämtar eller rensar konfigurationer, är det standardvärdet för alla ovanstående. när du uppdaterar standardvärdet "Az".
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckForUpgrade

När det är aktiverat söker Azure PowerShell efter uppdateringar automatiskt och visar ett tipsmeddelande när en uppdatering är tillgänglig. Standardvärdet är sant.

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-DefaultSubscriptionForLogin

Prenumerationsnamn eller GUID. Anger standardkontexten för Azure PowerShell när du loggar in utan att ange en prenumeration.

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

-DisableErrorRecordsPersistence

När det är inaktiverat skrivs inte felposter till ~/. Azure/ErrorRecords. Den här konfigurationen kommer att ersättas av "EnableErrorRecordsPersistence" som opt-in i nästa större version av Az runt november 2023.

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

-DisableInstanceDiscovery

Ange värdet true för att inaktivera både instansidentifiering och verifiering av utfärdare. Den här funktionen är avsedd att användas i scenarier där metadataslutpunkten inte kan nås, till exempel i privata moln eller Azure Stack. Processen för instansidentifiering innebär att auktoritetsmetadata hämtas från https://login.microsoft.com/ för att verifiera utfärdaren. Genom att ställa in detta på sant inaktiveras verifieringen av utfärdaren. Därför är det viktigt att se till att den konfigurerade utfärdarvärden är giltig och tillförlitlig.

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

-DisplayBreakingChangeWarning

Styr om varningsmeddelanden för icke-bakåtkompatibla ändringar visas eller ignoreras. När den är aktiverad visas en varning om icke-bakåtkompatibel ändring vid körning av cmdletar med icke-bakåtkompatibla ändringar i en framtida version.

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

-DisplayRegionIdentified

När det är aktiverat visar Azure PowerShell rekommendationer för regioner som kan minska dina kostnader.

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

-DisplaySecretsWarning

När det är aktiverat visas ett varningsmeddelande när cmdlet-utdata innehåller hemligheter. Läs mer på 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

När du är aktiverad uppmanas du sällan att delta i användarupplevelseundersökningar för Azure PowerShell.

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

-EnableDataCollection

När de är aktiverade skickar Azure PowerShell-cmdletar telemetridata till Microsoft för att förbättra kundupplevelsen. Mer information finns i vår sekretesspolicy: https://aka.ms/privacy

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

-EnableLoginByWam

[Förhandsversion] När det är aktiverat blir Web Account Manager (WAM) den interaktiva standardinloggningsupplevelsen. Det återgår till att använda webbläsaren om plattformen inte stöder WAM. Observera att den här funktionen är under förhandsversion. Microsoft-konto (MSA) stöds för närvarande inte. Kontakta Azure PowerShell-teamet om du har feedback: https://aka.ms/azpsissue

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

-Scope

Avgör omfånget för konfigurationsändringar, till exempel om ändringar endast gäller för den aktuella processen eller för alla sessioner som startas av den här användaren. Som standard är det 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

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

Boolean

String

Utdata

PSConfig