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>]
      [-DisableInstanceDiscovery <Boolean>]
      [-DisplayBreakingChangeWarning <Boolean>]
      [-DisplayRegionIdentified <Boolean>]
      [-DisplaySecretsWarning <Boolean>]
      [-DisplaySurveyMessage <Boolean>]
      [-EnableDataCollection <Boolean>]
      [-EnableErrorRecordsPersistence <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.

Not

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 väljs den angivna prenumerationen 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

-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

-EnableErrorRecordsPersistence

När det är aktiverat skrivs felposter till ~/. Azure/ErrorRecords.

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

-LoginExperienceV2

Endast aktiv när du autentiserar interaktivt tillåter användaren att välja den prenumeration och klientorganisation som används i efterföljande kommandon. Möjliga värden annons "På" (standard) och "Av". "På" kräver användarens indata. Av använder den första klientorganisationen och prenumerationen som returneras av Azure, kan ändras utan föregående meddelande och leda till kommandokörning i en oönskad kontext (rekommenderas inte).

Typ:LoginExperienceConfig
Godkända värden:On, Off
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örs. 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