Configurare le impostazioni globali di Azure PowerShell
Azure PowerShell offre varie impostazioni globali, come l'opzione per disabilitare i messaggi di avviso sui cambiamenti importanti. Prima della versione 9 del modulo Az PowerShell
Configurazione centralizzata
Il Az modulo 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 di PowerShell:
- Get-AzConfig
- Update-AzConfig
- Export-AzConfig
- Import-AzConfig
- Clear-AzConfig
Impostazioni granulari
È possibile applicare le impostazioni valide all'interno di un determinato ambito. I valori validi per il parametro Scope
-
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 è 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 il livello 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 degli strumenti per gli aggiornamenti della versione di Azure PowerShell sono una funzionalità rilasciata in 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 -CheckForUpgrade
Per abilitare le notifiche di aggiornamento per Azure PowerShell, usare il cmdlet
Update-AzConfig -CheckForUpgrade $true
Per disattivare le notifiche di aggiornamento, usare il cmdlet
Update-AzConfig -CheckForUpgrade $false
Sottoscrizione predefinita
Per impostazione predefinita, a partire da 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 impedire 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 effettua 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, come ad esempio nei cloud privati o negli ambienti di Azure Stack. La scoperta dell'istanza comporta il recupero dei metadati dell'autorità da https://login.microsoft.com/ per verificarne l'autenticità. Abilitando questa impostazione (impostandola su true), si disabilita sia la ricerca 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à, attivare questa impostazione impostandola su true.
Update-AzConfig -DisableInstanceDiscovery $true
Messaggi di avviso di modifica che causano un'interruzione
Per disabilitare i messaggi di avviso per modifiche di interruzione per i cmdlet in tutti i moduli di 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 di rilievo specifico per i cmdlet nel modulo Az.Compute, usare il cmdlet 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 di rilievo rimane attivo per i cmdlet in tutti i moduli Az PowerShell
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 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 per l'utente.
Visualizzare l'avviso sui 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 cmdlet Update-AzConfig 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 cmdlet Update-AzConfig, come illustrato nell'esempio seguente.
Update-AzConfig -DisplaySurveyMessage $false
Raccolta dei 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
Registrazioni degli errori
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
Update-AzConfig -EnableErrorRecordsPersistence $false
Responsabile degli Account Web (WAM)
A partire dalla versione 12.0.0 del modulo Az PowerShell, i sistemi Windows utilizzano Web Account Manager (WAM) e i sistemi Linux e macOS utilizzano 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 da 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 viene automaticamente connessi alla prima sottoscrizione che Azure restituisce, a meno che non si specifichi una sottoscrizione con Connect-AzAccount. Per impostazione predefinita, i comandi vengono eseguiti su questo abbonamento. 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
Replicando le 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 reimpostare l'impostazione di configurazione di una o più impostazioni globali di Azure PowerShell sul valore predefinito, usare il cmdlet Clear-AzConfig. Nell'esempio seguente l'impostazione DefaultSubscriptionForLogin è cancellata.
Clear-AzConfig -DefaultSubscriptionForLogin
