Configurare le impostazioni globali di Azure PowerShell

  • Articolo

Azure PowerShell supporta diverse impostazioni globali, ad esempio la disabilitazione dei messaggi di avviso di modifica di rilievo. Prima del modulo Az PowerShell versione 9, non esiste un modo centralizzato o granulare per configurare le impostazioni globali per Azure PowerShell.

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 solo in un determinato ambito. I valori validi per il parametro Scope sono:

  • Current User. Impostazione predefinita 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 è stato configurato tramite una variabile di ambiente.

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

Per disabilitare il messaggio di avviso di modifica di rilievo per i cmdlet nel modulo Az.Compute , usare il Update-AzConfig cmdlet con 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.

Sottoscrizione predefinita

Per impostazione predefinita, quando si esegue l'autenticazione in Azure, vengono recuperate tutte le sottoscrizioni a cui è possibile accedere. La prima sottoscrizione restituita da Azure viene usata a meno che non si specifichi una sottoscrizione con Connect-AzAccount. Questo comportamento può essere pericoloso, ad esempio se la prima sottoscrizione restituita è un ambiente di produzione.

Per configurare la sottoscrizione predefinita, usare il Update-AzConfig cmdlet con il parametro DefaultSubscriptionForLogin , 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.

Notifiche di aggiornamento

Le notifiche nello strumento per gli aggiornamenti delle versioni 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

Identificazione dell'area di Azure

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

Disabilitazione del messaggio di raccomandazione per l'area

Nell'esempio seguente viene usato il Update-AzConfig cmdlet per disabilitare il messaggio di raccomandazione per l'area:

Update-AzConfig -DisplayRegionIdentified $false

Per altre informazioni sulle aree di Azure, vedere Scegliere l'area di Azure più adatta.

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