Installare il modulo Azure PowerShellInstall the Azure PowerShell module

Questo articolo illustra come installare i moduli di Azure PowerShell con PowerShellGet.This article tells you 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. Per il modulo Az non sono attualmente supportati altri metodi di installazione.For the Az module, currently no other installation methods are supported.

RequisitiRequirements

Azure PowerShell è compatibile con PowerShell 5.1 o versione successiva in Windows oppure con PowerShell Core 6.x e versioni successive in qualsiasi piattaforma.Azure PowerShell works with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. Se non si è sicuri di avere PowerShell o se si usa macOS o Linux, installare la versione più recente di PowerShell Core.If you aren't sure if you have PowerShell, or are on macOS or Linux, install the latest version of PowerShell Core.

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

$PSVersionTable.PSVersion

Per eseguire Azure PowerShell in PowerShell 5.1 in Windows:To run Azure PowerShell in PowerShell 5.1 on Windows:

  1. Se necessario, eseguire l'aggiornamento a Windows PowerShell 5.1.Update to Windows PowerShell 5.1 if needed. Se si usa Windows 10, PowerShell 5.1 è già installato.If you're on Windows 10, 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.

Quando si usa PowerShell Core, non sono previsti requisiti aggiuntivi per Azure PowerShell.There are no additional requirements for Azure PowerShell when using PowerShell Core.

Installare il modulo Azure PowerShellInstall the Azure PowerShell module

Avviso

Non è possibile installare contemporaneamente i moduli AzureRM e Az per PowerShell 5.1 per Windows.You can't have both the AzureRM and Az modules installed for PowerShell 5.1 for Windows at the same time. Se è necessario mantenere AzureRM nel sistema, installare il modulo Az per PowerShell Core 6.x o versioni successive.If you need to keep AzureRM available on your system, install the Az module for PowerShell Core 6.x or later. A questo scopo, installare PowerShell Core 6.x or versioni successive e quindi seguire queste istruzioni in un terminale di PowerShell Core.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

Il metodo consigliato consiste nell'eseguire l'installazione solo per l'utente attivo:The recommended install method is to only install for the active user:

Install-Module -Name Az -AllowClobber -Scope CurrentUser

Se si vuole eseguire l'installazione per tutti gli utenti di un sistema, sono necessari privilegi di amministratore.If you want to install for all users on a system, this requires administrator privileges. Da una sessione di PowerShell con privilegi elevati eseguita come amministratore oppure con il comando sudo in MacOS o Linux:From an elevated PowerShell session either run as administrator or with the sudo command on macOS or Linux:

Install-Module -Name Az -AllowClobber -Scope AllUsers

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.

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 di Azure Resource Manager disponibili e vengono messi a disposizione i relativi cmdlet.Installing it downloads all of the available Azure Resource Manager modules, and makes their cmdlets available for use.

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, please 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 non vengono illustrati in dettaglio in questo articolo.Different operating systems will have different requirements for configuring a system-wide proxy, which are not covered in detail here. Per conoscere le impostazioni del proxy e sapere come configurarlo per il sistema operativo corrente, contattare l'amministratore di sistema.Contact your system administrator for your proxy settings and how to configure them for your OS.

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 configurare il proxy per l'uso di una sessione di PowerShell con il comando seguente:With PowerShell 5.1 and later, configure the proxy to use for a PowerShell session with the following command:

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

Se le credenziali del sistema operativo sono configurate correttamente, le richieste di PowerShell verranno instradate tramite il proxy.If your operating system credentials are configured correctly, this will route PowerShell requests through the proxy. Per rendere persistente questa impostazione tra una sessione e l'altra, aggiungere il comando a un profilo PowerShell.In order to have this setting persist between sessions, add the command to a PowerShell profile.

Per installare il pacchetto, il proxy deve consentire le connessioni HTTPS all'indirizzo seguente:In order 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, è necessario importare manualmente il modulo con Import-Module Az.If you've disabled module autoloading, you need to manually import the module with Import-Module 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

In considerazione della modalità di creazione del pacchetto del modulo Az, il comando Update-Module non consente di aggiornare correttamente l'installazione.Because of how the Az module is packaged, the Update-Module command won't update your installation correctly. AZ è tecnicamente un metamodulo e comprende tutti i moduli secondari contenenti i cmdlet per interagire con i servizi di Azure.Az is technically a meta-module, encompassing all of the submodules that contain cmdlets to interact with Azure services. Per aggiornare il modulo Azure PowerShell, è quindi necessario reinstallarlo, anziché semplicemente aggiornarlo.That means that to update the Azure PowerShell module, you will need to reinstall, rather than just update. L'operazione è analoga all'installazione, ma può essere necessario aggiungere l'argomento -Force:This is done in the same way as installing, but you may need to add the -Force argument:

Install-Module -Name Az -AllowClobber -Force

Anche se questa operazione può comportare la sovrascrittura di moduli installati, è comunque possibile che nel sistema siano ancora presenti versioni meno recenti.Although this can overwrite installed modules, you may still have older versions left on your system. Per informazioni su come rimuovere le versioni precedenti di Azure PowerShell dal sistema, vedere Disinstallare il modulo Azure PowerShell.To learn how to remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module.

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 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.

È possibile installare o caricare una versione specifica del modulo Az usando l'argomento -RequiredVersion:You can install or load a specific version of the Az module by using the -RequiredVersion argument:

# Install Az version 0.7.0
Install-Module -Name Az -RequiredVersion 0.7.0 
# Load Az version 0.7.0
Import-Module -Name Az -RequiredVersion 0.7.0

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.

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.