Condividi tramite


Get-AzConfig

Ottiene le configurazioni di Azure PowerShell.

Sintassi

Get-AzConfig
   [-AppliesTo <String>]
   [-Scope <ConfigScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-CheckForUpgrade]
   [-DefaultSubscriptionForLogin]
   [-DisableErrorRecordsPersistence]
   [-DisableInstanceDiscovery]
   [-DisplayBreakingChangeWarning]
   [-DisplayRegionIdentified]
   [-DisplaySurveyMessage]
   [-EnableDataCollection]
   [-EnableLoginByWam]
   [<CommonParameters>]

Descrizione

Ottiene le configurazioni di Azure PowerShell. Per impostazione predefinita, elenca tutte le configurazioni. È possibile filtrare il risultato usando vari parametri.

Nota

Le configurazioni hanno priorità. In generale, l'ambito del processo ha una priorità più alta rispetto all'ambito CurrentUser; Una configurazione applicabile a un determinato cmdlet ha una priorità più alta rispetto a quella applicata a un modulo, di nuovo superiore a Az. Per ridurre la confusione, il risultato di Get-AzConfig mostra le configurazioni effettive. È una combinazione di tutte le configurazioni, ma non letteralmente tutte le configurazioni. Tuttavia, è sempre possibile visualizzarli applicando parametri di filtro diversi, ad esempio -Scope.

Esempio

Esempio 1

Get-AzConfig

Key                           Value Applies To Scope       Help Message
---                           ----- ---------- -----       ------------
EnableDataCollection          False Az         CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the custom…
DefaultSubscriptionForLogin         Az         Default     Subscription name or GUID. Sets the default context for Azure PowerShell when logging in with…
DisplayBreakingChangeWarning  True  Az         Default     Controls if warning messages for breaking changes are displayed or suppressed. When enabled, …

Ottiene tutte le configurazioni.

Esempio 2

Get-AzConfig -EnableDataCollection

Key                           Value Applies To Scope       Help Message
---                           ----- ---------- -----       ------------
EnableDataCollection          False Az         CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the custom…

Ottiene la configurazione "EnableDataCollection".

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:SwitchParameter
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:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayRegionIdentified

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplaySurveyMessage

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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

Input

None

Output

PSConfig