Condividi tramite

Update-AzConfig

Modulo:
Az.Accounts Module

Aggiorna le configurazioni di Azure PowerShell.

Sintassi

Default (Impostazione predefinita) 

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

Descrizione

Aggiorna 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.

Annotazioni

È 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.Storage".
  • 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".

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultSubscriptionForLogin

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DisplayRegionIdentified

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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DisplaySecretsWarning

Se abilitata, viene visualizzato un messaggio di avviso quando l'output del cmdlet contiene segreti. Per saperne di più su https://go.microsoft.com/fwlink/?linkid=2258844

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DisplaySurveyMessage

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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-EnableErrorRecordsPersistence

Se abilitata, i record di errore verranno scritti in ~/. Azure/ErrorRecords.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-LoginExperienceV2

Solo attivo durante l'autenticazione interattiva, consente all'utente di scegliere la sottoscrizione e il tenant usati nei comandi successivi. Valori possibili annuncio 'On' (Default) e 'Off'. 'On' richiede l'input dell'utente. 'Off' userà il primo tenant e la sottoscrizione restituita da Azure, può cambiare senza preavviso e portare all'esecuzione dei comandi in un contesto indesiderato (non consigliato).

Proprietà dei parametri

Tipo:LoginExperienceConfig
Valore predefinito:None
Valori accettati:On, Off
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:ConfigScope
Valore predefinito:None
Valori accettati:CurrentUser, Process, Default, Environment
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

Boolean

String

Output

PSConfig