Installare Azure PowerShellInstall Azure PowerShell

Questo articolo illustra come installare i moduli di Azure PowerShell con PowerShellGet.This article explains how to install the Azure PowerShell modules using PowerShellGet. Queste istruzioni sono applicabili alle piattaforme Windows, macOS e Linux.These instructions work on Windows, macOS, and Linux platforms.

Azure PowerShell è disponibile anche in Azure Cloud Shell ed è ora preinstallato nelle immagini Docker.Azure PowerShell is also available in Azure Cloud Shell and is now preinstalled in Docker images.

RequisitiRequirements

Nota

PowerShell 7.x e versioni successive è la versione consigliata di PowerShell per l'uso con Azure PowerShell in tutte le piattaforme.PowerShell 7.x and later is the recommended version of PowerShell for use with Azure PowerShell on all platforms.

Azure PowerShell funziona con PowerShell 6.2.4 e versioni successive in tutte le piattaforme.Azure PowerShell works with PowerShell 6.2.4 and later on all platforms. È supportato anche con PowerShell 5.1 in Windows.It is also supported with PowerShell 5.1 on Windows. Installare la versione più recente di PowerShell disponibile per il sistema operativo in uso.Install the latest version of PowerShell available for your operating system. Azure PowerShell non prevede requisiti aggiuntivi quando viene eseguito in PowerShell 6.2.4 e versioni successive.Azure PowerShell has no additional requirements when run on PowerShell 6.2.4 and later.

Per controllare la versione di PowerShell, eseguire il comando:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Per usare Azure PowerShell in PowerShell 5.1 in Windows:To use Azure PowerShell in PowerShell 5.1 on Windows:

  1. Eseguire l'aggiornamento a Windows PowerShell 5.1.Update to Windows PowerShell 5.1. Se si usa Windows 10 versione 1607 o successiva, PowerShell 5.1 è già installato.If you're on Windows 10 version 1607 or higher, you already have PowerShell 5.1 installed.
  2. Installare .NET Framework 4.7.2 o versioni successive.Install .NET Framework 4.7.2 or later.
  3. Assicurarsi di avere la versione più recente di PowerShellGet.Make sure you have the latest version of PowerShellGet. Eseguire Install-Module -Name PowerShellGet -Force.Run Install-Module -Name PowerShellGet -Force.

Installare il modulo Azure PowerShellInstall the Azure PowerShell module

Avviso

L'installazione simultanea dei moduli AzureRM e Az per PowerShell 5.1 per Windows non è supportata.We do not support having both the AzureRM and Az modules installed for PowerShell 5.1 on Windows at the same time. Se è necessario mantenere AzureRM nel sistema, installare il modulo Az per PowerShell 6.2.4.x o versioni successive.If you need to keep AzureRM available on your system, install the Az module for PowerShell 6.2.4 or later.

Il metodo di installazione preferito prevede l'uso dei cmdlet PowerShellGet.Using the PowerShellGet cmdlets is the preferred installation method. Installare il modulo Az solo per l'utente corrente.Install the Az module for the current user only. Questo è l'ambito di installazione consigliato.This is the recommended installation scope. Questo metodo è applicabile anche alle piattaforme Windows, macOS e Linux.This method works the same on Windows, macOS, and Linux platforms. Eseguire il comando seguente da una sessione di PowerShell:Run the following command from a PowerShell session:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (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.By default, the PowerShell gallery isn't configured as a trusted repository for PowerShellGet. La prima volta che si usa PSGallery verrà visualizzato il messaggio seguente:The first time you use the PSGallery you see the following prompt:

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 l'installazione.Answer Yes or Yes to All to continue with the installation.

