Configurare le impostazioni globali di Azure PowerShell
Azure PowerShell offre varie impostazioni globali, ad esempio l'opzione per disabilitare i messaggi di avviso di modifica che causa un'interruzione. Prima della versione 9 del modulo Az PowerShell, non esisteva 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 cmdlet *-AzConfig fanno parte del modulo Az.Accounts PowerShell:
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 corrente di PowerShell.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 solo a un singolo 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 cmdlet *-AzConfig. 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 cmdlet *-AzConfig.
Get-AzConfig | Format-List
Notifiche di aggiornamento
Le notifiche nello strumento 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 cmdlet Get-AzConfig con il parametro CheckForUpgrade, come illustrato nell'esempio seguente.
Get-AzConfig -CheckForUpgrade
Per abilitare le notifiche di aggiornamento per Azure PowerShell, usare il cmdlet Update-AzConfig con il parametro 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 Update-AzConfig con il parametro 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 cmdlet Update-AzConfig con il parametro DefaultSubscriptionForLogin per impostare la sottoscrizione predefinita, come illustrato nell'esempio seguente.
Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>
Nota
Da non confondere con la sottoscrizione del contesto predefinito, la configurazione DefaultSubscriptionForLogin ha effetto 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à configurato sia valido e affidabile.
Per disabilitare sia l'individuazione dell'istanza che la convalida dell'autorità, abilitare questa impostazione (impostandola su true).
Update-AzConfig -DisableInstanceDiscovery $true
Messaggi di avviso di modifica che causa un'interruzione
Per disabilitare i messaggi di avviso di modifica che causa un'interruzione per i cmdlet in tutti i moduli Az, usare il cmdlet Update-AzConfig con il parametro DisplayBreakingChangeWarning, come illustrato nell'esempio seguente:
Update-AzConfig -DisplayBreakingChangeWarning $false
Per disabilitare il messaggio di avviso di modifica che causa un'interruzione specifico per i cmdlet nel modulo Az.Compute, usare il cmdlet di Update-AzConfig 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 che causa un'interruzione rimane attivo per i cmdlet in tutti i moduli Az 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, un messaggio visualizza l'area da scegliere per le distribuzioni future.
Per disabilitare i messaggi di raccomandazione dell'area, usare il cmdlet Update-AzConfig con il parametro DisplayRegionIdentified, come illustrato nell'esempio seguente.
Update-AzConfig -DisplayRegionIdentified $false
Per altre informazioni sulle aree di Azure, vedere Scegliere l'area di Azure appropriata.
Avviso di visualizzazione dei segreti
Azure PowerShell visualizza un messaggio di avviso per impostazione predefinita a partire dalla versione 12.0.0 per proteggere le informazioni sensibili quando identifica un potenziale segreto nell'output di un comando.
Nell'esempio seguente viene usato il cmdlet Update-AzConfig per disabilitare il messaggio di avviso.
Update-AzConfig -DisplaySecretsWarning $false
Sondaggi
Quando si usa Azure PowerShell, è possibile che si venga invitati a partecipare a un sondaggio per condividere feedback sull'esperienza. Anche se apprezziamo le informazioni dettagliate fornite da questi dati, sappiamo che non tutti vogliono ricevere richieste di partecipazione a un sondaggio.
È possibile disabilitare la richiesta di partecipare ai sondaggi con il cmdlet Update-AzConfig, 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 permanenti, usare il cmdlet Update-AzConfig con il parametro EnableErrorRecordsPersistence, come illustrato nell'esempio seguente.
Update-AzConfig -EnableErrorRecordsPersistence $false
Gestione account Web (WAM, Web Account Manager)
A partire dal modulo Az PowerShell versione 12.0.0, i sistemi Windows usano Gestione account Web (WAM, Web Account Manager) 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, si accede alla prima sottoscrizione restituita da Azure 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 cmdlet Update-AzConfig come illustrato nell'esempio seguente.
Update-AzConfig -LoginExperienceV2 Off
Replica delle impostazioni
Per replicare le impostazioni da un ambiente a un altro, usare il cmdlet Export-AzConfig per esportare le impostazioni in un file JSON.
Export-AzConfig -Path $HOME\AzConfig.json
Per importare le impostazioni, usare il cmdlet Import-AzConfig e fare riferimento al file JSON esportato in precedenza.
Import-AzConfig -Path $HOME\AzConfig.json
Cancellazione della configurazione
Per ripristinare l'impostazione di configurazione predefinita di una o più impostazioni globali di Azure PowerShell, usare il cmdlet Clear-AzConfig. Nell'esempio seguente viene cancellata l'impostazione DefaultSubscriptionForLogin.
Clear-AzConfig -DefaultSubscriptionForLogin
