Install-Module
Scarica uno o più moduli da un repository e li installa nel computer locale.
Sintassi
NameParameterSet (Impostazione predefinita)
Install-Module
[-Name] <string[]>
[-MinimumVersion <version>]
[-MaximumVersion <version>]
[-RequiredVersion <version>]
[-Repository <string[]>]
[-Scope <string>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Install-Module
[-InputObject] <psobject[]>
[-Scope <string>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il Install-Module cmdlet 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.
Se il modulo installato ha lo stesso nome o versione o contiene comandi in un modulo esistente, vengono visualizzati messaggi di avviso. Dopo aver confermato che si desidera installare il modulo e aver ignorato gli avvisi, utilizzare il -Force parametro. A seconda delle impostazioni del repository, potrebbe essere necessario rispondere a una richiesta di continuazione dell'installazione del modulo.
Questi esempi usano PowerShell Gallery come unico repository registrato.
Get-PSRepository visualizza i repository registrati. Se sono presenti più repository registrati, usare il -Repository parametro per specificare il nome del repository.
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
Find-Module Usa il parametro Name 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\WindowsPowerShell\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
Install-Module Usa il parametro Name 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
Install-Module Usa il parametro Name per specificare il modulo PowerShellGet. Il parametro MinimumVersion specifica che la versione 2.0.1 viene scaricata dal repository e installata. Poiché è disponibile la versione 2.0.4 , 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
Install-Module Usa il parametro Name 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
Install-Module Usa il parametro Name per specificare il modulo PowerShellGet.
Install-Module scarica e installa la versione più recente di PowerShellGet nella directory dell'utente corrente, $home\Documents\WindowsPowerShell\Modules.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet Install-Module.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Installa un modulo ed esegue l'override dei messaggi di avviso relativi ai conflitti di installazione del modulo. Se nel computer esiste già un modulo con lo stesso nome, Force consente l'installazione di più versioni. Se è presente un modulo esistente con lo stesso nome e la stessa versione, Force sovrascrive tale versione.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-InputObject
Usato per l'input della pipeline.
Proprietà dei parametri
| Tipo: | PSObject[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
InputObject
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-MaximumVersion
Specifica la versione massima di un singolo modulo da installare. Se si desidera installare più moduli, non è possibile utilizzare MaximumVersion.
MaximumVersion e RequiredVersion non possono essere utilizzati nello stesso Install-Module comando.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
NameParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-MinimumVersion
Specifica la versione minima di un singolo modulo da installare. Se è disponibile una versione più recente del modulo, viene installata la versione più recente. Se si desidera installare più moduli, non è possibile utilizzare MinimumVersion.
MinimumVersion e RequiredVersion non possono essere utilizzati nello stesso Install-Module comando.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Versione |
Set di parametri
NameParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
NameParameterSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Repository
Utilizzare il parametro Repository per specificare quale repository viene utilizzato per scaricare e installare un modulo. Usato quando vengono registrati più repository. Specifica il nome di un repository registrato nel Install-Module comando . Per registrare un repository, usare Register-PSRepository.
Per visualizzare i repository registrati, usare Get-PSRepository.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
NameParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RequiredVersion
Specifica la versione esatta di un singolo modulo da installare. Se non esiste alcuna corrispondenza nel repository per la versione specificata, viene visualizzato un errore. Se si desidera installare più moduli, non è possibile utilizzare RequiredVersion.
RequiredVersion non può essere utilizzato nello stesso Install-Module comando di MinimumVersion o MaximumVersion.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
NameParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | 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 una posizione accessibile a tutti gli utenti del computer:
$env:ProgramFiles\WindowsPowerShell\Modules
L'utente corrente installa i moduli in una posizione accessibile solo all'utente corrente del computer:
$home\Documents\WindowsPowerShell\Modules
Quando non viene definito alcun ambito , viene impostato il valore predefinito in base alla sessione corrente:
- Per una sessione di PowerShell con privilegi elevati, l'ambito predefinito è AllUsers.
- Per le sessioni di PowerShell non con privilegi elevati in PowerShellGet versioni 2.0.0 e successive, l'ambito è CurrentUser.
- Per le sessioni di PowerShell non elevate in PowerShellGet versioni 1.6.7 e precedenti, Scope non è definito e
Install-Modulenon riesce.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Valori accettati: | AllUsers, CurrentUser |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra cosa accadrebbe se è stato eseguito un Install-Module comando. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
PSRepositoryItemInfo
Find-Module crea oggetti PSRepositoryItemInfo che possono essere inviati alla pipeline a Install-Module.
Note
Install-Module viene eseguito in PowerShell 5.0 o versioni successive in Windows 7 o Windows 2008 R2 e versioni successive di Windows.
Come procedura consigliata per la sicurezza, valutare il codice di un modulo prima di eseguire qualsiasi cmdlet o funzioni per la prima volta. Per evitare l'esecuzione di moduli che contengono codice dannoso, i moduli installati non vengono importati automaticamente dopo l'installazione.
Se il nome del modulo specificato dal parametro Name non esiste nel repository, Install-Module 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 moduli, non è possibile utilizzare MinimumVersion, MaximumVersion o RequiredVersion.
Find-Module crea oggetti PSRepositoryItemInfo che possono essere inviati alla 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\WindowsPowerShell\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 contiene , .psm1.psd1, o .dll 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 viene utilizzato, Install-Module il modulo continua automaticamente ma non viene installato.
Se la versione di un modulo esistente è maggiore del valore del parametro MinimumVersion o uguale al valore del parametro RequiredVersion , Install-Module continua automaticamente ma non installa il modulo.
Se il modulo esistente non corrisponde ai valori specificati dai parametri MinimumVersion o RequiredVersion , si Install-Module verifica un errore nel comando. Ad esempio, se la versione del modulo installato esistente è inferiore al valore MinimumVersion o non è uguale al valore RequiredVersion .