Install-Package
Installa uno o più pacchetti software.
Sintassi
Install-Package
[-Name] <String[]>
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Source <String[]>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ProviderName <String[]>]
[<CommonParameters>]Install-Package
[-InputObject] <SoftwareIdentity[]>
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ConfigFile <String>]
[-SkipValidate]
[-Headers <String[]>]
[-FilterOnTag <String[]>]
[-Contains <String>]
[-AllowPrereleaseVersions]
[-Destination <String>]
[-ExcludeVersion]
[-Scope <String>]
[-SkipDependencies]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ConfigFile <String>]
[-SkipValidate]
[-Headers <String[]>]
[-FilterOnTag <String[]>]
[-Contains <String>]
[-AllowPrereleaseVersions]
[-Destination <String>]
[-ExcludeVersion]
[-Scope <String>]
[-SkipDependencies]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-AllowPrereleaseVersions]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-PublishLocation <String>]
[-ScriptSourceLocation <String>]
[-ScriptPublishLocation <String>]
[-Type <String>]
[-Filter <String>]
[-Tag <String[]>]
[-Includes <String[]>]
[-DscResource <String[]>]
[-RoleCapability <String[]>]
[-Command <String[]>]
[-AcceptLicense]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-AllowPrereleaseVersions]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-PublishLocation <String>]
[-ScriptSourceLocation <String>]
[-ScriptPublishLocation <String>]
[-Type <String>]
[-Filter <String>]
[-Tag <String[]>]
[-Includes <String[]>]
[-DscResource <String[]>]
[-RoleCapability <String[]>]
[-Command <String[]>]
[-AcceptLicense]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[<CommonParameters>]Descrizione
Il Install-Package cmdlet installa uno o più pacchetti software nel computer locale. Se si dispone di più origini software, usare Get-PackageProvider e Get-PackageSource per visualizzare i dettagli sui provider.
Importante
I comandi contenuti nel modulo PackageManagement sono diversi dai comandi forniti dal modulo NuGet nella console di Gestione pacchetti di Visual Studio. Ogni modulo include comandi che non sono disponibili nell'altro. I comandi con lo stesso nome differiscono nei relativi argomenti specifici. Per altre informazioni, vedere la documentazione di riferimento di PowerShell per la console di Gestione pacchetti di Visual Studio.
Esempio
Esempio 1: Installare un pacchetto in base al nome del pacchetto
Il Install-Package cmdlet installa un pacchetto software e le relative dipendenze.
PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser
Install-Package usa i parametri per specificare i pacchetti Name e Source. Il parametro Credential usa un account utente di dominio con autorizzazioni per installare i pacchetti. Il comando richiede la password dell'account utente.
Esempio 2: Usare Find-Package per installare un pacchetto
In questo esempio l'oggetto restituito da Find-Package viene inviato alla pipeline e installato da Install-Package.
PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package
Find-Package usa i parametri Name e Source per individuare un pacchetto. L'oggetto viene inviato nella pipeline e Install-Package installa il pacchetto nel computer locale.
Esempio 3: Installare i pacchetti specificando un intervallo di versioni
Install-Package usa i parametri MinimumVersion e MaximumVersion per specificare un intervallo di versioni software.
PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0
Install-Package usa i parametri Name e Source per trovare un pacchetto. I parametri MinimumVersion e MaximumVersion specificano un intervallo di versioni software. Viene installata la versione più recente dell'intervallo.
Parametri
-AcceptLicense
AcceptLicense accetta automaticamente il contratto di licenza durante l'installazione.
| 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 con i comandi esistenti. Sovrascrive i comandi esistenti con lo stesso nome dei comandi installati.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-AllowPrereleaseVersions
Consente l'installazione dei pacchetti contrassegnati come versione non definitiva.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-AllVersions
Install-Package installa tutte le versioni disponibili del pacchetto. Per impostazione predefinita, viene installata solo la versione più recente.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Command
Specifica uno o più comandi in cui Install-Package viene eseguita la ricerca.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ConfigFile
Specifica un percorso che contiene un file di configurazione.
| Tipo: | String |
| 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.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Contains
Install-Package ottiene oggetti se il parametro Contains specifica un valore che corrisponde a uno dei valori delle proprietà dell'oggetto.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Credential
Specifica un account utente che dispone dell'autorizzazione per accedere al computer ed eseguire i comandi. Digitare un nome utente, ad esempio User01, Domain01\User01 o immettere un oggetto PSCredential generato dal Get-Credential cmdlet . Se si digita un nome utente, viene richiesta una password.
Quando il parametro Credential non è specificato, Install-Package usa l'utente corrente.
| Tipo: | PSCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Destination
Specifica un percorso di un oggetto di input.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DscResource
Specifica una o più risorse DSC (Desired State Configuration) in cui viene eseguita la ricerca da Install-Package. Usare il Find-DscResource cmdlet per trovare le risorse DSC.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ExcludeVersion
Passare a per escludere il numero di versione nel percorso della cartella.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Filter
Specifica i termini da cercare nelle proprietà Name e Description .
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FilterOnTag
Specifica un tag che filtra i risultati ed esclude i risultati che non contengono il tag specificato.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Force
Forza l'esecuzione del comando senza chiedere conferma dell'utente. Esegue l'override delle restrizioni che impediscono Install-Package l'esito positivo, ad eccezione della sicurezza.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ForceBootstrap
Forza PackageManagement a installare automaticamente il provider di pacchetti per il pacchetto specificato.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Headers
Specifica le intestazioni del pacchetto.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Includes
Specifica se Install-Package trovare tutti i tipi di pacchetto. I valori accettabili per questo parametro sono i seguenti:
- Cmdlet (un piccolo script o comando in PowerShell)
- DscResource
- Funzione
- RoleCapability
- Flusso di lavoro
| Tipo: | String[] |
| Valori accettati: | Cmdlet, DscResource, Function, RoleCapability, Workflow |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-InputObject
Accetta l'input della pipeline. Specifica un pacchetto utilizzando il tipo SoftwareIdentity del pacchetto.
Find-Package restituisce un oggetto SoftwareIdentity .
| Tipo: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-InstallUpdate
Indica che Install-Package installa gli aggiornamenti.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-MaximumVersion
Specifica la versione massima consentita del pacchetto da installare. Se non si specifica questo parametro, Install-Package installa la versione più recente del pacchetto.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-MinimumVersion
Specifica la versione minima consentita del pacchetto da installare. Se non si aggiunge questo parametro, Install-Package installa la versione più recente del pacchetto che soddisfa qualsiasi versione specificata dal parametro MaximumVersion .
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Name
Specifica uno o più nomi di pacchetto. I nomi di più pacchetti devono essere separati da virgole.
| Tipo: | String[] |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-NoPathUpdate
NoPathUpdate si applica solo al Install-Script cmdlet .
NoPathUpdate è un parametro dinamico aggiunto dal provider e non è supportato da Install-Package.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PackageManagementProvider
Specifica il nome del provider PackageManagement .
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ProviderName
Specifica uno o più nomi di provider di pacchetti a cui definire l'ambito della ricerca del pacchetto. È possibile ottenere i nomi dei provider di pacchetti eseguendo il Get-PackageProvider cmdlet .
| Tipo: | String[] |
| Alias: | Provider |
| Valori accettati: | Bootstrap, NuGet, PowerShellGet |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Proxy
Specifica un server proxy per la richiesta, anziché connettersi direttamente a una risorsa Internet.
| Tipo: | Uri |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ProxyCredential
Specifica un account utente autorizzato a usare il server proxy specificato dal parametro Proxy .
| Tipo: | PSCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PublishLocation
Specifica il percorso di pubblicazione di un pacchetto.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RequiredVersion
Specifica la versione esatta consentita del pacchetto da installare. Se non si aggiunge questo parametro, Install-Package installa la versione più recente del pacchetto che soddisfa qualsiasi versione specificata dal parametro MaximumVersion .
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RoleCapability
Specifica una matrice di funzionalità del ruolo.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Scope
Specifica l'ambito per il quale installare il pacchetto. I valori accettabili per questo parametro sono i seguenti:
- CurrentUser
- AllUsers
| Tipo: | String |
| Valori accettati: | CurrentUser, AllUsers |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ScriptPublishLocation
Specifica il percorso di pubblicazione di uno script.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ScriptSourceLocation
Specifica il percorso di origine dello script.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SkipDependencies
Ignora l'installazione delle dipendenze software.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SkipPublisherCheck
Consente di ottenere una versione del pacchetto più recente rispetto alla versione installata. Ad esempio, un pacchetto installato firmato digitalmente da un autore attendibile, ma una nuova versione non è firmata digitalmente.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SkipValidate
Opzione che ignora la convalida delle credenziali di un pacchetto.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Source
Specifica una o più origini pacchetto. I nomi di origine di più pacchetti devono essere separati da virgole.
È possibile ottenere i nomi delle origini dei pacchetti eseguendo il Get-PackageSource cmdlet .
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Tag
Specifica una o più stringhe da cercare nei metadati del pacchetto.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Type
Specifica se cercare pacchetti con un modulo, uno script o entrambi. I valori accettabili per questo parametro sono i seguenti:
- Modulo
- Sceneggiatura
- Tutti
| Tipo: | String |
| Valori accettati: | Module, Script, All |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra cosa accadrebbe se viene eseguito il Install-Package cmdlet. 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
Microsoft.PackageManagement.Packaging.SoftwareIdentity
È possibile inviare tramite pipe un oggetto SoftwareIdentity a questo cmdlet.
Output
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Questo cmdlet restituisce un oggetto SoftwareIdentity per ogni pacchetto installato.
Note
L'inclusione di un provider di pacchetti in un comando può rendere disponibili parametri dinamici per un cmdlet. I parametri dinamici sono specifici di un provider di pacchetti. Il Get-Help cmdlet elenca i set di parametri di un cmdlet e include il set di parametri del provider. Ad esempio, Install-Package ha il set di parametri PowerShellGet che include -NoPathUpdate, AllowClobbere SkipPublisherCheck.
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.
