Condividi tramite


Install-Module

Scarica uno o più moduli da un repository e li installa nel computer locale.

Sintassi

Install-Module
       [-Name] <String[]>
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-RequiredVersion <String>]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <String>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-Force]
       [-AllowPrerelease]
       [-AcceptLicense]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-Module
       [-InputObject] <PSObject[]>
       [-Credential <PSCredential>]
       [-Scope <String>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-Force]
       [-AcceptLicense]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Descrizione

Il cmdlet Install-Module ottiene uno o più moduli che soddisfano i criteri specificati da un repository online. Il cmdlet verifica che i risultati della ricerca siano moduli validi e copia le cartelle del modulo nel percorso di installazione. I moduli installati non vengono importati automaticamente dopo l'installazione. È possibile filtrare il modulo installato in base alle versioni minime, massime ed esatte dei moduli specificati.

Si tratta di un cmdlet proxy per il cmdlet Get-InstalledPSResource nel Microsoft.PowerShell.PSResourceGet. Per altre informazioni, vedere Install-PSResource.

Esempio

Esempio 1: Trovare e installare un modulo

Questo esempio trova un modulo nel repository e installa il modulo.

Find-Module -Name PowerShellGet | Install-Module

Il usa il parametro nome per specificare il modulo PowerShellGet . Per impostazione predefinita, la versione più recente del modulo viene scaricata dal repository. L'oggetto viene inviato alla pipeline al cmdlet Install-Module. Install-Module installa il modulo per tutti gli utenti in $env:ProgramFiles\PowerShell\Modules.

Esempio 2: Installare un modulo in base al nome

In questo esempio viene installata la versione più recente del modulo PowerShellGet .

Install-Module -Name PowerShellGet

Il usa il parametro nome per specificare il modulo PowerShellGet . Per impostazione predefinita, la versione più recente del modulo viene scaricata dal repository e installata.

Esempio 3: Installare un modulo usando la versione minima

In questo esempio viene installata la versione minima del modulo PowerShellGet . Il parametro MinimumVersion specifica la versione più bassa del modulo da installare. Se è disponibile una versione più recente del modulo, tale versione viene scaricata e installata per tutti gli utenti.

Install-Module -Name PowerShellGet -MinimumVersion 2.0.1

Il usa il parametro nome per specificare il modulo PowerShellGet . Il parametro MinimumVersion specifica che la versione 2.0.1 viene scaricata dal repository e installata. Poiché la versione 2.0.4 è disponibile, tale versione viene scaricata e installata per tutti gli utenti.

Esempio 4: Installare una versione specifica di un modulo

In questo esempio viene installata una versione specifica del modulo PowerShellGet .

Install-Module -Name PowerShellGet -RequiredVersion 2.0.0

Il usa il parametro nome per specificare il modulo PowerShellGet . Il parametro RequiredVersion specifica che la versione 2.0.0 viene scaricata e installata per tutti gli utenti.

Esempio 5: Installare un modulo solo per l'utente corrente

Questo esempio scarica e installa la versione più recente di un modulo, solo per l'utente corrente.

Install-Module -Name PowerShellGet -Scope CurrentUser

Il usa il parametro nome per specificare il modulo PowerShellGet . Install-Module scarica e installa la versione più recente di PowerShellGet nella directory dell'utente corrente $HOME\Documents\PowerShell\Modules.

Esempio 6: Installare la versione non definitiva più recente di un modulo

Questo esempio illustra come installare la versione più recente di un modulo quando tale versione è una versione non definitiva. L'installazione di una versione non definitiva richiede il parametro AllowPrerelease.

Install-Module -Name Microsoft.PowerShell.Crescendo -AllowPrerelease

Usando questo metodo si ottiene la versione più recente disponibile. Se la versione più recente non è una versione preliminare, si ottiene la versione stabile più recente del modulo.

Esempio 7: Installare una versione non definitiva specifica di un modulo

