Condividi tramite


Introduzione al modulo Az PowerShell

Panoramica

Il modulo Az PowerShell è un set di cmdlet per la gestione delle risorse di Azure direttamente da PowerShell. PowerShell offre funzionalità avanzate per l'automazione che possono essere sfruttate per la gestione delle risorse di Azure, ad esempio nel contesto di una pipeline CI/CD.

Il modulo Az PowerShell è la sostituzione di AzureRM ed è il modulo consigliato da usare per interagire con Azure.

Avvertimento

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito né supportato, pertanto qualsiasi uso continuato è a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, fare riferimento alle nostre risorse di migrazione .

È possibile usare il modulo Az PowerShell con uno dei metodi seguenti:

Caratteristiche

Il modulo Az PowerShell offre i vantaggi seguenti:

  • Sicurezza e stabilità
    • Crittografia della cache dei token
    • Prevenzione del tipo di attacco man-in-the-middle
    • Supporto dell'autenticazione con ADFS 2019
    • Autenticazione con nome utente e password in PowerShell 7
    • Supporto per funzionalità come la valutazione continua dell'accesso
  • Supporto per tutti i servizi di Azure
    • Tutti i servizi di Azure disponibili a livello generale hanno un modulo di PowerShell supportato corrispondente
    • Correzioni di bug multipli e aggiornamenti della versione dell'API da AzureRM
  • Nuove funzionalità
    • Supporto su Cloud Shell e piattaforma incrociata
    • Può ottenere e usare il token di accesso per accedere alle risorse di Azure
    • Cmdlet disponibile per le operazioni REST avanzate con le risorse di Azure

Nota

PowerShell 7.2 o versione successiva è la versione consigliata di PowerShell da usare con il modulo Az PowerShell in tutte le piattaforme.

Il modulo Az PowerShell è basato sulla libreria .NET Standard e funziona con PowerShell 7.2 e versioni successive in tutte le piattaforme, tra cui Windows, Linux e macOS. È compatibile anche con Windows PowerShell 5.1.

Ci impegniamo a portare il supporto di Azure in tutte le piattaforme e tutti i moduli Az PowerShell sono multipiattaforma.

Aggiorna l'ambiente ad Az

Per mantenere il passo con le funzionalità più recenti di Azure in PowerShell, è necessario eseguire la migrazione al modulo Az. Se non si è pronti per installare il modulo Az come sostituzione di AzureRM, sono disponibili alcune opzioni per sperimentare con Az:

  • Usare un ambiente PowerShell con Azure Cloud Shell. Azure Cloud Shell è un ambiente shell basato su browser con il modulo Az installato e con gli alias di compatibilità Enable-AzureRM abilitati.
  • Mantenere installato il modulo AzureRM in Windows PowerShell 5.1 e installare il modulo Az in PowerShell 7 o versione successiva. Windows PowerShell 5.1 e PowerShell 7 e versioni successive usano raccolte separate di moduli. Seguire le istruzioni per installare la versione più recente di PowerShell e quindi installare il modulo Az da PowerShell 7 o versione successiva.

Per eseguire l'aggiornamento da un'installazione di AzureRM esistente:

  1. Disinstallare il modulo AzureRM di Azure PowerShell
  2. Installare il modulo Az PowerShell
  3. OPTIONAL: Abilitare la modalità di compatibilità per aggiungere alias per i cmdlet di AzureRM con Enable-AzureRMAlias mentre ci si familiarizza con la nuova serie di comandi. Per ulteriori informazioni, consultare la sezione successiva o Iniziare la migrazione da AzureRM ad Az.

Eseguire la migrazione di script esistenti da AzureRM ad Az

Se gli script sono ancora basati sul modulo AzureRM, sono disponibili diverse risorse per facilitare la migrazione:

Supportabilità

Az è il modulo PowerShell più recente per Azure. I problemi o le richieste di funzionalità possono essere registrati direttamente nel repository GitHub o tramite il supporto Tecnico Microsoft se si dispone di un contratto di supporto. Le richieste di funzionalità vengono implementate nella versione più recente di Az. I problemi critici vengono implementati nelle ultime due versioni di Az.

Poiché i moduli Az PowerShell ora hanno tutte le funzionalità dei moduli di AzureRM PowerShell e altro ancora, i moduli di PowerShell di AzureRM sono stati deprecati a partire dal 29 febbraio 2024.

Per evitare interruzioni del servizio, aggiornare gli script che usano i moduli di PowerShell di AzureRM a utilizzare i moduli Az PowerShell. Per aggiornare automaticamente i tuoi script, segui la guida introduttiva .

Raccolta dei dati

Azure PowerShell raccoglie i dati di telemetria per impostazione predefinita. Microsoft aggrega i dati raccolti per identificare i modelli di utilizzo per identificare i problemi comuni e migliorare l'esperienza di Azure PowerShell. Microsoft Azure PowerShell non raccoglie dati privati o personali. Ad esempio, i dati di utilizzo consentono di identificare i problemi, ad esempio i cmdlet con esito negativo, e aiutano a classificare in ordine di priorità il lavoro.

Anche se apprezziamo le informazioni dettagliate fornite da questi dati, sappiamo anche che non tutti vogliono inviare dati di utilizzo. È possibile disabilitare la raccolta dati con il cmdlet Disable-AzDataCollection. Per altre informazioni, leggere anche l'informativa sulla privacy .