Update-AzConfig

Aggiornamenti le configurazioni di Azure PowerShell.

Sintassi

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>]

Descrizione

Aggiornamenti le configurazioni di Azure PowerShell. A seconda della configurazione da aggiornare, è possibile specificare l'ambito in cui la configurazione è persistente e a quale modulo o cmdlet si applica.

Nota

È sconsigliato aggiornare le configurazioni in più processi di PowerShell. Eseguire questa operazione in un unico processo o assicurarsi che gli aggiornamenti si trovino nell'ambito processo (-Scope Process) per evitare effetti collaterali imprevisti.

Esempio

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

Imposta la configurazione "DefaultSubscriptionForLogin" come "Nome della sottoscrizione". Quando Connect-AzAccount la sottoscrizione specificata verrà selezionata come sottoscrizione predefinita.

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

Imposta la configurazione "DisplayBreakingChangeWarnings" come "$false" per il modulo "Az.KeyVault". In questo modo, tutti i messaggi di avviso per le modifiche di rilievo imminenti nel modulo Az.KeyVault non vengono richiesti.

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

Imposta la configurazione "EnableDataCollection" come "$true". In questo modo è possibile inviare i dati di telemetria. L'impostazione di questa configurazione equivale a Enable-AzDataCollection e Disable-AzDataCollection.

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

Imposta la configurazione "DisplaySecretsWarning" come "$true". In questo modo viene abilitato il rilevamento dei segreti durante l'esecuzione del cmdlet e viene visualizzato un messaggio di avviso se vengono trovati segreti nell'output.

Parametri

-AppliesTo

Specifica a quale parte di Azure PowerShell si applica la configurazione. I valori possibili sono:

  • "Az": la configurazione si applica a tutti i moduli e i cmdlet di Azure PowerShell.
  • Nome modulo: la configurazione si applica a un determinato modulo di Azure PowerShell. Ad esempio, "Az.Archiviazione".
  • Nome del cmdlet: la configurazione si applica a un determinato cmdlet di Azure PowerShell. Ad esempio, "Get-AzKeyVault". Se non specificato, quando si ottengono o cancellano le configurazioni, per impostazione predefinita viene impostato su tutti i valori precedenti; durante l'aggiornamento, per impostazione predefinita è "Az".
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckForUpgrade

Se abilitata, Azure PowerShell verificherà automaticamente la disponibilità degli aggiornamenti e visualizzerà un messaggio di suggerimento quando è disponibile un aggiornamento. Il valore predefinito è true.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-DefaultSubscriptionForLogin

Nome della sottoscrizione o GUID. Imposta il contesto predefinito per Azure PowerShell durante l'accesso senza specificare una sottoscrizione.

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

-DisableErrorRecordsPersistence

Se disabilitato, i record di errore non verranno scritti in ~/. Azure/ErrorRecords. Questa configurazione verrà sostituita da "EnableErrorRecordsPersistence" come consenso esplicito nella prossima versione principale di Az intorno a novembre 2023.

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

-DisableInstanceDiscovery

Impostare su true per disabilitare sia l'individuazione dell'istanza che la convalida dell'autorità. Questa funzionalità è destinata all'uso in scenari in cui non è possibile raggiungere l'endpoint dei metadati, ad esempio nei cloud privati o in Azure Stack. Il processo di individuazione dell'istanza comporta il recupero dei metadati dell'autorità da https://login.microsoft.com/ per convalidare l'autorità. Impostando questa proprietà su true, la convalida dell'autorità è disabilitata. Di conseguenza, è fondamentale assicurarsi che l'host dell'autorità configurata sia valido e attendibile.

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

-DisplayBreakingChangeWarning

Controlla se i messaggi di avviso per le modifiche di rilievo vengono visualizzati o eliminati. Se abilitata, viene visualizzato un avviso di modifica di rilievo durante l'esecuzione di cmdlet con modifiche di rilievo in una versione futura.

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

-DisplayRegionIdentified

Se abilitata, Azure PowerShell visualizza raccomandazioni sulle aree che possono ridurre i costi.

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

-DisplaySecretsWarning

Se abilitata, viene visualizzato un messaggio di avviso quando l'output del cmdlet contiene segreti. Per altre informazioni: 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

Se abilitata, viene richiesto raramente di partecipare ai sondaggi dell'esperienza utente per Azure PowerShell.

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

-EnableDataCollection

Se abilitata, i cmdlet di Azure PowerShell inviano dati di telemetria a Microsoft per migliorare l'esperienza del cliente. Per altre informazioni, vedere l'informativa sulla privacy: https://aka.ms/privacy

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

-EnableLoginByWam

[Anteprima] Se abilitata, Gestione account Web (WAM) sarà l'esperienza di accesso interattiva predefinita. Verrà eseguito il fallback all'uso del browser se la piattaforma non supporta WAM. Si noti che questa funzionalità è in anteprima. L'account Microsoft (MSA) non è attualmente supportato. È possibile contattare il team di Azure PowerShell se si hanno commenti e suggerimenti: https://aka.ms/azpsissue

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

-Scope

Determina l'ambito delle modifiche alla configurazione, ad esempio se le modifiche si applicano solo al processo corrente o a tutte le sessioni avviate dall'utente. Per impostazione predefinita, è 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

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

Boolean

String

Output

PSConfig