Questo esempio illustra come installare una versione non definitiva specifica di un modulo. Il cmdlet Find-Module può essere usato per trovare versioni non definitive dei moduli in PowerShell Gallery.

Le versioni non definitive hanno un formato di <version_number>-<prerelease_label>.

Find-Module PSReadLine -AllVersions -AllowPrerelease | Select-Object -First 5

Version        Name             Repository       Description
-------        ----             ----------       -----------
2.2.6          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.5          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.4-beta1    PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.3          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.2          PSReadLine       PSGallery        Great command line editing in the PowerS…

Install-Module -Name PSReadLine -RequiredVersion 2.2.4-beta1 -AllowPrerelease

Usare la versione visualizzata in PowerShell Gallery per il valore del parametro RequiredVersion.

Parametri

-AcceptLicense

Per i moduli che richiedono una licenza, AcceptLicense accetta automaticamente il contratto di licenza durante l'installazione. Per altre informazioni, vedere moduli che richiedono l'accettazione della licenza.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowClobber

Esegue l'override dei messaggi di avviso relativi ai conflitti di installazione relativi ai comandi esistenti in un computer. Sovrascrive i comandi esistenti con lo stesso nome dei comandi installati da un modulo. AllowClobber e Force possono essere usati insieme in un comando Install-Module.

Il cmdlet proxy trasforma il valore di questo parametro nel parametro NoClobber del cmdlet Install-PSResource.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowPrerelease

Consente di installare un modulo contrassegnato come versione non definitive.

Il cmdlet proxy esegue il mapping di questo parametro al parametro versione preliminare di .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet Install-Module.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica un account utente con diritti per installare un modulo per un provider di pacchetti o un'origine specificati.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Force

Il cmdlet proxy ignora questo parametro perché non è supportato da Install-PSResource.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Usato per l'input della pipeline. Viene generato un errore se un valore fornito direttamente a InputObject. Usare la pipeline per passare oggetti con il parametro InputObject.

