Install-Package

Modulo:

PackageManagement

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 per gli 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 le 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 alla 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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowPrereleaseVersions

Consente l'installazione dei pacchetti contrassegnati come versione preliminare.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllVersions

Install-Package installa tutte le versioni disponibili del pacchetto. Per impostazione predefinita, viene installata solo la versione più recente.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Command

Specifica uno o più comandi in cui Install-Package viene eseguita la ricerca.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConfigFile

Specifica un percorso che contiene un file di configurazione.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Contains

Install-Package ottiene oggetti se il parametro Contains specifica un valore che corrisponde a uno qualsiasi dei valori delle proprietà dell'oggetto.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 viene specificato, Install-Package usa l'utente corrente.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Destination

Specifica un percorso di un oggetto di input.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DscResource

Specifica una o più risorse Desired State Configuration (DSC) ricercate da Install-Package. Usare il Find-DscResource cmdlet per trovare le risorse DSC.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExcludeVersion

Passare a per escludere il numero di versione nel percorso della cartella.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Specifica i termini da cercare nelle proprietà Name e Description .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilterOnTag

Specifica un tag che filtra i risultati ed esclude i risultati che non contengono il tag specificato.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente. Esegue l'override delle restrizioni che impediscono Install-Package l'esito positivo, ad eccezione della sicurezza.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceBootstrap

Forza PackageManagement a installare automaticamente il provider di pacchetti per il pacchetto specificato.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Headers

Specifica le intestazioni del pacchetto.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Includes

Specifica se Install-Package deve trovare tutti i tipi di pacchetto. I valori accettabili per questo parametro sono i seguenti:

• Cmdlet
• DscResource
• Funzione
• RoleCapability
• Flusso di lavoro

Type:	String[]
Accepted values:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Accetta l'input della pipeline. Specifica un pacchetto utilizzando il tipo SoftwareIdentity del pacchetto. Find-Package restituisce un oggetto SoftwareIdentity .

Type:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallUpdate

Indica che Install-Package installa gli aggiornamenti.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

Specifica la versione massima consentita del pacchetto che si vuole installare. Se non si specifica questo parametro, Install-Package installa la versione più recente del pacchetto.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinimumVersion

Specifica la versione minima consentita del pacchetto che si vuole installare. Se non si aggiunge questo parametro, Install-Package installa la versione più recente del pacchetto che soddisfa qualsiasi versione specificata dal parametro MaximumVersion .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Specifica uno o più nomi di pacchetto. I nomi di più pacchetti devono essere separati da virgole.

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoPathUpdate

NoPathUpdate si applica solo al Install-Script cmdlet . NoPathUpdate è un parametro dinamico aggiunto dal provider e non è supportato da Install-Package.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageManagementProvider

Specifica il nome del provider PackageManagement .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProviderName

Specifica uno o più nomi di provider di pacchetti a cui definire l'ambito della ricerca del pacchetto. Per ottenere i nomi di provider di pacchetti, è possibile eseguire il cmdlet Get-PackageProvider.

Type:	String[]
Aliases:	Provider
Accepted values:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

Specifica un server proxy per la richiesta, anziché connettersi direttamente a una risorsa Internet.

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProxyCredential

Specifica un account utente autorizzato a usare il server proxy specificato dal parametro Proxy .

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PublishLocation

Specifica il percorso di pubblicazione di un pacchetto.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleCapability

Specifica una matrice di funzionalità del ruolo.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Specifica l'ambito per il quale installare il pacchetto. I valori accettabili per questo parametro sono i seguenti:

• CurrentUser
• AllUsers

Type:	String
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptPublishLocation

Specifica il percorso di pubblicazione di uno script.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptSourceLocation

Specifica il percorso di origine dello script.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipDependencies

Ignora l'installazione delle dipendenze software.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipValidate

Opzione che ignora la convalida delle credenziali di un pacchetto.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Source

Specifica una o più origini pacchetto. I nomi di origine di più pacchetti devono essere separati da virgole. È possibile ottenere i nomi di origine dei pacchetti eseguendo il Get-PackageSource cmdlet .

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Specifica una o più stringhe da cercare nei metadati del pacchetto.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

Specifica se cercare pacchetti con un modulo, uno script o entrambi. I valori accettabili per questo parametro sono i seguenti:

• Modulo
• Script
• Tutti

Type:	String
Accepted values:	Module, Script, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Mostra cosa accadrebbe se Install-Package il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 TLS (Transport Layer Security). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si tenta di accedere a PowerShell Gallery. Per verificare di usare TLS 1.2, eseguire il comando seguente:

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

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

Collegamenti correlati

• about_PackageManagement
• Find-DscResource
• Get-Help
• Get-Package
• Get-PackageProvider
• Get-PackageSource
• Find-Package
• Save-Package
• Uninstall-Package