Per installare il modulo per tutti gli utenti di un sistema, sono necessari privilegi elevati.Installing the module for all users on a system requires elevated privileges. Per avviare la sessione di PowerShell, usare Esegui come amministratore in Windows oppure il comando sudo in macOS o Linux:Start the PowerShell session using Run as administrator in Windows or use the sudo command on macOS or Linux:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (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.The Az module is a rollup module for the Azure PowerShell cmdlets. Con la sua installazione vengono scaricati tutti i moduli Az PowerShell disponibili a livello generale e vengono messi a disposizione i relativi cmdlet.Installing it downloads all of the generally available Az PowerShell modules, and makes their cmdlets available for use.

Eseguire l'installazione offlineInstall offline

In alcuni ambienti non è possibile connettersi a PowerShell Gallery.In some environments, it's not possible to connect to the PowerShell Gallery. In questi casi è comunque possibile eseguire l'installazione offline usando uno dei metodi seguenti:In those situations, you can still install offline using one of these methods:

  • Scaricare i moduli in un altro percorso di rete e usare tale percorso come origine dell'installazione.Download the modules to another location in your network and use that as an installation source. Questo metodo consente di memorizzare i moduli di PowerShell nella cache di un singolo server o di una condivisione file da distribuire con PowerShellGet in qualsiasi sistema disconnesso.This method allows you to cache PowerShell modules on a single server or file share to be deployed with PowerShellGet to any disconnected systems. Per informazioni su come configurare un repository locale ed eseguire l'installazione in sistemi disconnessi, vedere Uso dei repository PowerShellGet locali.Learn how to set up a local repository and install on disconnected systems with Working with local PowerShellGet repositories.

  • Scaricare il file MSI di Azure PowerShell in un computer connesso alla rete e quindi copiare il programma di installazione nei sistemi senza accesso a PowerShell Gallery.Download the Azure PowerShell MSI to a machine connected to the network, and then copy the installer to systems without access to PowerShell Gallery. Tenere presente che il programma di installazione MSI funziona solo per PowerShell 5.1 in Windows.Keep in mind that the MSI installer only works for PowerShell 5.1 on Windows.

  • Salvare il modulo con Save-Module in una condivisione file oppure salvarlo in un'altra origine e copiarlo manualmente in altri computer:Save the module with Save-Module to a file share, or save it to another source and manually copy it to other machines:

    Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
    

Risoluzione dei problemiTroubleshooting

Ecco alcuni problemi comuni che possono verificarsi durante l'installazione del modulo Azure PowerShell.Here are some common problems seen when installing the Azure PowerShell module. Se si verifica un problema non elencato in questo articolo, segnalarlo in GitHub.If you experience a problem not listed here, file an issue on GitHub.

Il proxy blocca la connessioneProxy blocks connection

Se Install-Module restituisce errori che indicano che PowerShell Gallery non è raggiungibile, è possibile che si sia protetti da un proxy.If you get errors from Install-Module that indicate the PowerShell Gallery is unreachable, you may be behind a proxy. I requisiti per configurare un proxy a livello di sistema variano a seconda del sistema operativo e dell'ambiente di rete.Different operating systems and network environment have different requirements for configuring a system-wide proxy. Per conoscere le impostazioni del proxy e sapere come configurarlo per l'ambiente corrente, contattare l'amministratore di sistema.Contact your system administrator for your proxy settings and how to configure them for your environment.

PowerShell stesso potrebbe non essere configurato per l'uso automatico di questo proxy.PowerShell itself may not be configured to use this proxy automatically. Con PowerShell 5.1 e versioni successive usare i comandi seguenti per configurare la sessione di PowerShell per l'uso di un proxy:With PowerShell 5.1 and later, configure the PowerShell session to use a proxy using the following commands:

$webClient = New-Object System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Se le credenziali del sistema operativo sono configurate correttamente, questa configurazione consentirà di reindirizzare le richieste di PowerShell tramite il proxy.If your operating system credentials are configured correctly, this configuration routes PowerShell requests through the proxy. Per rendere persistente questa impostazione tra una sessione e l'altra, aggiungere i comandi al proprio profilo PowerShell.To have this setting persist between sessions, add the commands to your PowerShell profile.

Per installare il pacchetto, il proxy deve consentire le connessioni HTTPS all'indirizzo seguente:To install the package, your proxy needs to allow HTTPS connections to the following address:

  • https://www.powershellgallery.com

AccessoSign in

Per iniziare a usare Azure PowerShell, accedere con le credenziali di Azure.To start working with Azure PowerShell, sign in with your Azure credentials.

# Connect to Azure with a browser sign in token
Connect-AzAccount

Nota

Se il caricamento automatico dei moduli è stato disabilitato, importare manualmente il modulo con Import-Module -Name Az.If you've disabled module autoloading, manually import the module with Import-Module -Name Az. L'operazione potrebbe richiedere qualche secondo a causa del modo in cui è strutturato il modulo.Because of the way the module is structured, this can take a few seconds.

È necessario ripetere questi passaggi per ogni nuova sessione di PowerShell avviata.You'll need to repeat these steps for every new PowerShell session you start. Per informazioni su come mantenere l'accesso ad Azure da una sessione di PowerShell all'altra, vedere Conservare le credenziali utente tra le sessioni di PowerShell.To learn how to persist your Azure sign in across PowerShell sessions, see Persist user credentials across PowerShell sessions.

Aggiornare il modulo Azure PowerShellUpdate the Azure PowerShell module

Per aggiornare qualsiasi modulo di PowerShell, è necessario usare lo stesso metodo adottato per installare il modulo.To update any PowerShell module, you should use the same method used to install the module. Se, ad esempio, in origine è stato usato Install-Module, è necessario usare Update-Module per scaricare l'ultima versione.For example, if you originally used Install-Module, then you should use Update-Module to get the latest version. Se in origine è stato usato il pacchetto MSI, è necessario scaricare e installare la nuova versione del pacchetto MSI.If you originally used the MSI package then you should download and install the new MSI package.

I cmdlet PowerShellGet non possono aggiornare moduli installati da un pacchetto MSI.The PowerShellGet cmdlets cannot update modules that were installed from an MSI package. I pacchetti MSI non consentono di aggiornare moduli installati con PowerShellGet.MSI packages do not update modules that were installed using PowerShellGet. Se si verificano problemi durante l'aggiornamento con PowershellGet, è necessario procedere allareinstallazione invece che al semplice aggiornamento.If you have any issues updating using PowershellGet, then you should reinstall, rather than update. La reinstallazione è un'operazione analoga all'installazione, ma richiede l'aggiunta del parametro -Force:Reinstalling is done the same way as installing, but you need to add the -Force parameter:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (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
}

Diversamente dalle installazioni basate su MSI, l'installazione o l'aggiornamento con PowerShellGet non comporta la rimozione delle versioni precedenti che possono esistere nel sistema.Unlike MSI-based installations, installing or updating using PowerShellGet does not remove older versions that may exist on your system. Per rimuovere le versioni precedenti di Azure PowerShell dal sistema, vedere Disinstallare il modulo Azure PowerShell.To remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module. Per altre informazioni sulle installazioni basate su MSI, vedere Installare Azure PowerShell con un file MSI.For more information about MSI-based installations, see Install Azure PowerShell with an MSI.

Usare più versioni di Azure PowerShellUse multiple versions of Azure PowerShell

È possibile installare più versioni di Azure PowerShell.It's possible to install more than one version of Azure PowerShell. Per controllare se sono installate più versioni di Azure PowerShell, usare il comando seguente:To check if you have multiple versions of Azure PowerShell installed, use the following command:

Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version

Per rimuovere una versione di Azure PowerShell, vedere Disinstallare il modulo Azure PowerShell.To remove a version of Azure PowerShell, see Uninstall the Azure PowerShell module.

Se sono installate più versioni del modulo, il modulo viene caricato automaticamente e Import-Module carica per impostazione predefinita l'ultima versione.If you have more than one version of the module installed, module autoload and Import-Module load the latest version by default.

È possibile installare o caricare una versione specifica del modulo Az usando il parametro -RequiredVersion:You can install or load a specific version of the Az module using the -RequiredVersion parameter:

# 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

Usare più repository con PowerShellGetUse multiple repositories with PowerShellGet

Il parametro Repository è obbligatorio se sono stati aggiunti altri repository a PowerShellGet nel sistema e il modulo Az è presente in più repository.The Repository parameter is required if you have added additional repositories to PowerShellGet on your system and the Az module can be found in more than one of them.

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (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 -Repository PSGallery -AllowClobber -Force
}

Fornire commenti e suggerimentiProvide feedback

Se si trova un bug in Azure PowerShell, segnalare un problema in GitHub.If you find a bug in Azure PowerShell, file an issue on GitHub. Per inviare feedback dalla riga di comando, usare il cmdlet Send-Feedback.To provide feedback from the command line, use the Send-Feedback cmdlet.

Passaggi successiviNext Steps

Per altre informazioni sui moduli di Azure PowerShell e sulle relative funzionalità, vedere Introduzione ad Azure PowerShell.To learn more about the Azure PowerShell modules and their features, see Get Started with Azure PowerShell. Se si ha familiarità con Azure PowerShell ed è necessario eseguire la migrazione da AzureRM, vedere Eseguire la migrazione da AzureRM ad Az.If you're familiar with Azure PowerShell and need to migrate from AzureRM, see Migrate from AzureRM to Az.