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-ModuleIl 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 PowerShellGetIl
Esempio 3: Installare un modulo usando la versione minima
In questo esempio viene installata la versione minima del modulo PowerShellGet
Install-Module -Name PowerShellGet -MinimumVersion 2.0.1Il
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.0Il
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 CurrentUserIl 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 -AllowPrereleaseUsando 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 -AllowPrereleaseUsare 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
| 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 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[]
Output
Microsoft.PowerShell.Commands.PSRepositoryItemInfo
Quando si usa il parametro 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
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
Se la versione di un modulo esistente è maggiore del valore del parametro MinimumVersion
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
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.
