Dela via


Update-AzConfig

Uppdaterar 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

Uppdaterar 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".
Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

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

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultSubscriptionForLogin

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DisplayRegionIdentified

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

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DisplaySurveyMessage

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

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:ConfigScope
Godkända värden:CurrentUser, Process, Default, Environment
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

Boolean

String

Utdata

PSConfig