Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo illustra come installare i moduli di Azure PowerShell usando PowerShellGet. Queste istruzioni funzionano sulle piattaforme Windows, Linux e macOS.
Azure PowerShell è disponibile anche in Azure Cloud Shell.
Requisiti
Azure PowerShell funziona con PowerShell 5.1 o versione successiva in Windows o PowerShell Core 6.x e versioni successive in tutte le piattaforme. È consigliabile installare la versione più recente di PowerShell disponibile per il sistema operativo. Azure PowerShell non ha requisiti aggiuntivi quando viene eseguito in PowerShell 6.2.4 e versioni successive.
Per controllare la versione di PowerShell, eseguire il comando :
$PSVersionTable.PSVersion
Per usare Azure PowerShell in PowerShell 5.1 in Windows:
- Eseguire l'aggiornamento a Windows PowerShell 5.1. Se si usa Windows 10 versione 1607 o successiva, è già installato PowerShell 5.1.
- Installare .NET Framework 4.7.2 o versione successiva.
- Assicurarsi di avere la versione più recente di PowerShellGet. Esegui
Install-Module -Name PowerShellGet -Force.
Installare il modulo Azure PowerShell
Avvertimento
Non è supportata l'installazione contemporaneamente dei moduli AzureRM e Az per PowerShell 5.1 in Windows. Se è necessario mantenere AzureRM disponibile nel sistema, installare il modulo Az per PowerShell 6.2.4 o versione successiva.
L'uso dei cmdlet PowerShellGet è il metodo di installazione preferito. Installare il modulo Az solo per l'utente corrente. Questo è l'ambito di installazione consigliato. Questo metodo funziona allo stesso modo nelle piattaforme Windows, Linux e macOS. Eseguire il comando seguente da una sessione di PowerShell:
if (Get-Module -Name AzureRM -ListAvailable) {
Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
'Az modules installed at the same time is not supported.')
} else {
Install-Module -Name Az -AllowClobber -Scope CurrentUser
}
Per impostazione predefinita, PowerShell Gallery non è configurata come archivio attendibile per PowerShellGet. La prima volta che si usa PSGallery, viene visualizzato il prompt seguente:
Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.
Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
Rispondere Yes o Yes to All per continuare con l'installazione.
L'installazione del modulo per tutti gli utenti in un sistema richiede privilegi elevati. Avviare la sessione di PowerShell usando Esegui come amministratore in Windows o usare il sudo comando in macOS o Linux:
if (Get-Module -Name AzureRM -ListAvailable) {
Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
'Az modules installed at the same time is not supported.')
} else {
Install-Module -Name Az -AllowClobber -Scope AllUsers
}
Il modulo Az è un modulo di rollup per i cmdlet di Azure PowerShell. L'installazione scarica tutti i moduli Az PowerShell disponibili a livello generale e rende disponibili i cmdlet per l'uso.
Installare offline
In alcuni ambienti, non è possibile connettersi al PowerShell Gallery. In queste situazioni, è comunque possibile installare offline usando uno di questi metodi:
Scaricare i moduli in un'altra posizione nella rete e usarli come origine di installazione. Questo metodo consente di memorizzare nella cache i moduli di PowerShell in un singolo server o in una condivisione file da distribuire con PowerShellGet in qualsiasi sistema disconnesso. Informazioni su come configurare un repository locale e installarlo in sistemi disconnessi con l'uso di repository PowerShellGet locali.
Scarica il file MSI di Azure PowerShell su un computer connesso alla rete e quindi copia il programma di installazione nei sistemi che non hanno accesso a PowerShell Gallery. Tenere presente che il programma di installazione MSI funziona solo per PowerShell 5.1 in Windows.
Salvare il modulo con Save-Module in una condivisione file oppure salvarlo in un'altra origine e copiarlo manualmente in altri computer:
Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
Risoluzione dei problemi
Ecco alcuni problemi comuni riscontrati durante l'installazione del modulo di Azure PowerShell. Se si verifica un problema non elencato qui, segnalare un problema su GitHub.
Il proxy blocca la connessione
Se si ricevono errori da Install-Module che indicano che PowerShell Gallery non è raggiungibile, è possibile che ci si trovi dietro un proxy. Diversi sistemi operativi e ambienti di rete hanno requisiti diversi per la configurazione di un proxy a livello di sistema. Contattare l'amministratore di sistema per le impostazioni proxy e come configurarle per l'ambiente.
PowerShell stesso potrebbe non essere configurato per l'uso automatico di questo proxy. Con PowerShell 5.1 e versioni successive, configurare la sessione di PowerShell per l'uso di un proxy usando i comandi seguenti:
$webClient = New-Object System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials
Se le credenziali del sistema operativo sono configurate correttamente, questa configurazione instrada le richieste di PowerShell tramite il proxy. Per rendere persistente questa impostazione tra sessioni, aggiungere i comandi al profilo di PowerShell .
Per installare il pacchetto, il proxy deve consentire le connessioni HTTPS all'indirizzo seguente:
https://www.powershellgallery.com
Accedi
Per iniziare a usare Azure PowerShell, accedere con le credenziali di Azure.
# Connect to Azure with a browser sign in token
Connect-AzAccount
Annotazioni
Se il caricamento automatico del modulo è stato disabilitato, importare manualmente il modulo con Import-Module -Name Az.
A causa del modo in cui il modulo è strutturato, l'operazione può richiedere alcuni secondi.
Sarà necessario ripetere questi passaggi per ogni nuova sessione di PowerShell avviata. Per informazioni su come rendere persistente l'accesso di Azure tra le sessioni di PowerShell, vedere Rendere persistenti le credenziali utente tra le sessioni di PowerShell.
Aggiornare il modulo Azure PowerShell
Per aggiornare qualsiasi modulo di PowerShell, è consigliabile usare lo stesso metodo usato per installare il modulo. Ad esempio, se in origine è stato usato Install-Module, è consigliabile usare Update-Module per ottenere la versione più recente. Se in origine è stato usato il pacchetto MSI, è necessario scaricare e installare il nuovo pacchetto MSI.
I cmdlet PowerShellGet non possono aggiornare i moduli installati da un pacchetto MSI. I pacchetti MSI non aggiornano i moduli installati con PowerShellGet. Se si verificano problemi durante l'aggiornamento con PowershellGet, è consigliabile reinstallare anziché eseguire l'aggiornamento. La reinstallazione viene eseguita allo stesso modo dell'installazione, ma è necessario aggiungere il -Force parametro :
if (Get-Module -Name AzureRM -ListAvailable) {
Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
'Az modules installed at the same time is not supported.')
} else {
Install-Module -Name Az -AllowClobber -Force
}
A differenza delle installazioni basate su MSI, l'installazione o l'aggiornamento con PowerShellGet non rimuove le versioni precedenti che potrebbero esistere nel sistema. Per rimuovere le versioni precedenti di Azure PowerShell dal sistema, vedere Disinstallare il modulo Azure PowerShell. Per altre informazioni sulle installazioni basate su MSI, vedere Installare Azure PowerShell con un MSI.
Usare più versioni di Azure PowerShell
È possibile installare più di una versione di Azure PowerShell. Per verificare se sono installate più versioni di Azure PowerShell, usare il comando seguente:
Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version
Per rimuovere una versione di Azure PowerShell, vedere Disinstallare il modulo Azure PowerShell.
Se sono installate più versioni del modulo, il modulo viene caricato automaticamente e Import-Module carica la versione più recente di default.
È possibile installare o caricare una versione specifica del Az modulo usando il -RequiredVersion parametro :
# Install Az version 3.6.1
Install-Module -Name Az -RequiredVersion 3.6.1
# Load Az version 3.6.1
Import-Module -Name Az -RequiredVersion 3.6.1
Inviare commenti
Se viene rilevato un bug in Azure PowerShell, segnalare un problema in GitHub. Per fornire commenti e suggerimenti dalla riga di comando, usare il cmdlet Send-Feedback .
Passaggi successivi
Per altre informazioni sui moduli di Azure PowerShell e sulle relative funzionalità, vedere Introduzione ad Azure PowerShell. Se si ha familiarità con Azure PowerShell ed è necessario eseguire la migrazione da AzureRM, vedere Eseguire la migrazione da AzureRM ad Az.