Update-AzConfig
Aggiorna 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
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.
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.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".
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DefaultProfile
Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.
| Tipo: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DefaultSubscriptionForLogin
Nome della sottoscrizione o GUID. Imposta il contesto predefinito per Azure PowerShell durante l'accesso senza specificare una sottoscrizione.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-DisplayRegionIdentified
Se abilitata, Azure PowerShell visualizza raccomandazioni sulle aree che possono ridurre i costi.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-DisplaySurveyMessage
Se abilitata, viene richiesto raramente di partecipare ai sondaggi dell'esperienza utente per Azure PowerShell.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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.
| Tipo: | ConfigScope |
| Valori accettati: | CurrentUser, Process, Default, Environment |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |