Condividi tramite

Configurare le impostazioni globali di Azure PowerShell

  • Articolo

Azure PowerShell offre varie impostazioni globali, ad esempio l'opzione per disabilitare i messaggi di avviso di modifica di rilievo. Prima della versione 9 del modulo Az PowerShell, non esiste un metodo centralizzato o dettagliato per la configurazione di queste impostazioni globali.

Configurazione centralizzata

Il modulo Az PowerShell versione 9 e successive include i cmdlet per la gestione della configurazione delle impostazioni globali per Azure PowerShell. Questi *-AzConfig cmdlet fanno parte del modulo PowerShell Az.Accounts :

Impostazioni granulari

È possibile applicare le impostazioni valide all'interno di un determinato ambito. I valori validi per il parametro Scope sono:

  • Current User: ambito predefinito quando si applica un'impostazione.
  • Process: l'impostazione viene applicata solo alla sessione di PowerShell corrente.
  • Default: ambito di sola lettura in cui il valore predefinito non è stato modificato.
  • Environment: ambito di sola lettura in cui il valore viene configurato tramite una variabile di ambiente.

Oltre agli ambiti, è possibile applicare le impostazioni a tutti i moduli Az PowerShell o a un solo modulo. Usando il parametro AppliesTo , è possibile specificare l'ampiezza di applicazione dell'impostazione. Il valore Az indica che l'impostazione viene applicata a tutti i moduli che fanno parte di Azure PowerShell.

Opzioni di configurazione

Sono disponibili numerose opzioni di configurazione che è possibile impostare con i *-AzConfig cmdlet. Molte di queste opzioni di configurazione sono illustrate in questa sezione. Eseguire il comando seguente per visualizzare un elenco completo delle opzioni di configurazione di Azure PowerShell che è possibile impostare con i *-AzConfig cmdlet.

Get-AzConfig | Format-List

Notifiche di aggiornamento

Le notifiche degli strumenti per gli aggiornamenti della versione di Azure PowerShell sono una funzionalità rilasciata nel modulo Az PowerShell versione 10.3.0. Quando è disponibile una nuova versione di Azure PowerShell, viene visualizzata una notifica di aggiornamento nella sessione interattiva di PowerShell.

Per determinare se le notifiche di aggiornamento sono abilitate, usare il Get-AzConfig cmdlet con il parametro CheckForUpgrade , come illustrato nell'esempio seguente.

Get-AzConfig -CheckForUpgrade

Per abilitare le notifiche di aggiornamento per Azure PowerShell, usare il cmdlet con il Update-AzConfigparametro CheckForUpgrade e $true per il relativo valore, come illustrato nell'esempio seguente.

Update-AzConfig -CheckForUpgrade $true

Per disattivare le notifiche di aggiornamento, usare il cmdlet con il Update-AzConfigparametro CheckForUpgrade e $false per il relativo valore, come illustrato nell'esempio seguente.

Update-AzConfig -CheckForUpgrade $false

Sottoscrizione predefinita

Per impostazione predefinita, a partire dal modulo Az PowerShell versione 12.0.0, se si ha accesso a più sottoscrizioni, viene richiesto di selezionare una sottoscrizione di Azure con cui accedere.

Per evitare che venga richiesto di selezionare una sottoscrizione ogni volta che si accede in modo interattivo, usare il Update-AzConfig cmdlet con il parametro DefaultSubscriptionForLogin per impostare la sottoscrizione predefinita, come illustrato nell'esempio seguente.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Nota

Non confondersi con la sottoscrizione del contesto predefinito, la configurazione DefaultSubscriptionForLogin diventa effettiva solo quando si esegue l'autenticazione in Azure.

Individuazione dell'istanza

L'impostazione di disabilitazione dell'individuazione dell'istanza è progettata per situazioni in cui l'endpoint dei metadati non è accessibile, ad esempio in cloud privati o in ambienti Azure Stack. L'individuazione dell'istanza comporta il recupero dei metadati dell'autorità da https://login.microsoft.com/ per convalidare l'autorità. Abilitando questa impostazione (impostandola su true), si disabilita sia l'individuazione dell'istanza che la convalida dell'autorità. È quindi essenziale assicurarsi che l'host dell'autorità configurata sia valido e affidabile.

Per disabilitare sia l'individuazione dell'istanza che la convalida dell'autorità, abilitare questa impostazione (impostarla su true).

Update-AzConfig -DisableInstanceDiscovery $true

Messaggi di avviso di modifica che causano un'interruzione

Per disabilitare i messaggi di avviso di modifica di rilievo per i cmdlet in tutti i moduli Az , usare il Update-AzConfig cmdlet con il DisplayBreakingChangeWarning parametro , come illustrato nell'esempio seguente:

Update-AzConfig -DisplayBreakingChangeWarning $false

Per disabilitare il messaggio di avviso di modifica di rilievo specifico per i cmdlet nel modulo Az.Compute , usare il Update-AzConfig cmdlet con entrambi i parametri DisplayBreakingChangeWarning e AppliesTo , come illustrato nell'esempio seguente:

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute

In questo scenario, il messaggio di avviso di modifica di rilievo rimane attivo per i cmdlet in tutti i moduli az di PowerShell ad eccezione di Az.Compute.

Identificazione dell'area di Azure

I clienti di Azure possono scegliere di distribuire risorse in diverse aree. In alcuni casi, i clienti possono ridurre i costi selezionando le aree vicine che offrono gli stessi servizi. Se viene identificata un'area vicina, verrà visualizzata l'area da scegliere per le distribuzioni future.

Per disabilitare i messaggi di raccomandazione dell'area, usare il cmdlet con il Update-AzConfigparametro DisplayRegionIdentified , come illustrato nell'esempio seguente.

Update-AzConfig -DisplayRegionIdentified $false

Per altre informazioni sulle aree di Azure, vedere Scegliere l'area di Azure appropriata.

Visualizzare l'avviso dei segreti

Azure PowerShell visualizza un messaggio di avviso per impostazione predefinita a partire dalla versione 12.0.0 per proteggere le informazioni riservate quando identifica un potenziale segreto nell'output di un comando.

Nell'esempio seguente viene usato il Update-AzConfig cmdlet per disabilitare il messaggio di avviso.

Update-AzConfig -DisplaySecretsWarning $false

Sondaggi

Quando si usa Azure PowerShell, si potrebbe essere invitati a partecipare a un sondaggio per comunicare l'esperienza. Anche se apprezziamo le informazioni dettagliate fornite da questi dati, sappiamo che non tutti vogliono essere richiesti per completare un sondaggio.

È possibile disabilitare la richiesta di partecipare ai sondaggi con il Update-AzConfig cmdlet , come illustrato nell'esempio seguente.

Update-AzConfig -DisplaySurveyMessage $false

Raccolta dati

Per impostazione predefinita, i cmdlet di Azure PowerShell inviano dati di telemetria a Microsoft per migliorare l'esperienza dei clienti. Per altre informazioni, vedere l'informativa sulla privacy: aka.ms/privacy.

Update-AzConfig -EnableDataCollection $false

Record di errore

Per impostazione predefinita, i record di errore di Azure PowerShell vengono scritti in $HOME/.Azure/ErrorRecords.

Per disabilitare i record di errore persistenti, usare il cmdlet con il Update-AzConfigparametro EnableErrorRecordsPersistence , come illustrato nell'esempio seguente.

Update-AzConfig -EnableErrorRecordsPersistence $false

Web Account Manager (WAM)

A partire dal modulo Az PowerShell versione 12.0.0, i sistemi Windows usano Web Account Manager (WAM) e i sistemi Linux e macOS usano l'accesso basato su browser per impostazione predefinita.

Per usare l'accesso basato su browser in Windows 10 e versioni successive o in Windows Server 2019 e versioni successive con Az 12.0.0 e versioni successive, è necessario disabilitare WAM per l'uso con Azure PowerShell. Usare il comando seguente per disabilitare WAM e tornare all'accesso basato su browser, ovvero l'impostazione predefinita prima di Az 12.0.0.

Update-AzConfig -EnableLoginByWam $false

Nuova esperienza di accesso

A partire dal modulo Az PowerShell versione 12.0.0, se si ha accesso a più sottoscrizioni, viene richiesto di selezionare una sottoscrizione di Azure con cui accedere.

Quando la nuova esperienza di accesso è disabilitata e si ha accesso a più sottoscrizioni, l'accesso alla prima sottoscrizione di Azure viene restituito a meno che non si specifichi una sottoscrizione con Connect-AzAccount. Per impostazione predefinita, i comandi vengono eseguiti su questa sottoscrizione. Questo comportamento può essere pericoloso, ad esempio se la prima sottoscrizione restituita è un ambiente di produzione.

Per disabilitare la nuova esperienza di accesso, usare il Update-AzConfig cmdlet , come illustrato nell'esempio seguente.

Update-AzConfig -LoginExperienceV2 Off

Replica delle impostazioni

Per replicare le impostazioni da un ambiente a un altro, usare il Export-AzConfig cmdlet per esportare le impostazioni in un file JSON.

Export-AzConfig -Path $HOME\AzConfig.json

Per importare le impostazioni, usare il Import-AzConfig cmdlet e fare riferimento al file JSON esportato in precedenza.

Import-AzConfig -Path $HOME\AzConfig.json

Cancellazione della configurazione

Per reimpostare l'impostazione di configurazione di una o più impostazioni globali di Azure PowerShell sul valore predefinito, usare il Clear-AzConfig cmdlet . Nell'esempio seguente l'impostazione DefaultSubscriptionForLogin è deselezionata.

Clear-AzConfig -DefaultSubscriptionForLogin