Tipo:PSObject[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-MaximumVersion

Il cmdlet proxy usa il valore di questo parametro per creare una stringa di ricerca della versione NuGet da usare con il parametro Version di Install-PSResource.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-MinimumVersion

Il cmdlet proxy usa il valore di questo parametro per creare una stringa di ricerca della versione NuGet da usare con il parametro Version di Install-PSResource.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica i nomi esatti dei moduli da installare dalla raccolta online. Viene accettato un elenco delimitato da virgole di nomi di modulo. Il nome del modulo deve corrispondere al nome del modulo nel repository. Usare Find-Module per ottenere un elenco di nomi di modulo.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Quando si usa il parametro PassThru, restituisce un oggetto PSRepositoryItemInfo per il modulo. Si tratta delle stesse informazioni ottenute dal cmdlet Find-Module.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Proxy

Il cmdlet proxy ignora questo parametro perché non è supportato da Install-PSResource.

Tipo:Uri
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ProxyCredential

Il cmdlet proxy ignora questo parametro perché non è supportato da Install-PSResource.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Repository

Usare il parametro Repository per specificare il nome del repository da cui scaricare e installare un modulo. Usato quando vengono registrati più repository. Specifica il nome di un repository registrato nel comando Install-Module. Per registrare un repository, usare Register-PSRepository. Per visualizzare i repository registrati, usare Get-PSRepository.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RequiredVersion

Il cmdlet proxy usa il valore di questo parametro per creare una stringa di ricerca della versione NuGet da usare con il parametro Version di Install-PSResource.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Scope

Specifica l'ambito di installazione del modulo. I valori accettabili per questo parametro sono AllUsers e CurrentUser.

L'ambito AllUsers installa i moduli in un percorso accessibile a tutti gli utenti del computer:

$env:ProgramFiles\PowerShell\Modules

Il CurrentUser installa i moduli in un percorso accessibile solo all'utente corrente del computer. Per esempio:

$HOME\Documents\PowerShell\Modules

Quando non viene definito alcun ambito, il valore predefinito è impostato in base alla versione di PowerShellGet.

  • Nelle versioni di PowerShellGet 1.x il valore predefinito è AllUsers, che richiede l'elevazione dei privilegi per l'installazione.
  • Per PowerShellGet versioni 2.0.0 e successive in PowerShell 6 o versioni successive:
    • Il valore predefinito è CurrentUser, che non richiede l'elevazione dei privilegi per l'installazione.
    • Se si esegue in una sessione con privilegi elevati, il valore predefinito è AllUsers.
Tipo:String
Valori accettati:CurrentUser, AllUsers
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SkipPublisherCheck

Il cmdlet proxy trasforma questo parametro in AuthenticodeCheck prima di chiamare Install-PSResource.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se è stato eseguito un comando Install-Module. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSRepositoryItemInfo

Find-Module crea oggetti PSRepositoryItemInfo che possono essere inviati dalla pipeline a Install-Module.

String[]

PSObject[]

String

PSCredential

Uri

Output

Microsoft.PowerShell.Commands.PSRepositoryItemInfo

Quando si usa il parametro PassThru, restituisce un oggetto PSRepositoryItemInfo per il modulo. Si tratta delle stesse informazioni ottenute dal cmdlet Find-Module.

Note

PowerShell include gli alias seguenti per Install-Module:

  • Tutte le piattaforme:
    • inmo

Install-Module viene eseguito in PowerShell 5.0 o versioni successive, in Windows 7 o Windows 2008 R2 e versioni successive di Windows.

Importante

A partire da aprile 2020, PowerShell Gallery non supporta più le versioni 1.0 e 1.1 di Transport Layer Security (TLS). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si prova ad accedere a PowerShell Gallery. Usare il comando seguente per assicurarsi di usare TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Per altre informazioni, vedere l'annuncio nel blog di PowerShell.

Come procedura consigliata per la sicurezza, valutare il codice di un modulo prima di eseguire qualsiasi cmdlet o funzioni per la prima volta. Per impedire l'esecuzione di moduli contenenti codice dannoso, i moduli installati non vengono importati automaticamente dopo l'installazione.

Se il nome del modulo specificato dal parametro Nome non esiste nel repository, restituisce un errore.

Per installare più moduli, usare il parametro Name e specificare una matrice delimitata da virgole di nomi di modulo. Se si specificano più nomi di modulo, non è possibile usare MinimumVersion, MaximumVersiono RequiredVersion. Find-Module crea oggetti PSRepositoryItemInfo che possono essere inviati dalla pipeline a Install-Module. La pipeline è un altro modo per specificare più moduli da installare in un singolo comando.

Per impostazione predefinita, i moduli per l'ambito di AllUsers vengono installati in $env:ProgramFiles\PowerShell\Modules. L'impostazione predefinita impedisce confusione quando si installano le risorse DSC (Desired State Configuration) di PowerShell.

L'installazione di un modulo non riesce e non può essere importata se non ha un .psm1, .psd1o .dll con lo stesso nome all'interno della cartella. Usare il parametro Force per installare il modulo.

Se la versione di un modulo esistente corrisponde al nome specificato dal parametro Name e il parametro MinimumVersion o RequiredVersion non vengono usati, invisibile all'utente ma non installa il modulo.

Se la versione di un modulo esistente è maggiore del valore del parametro MinimumVersion o uguale al valore del parametro RequiredVersion, invisibile all'utente ma non installa il modulo.

Se il modulo esistente non corrisponde ai valori specificati dal MinimumVersion o parametri RequiredVersion, si verifica un errore nel comando Install-Module. Ad esempio, se la versione del modulo installato esistente è inferiore al valore minimumVersion o non uguale al valore RequiredVersion .

Install-Module installa anche tutti i moduli dipendenti specificati come richiesto dal server di pubblicazione del modulo. Il server di pubblicazione elenca i moduli necessari e le relative versioni nel manifesto del modulo.