Find-Package

Riferimento

Modulo:: PackageManagement

Trova i pacchetti software nelle origini dei pacchetti disponibili.

Sintassi

Find-Package
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

Find-Package
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-AllowPrereleaseVersions]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [-AcceptLicense]
    [<CommonParameters>]

Descrizione

Find-Package trova pacchetti software disponibili nelle origini dei pacchetti. Get-PackageProvider e Get-PackageSource 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: Trovare tutti i pacchetti disponibili da un provider di pacchetti

Questo comando trova tutti i pacchetti di moduli di PowerShell disponibili in una raccolta registrata. Usare Get-PackageProvider per ottenere il nome del provider.

Find-Package -ProviderName NuGet

Name               Version   Source     Summary
----               -------   ------     -------
NUnit              3.11.0    MyNuGet    NUnit is a unit-testing framework for all .NET langua...
Newtonsoft.Json    12.0.1    MyNuGet    Json.NET is a popular high-performance JSON framework...
EntityFramework    6.2.0     MyNuGet    Entity Framework is Microsoft's recommended data acce...
MySql.Data         8.0.15    MyNuGet    MySql.Data.MySqlClient .Net Core Class Library
bootstrap          4.3.1     MyNuGet    Bootstrap framework in CSS. Includes fonts and JavaSc...
NuGet.Core         2.14.0    MyNuGet    NuGet.Core is the core framework assembly for NuGet...

Find-Package usa il parametro Provider per specificare il provider NuGet.

Esempio 2: Trovare un pacchetto da un'origine del pacchetto

Questo comando trova la versione più recente di un pacchetto da un'origine del pacchetto specificata. Se non viene specificata un'origine del pacchetto, Find-Package cerca ogni provider di pacchetti installato e le relative origini dei pacchetti. Usare Get-PackageSource per ottenere il nome di origine.

Find-Package -Name NuGet.Core -Source MyNuGet

Name         Version   Source    Summary
----         -------   ------    -------
NuGet.Core   2.14.0    MyNuGet   NuGet.Core is the core framework assembly for NuGet...

Find-Package usa il parametro Name per specificare il nome del pacchetto NuGet.Core. Il parametro Source specifica di cercare il pacchetto in MyNuGet.

Esempio 3: Trovare tutte le versioni di un pacchetto

Questo comando trova tutte le versioni dei pacchetti disponibili da un provider specificato.

Find-Package -Name NuGet.Core -Source MyNuGet -AllVersions

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.14.0           MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.14.0-rtm-832   MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.13.0           MyNuGet      NuGet.Core is the core framework assembly for NuGet...
...
NuGet.Core    1.1.229.159      MyNuGet      NuGet.Core is the core framework assembly for NuGet...
Nuget.Core    1.0.1120.104     MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Find-Package usa il parametro Name per specificare il pacchetto NuGet.Core. Il parametro ProviderName specifica di cercare il pacchetto in MyNuGet. AllVersions specifica che vengono restituite tutte le versioni disponibili.

Esempio 4: Trovare un pacchetto con un nome e una versione specifici

Questo comando trova una versione specifica del pacchetto da un provider specificato.

Find-Package -Name NuGet.Core -ProviderName NuGet -RequiredVersion 2.9.0

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.9.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Esempio 5: Trovare pacchetti all'interno di un'ampia gamma di versioni

Questo comando trova un intervallo di versioni per un pacchetto specificato.

Find-Package -Name NuGet.Core -ProviderName NuGet -MinimumVersion 2.7.0 -MaximumVersion 2.9.0 -AllVersions

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.9.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.8.6            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.8.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.7.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Find-Package usa il parametro Name per specificare il nome del pacchetto NuGet.Core. Il parametro ProviderName specifica di cercare il pacchetto in NuGet. MinimumVersion specifica la versione più bassa 2.7.0. MaximumVersion specifica la versione più recente 2.9.0. AllVersions determina che l'intervallo viene restituito come specificato dal valore minimo e massimo.

Esempio 6: Trovare un pacchetto da un file system

Questo comando trova i pacchetti con l'estensione .nupkg file archiviata nel computer locale. I file sono pacchetti scaricati da una raccolta, ad esempio NuGet.

PS> Find-Package -Source C:\LocalPkg

Name                 Version    Source           Summary
----                 -------    ------           -------
Microsoft.Web.Xdt    3.0.0      C:\LocalPkg\     Microsoft Xml Document Transformation (XDT)...
NuGet.Core           2.14.0     C:\LocalPkg\     NuGet.Core is the core framework assembly...

Parametri

-AcceptLicense

Accetta automaticamente un contratto di licenza se il pacchetto lo richiede.

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

-AllowPrereleaseVersions

Include i pacchetti contrassegnati come versione preliminare nei risultati.

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

-AllVersions

Indica che Find-Package restituisce tutte le versioni disponibili del pacchetto. Per impostazione predefinita, Find-Package restituisce solo la versione più recente disponibile.

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

-Command

Specifica una matrice di comandi cercati da Find-Package.

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

-ConfigFile

Specifica un file di configurazione.

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

-Contains

Find-Package ottiene oggetti se un elemento nei valori della proprietà dell'oggetto è una corrispondenza esatta per il valore specificato.

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 la ricerca di pacchetti.

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

-DscResource

Specifica una matrice di risorse DSC (Desired State Configuration) cercate da questo cmdlet.

Tipo:	String[]
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 il tag che filtra i risultati. I risultati che non contengono il tag specificato vengono esclusi.

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.

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

-ForceBootstrap

Indica che Find-Package forza PackageManagement a installare automaticamente il provider di pacchetti.

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

-Headers

Specifica le intestazioni per il pacchetto.

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

-IncludeDependencies

Indica che questo cmdlet include le dipendenze dei pacchetti nei risultati.

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

-Includes

Specifica se Find-Package trovare tutti i pacchetti all'interno di una categoria.

I valori accettati 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

-MaximumVersion

Specifica la versione massima del pacchetto che si desidera trovare.

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

-MinimumVersion

Specifica la versione minima del pacchetto che si desidera trovare. Se è disponibile una versione successiva, viene restituita tale versione.

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 o nomi di pacchetti con caratteri jolly. Separare più nomi di pacchetto con virgole.

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

-PackageManagementProvider

Specifica il nome di un provider di gestione pacchetti.

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. Separare più nomi di provider di pacchetti con virgole. Usare Get-PackageProvider per ottenere un elenco dei provider di pacchetti disponibili.

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é una connessione diretta alla 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 un percorso per la pubblicazione del pacchetto.

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

-RequiredVersion

Specifica una versione esatta del pacchetto che si desidera trovare.

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

-ScriptPublishLocation

Specifica un percorso di pubblicazione dello script per il pacchetto.

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

-ScriptSourceLocation

Specifica un percorso di origine dello script.

Tipo:	String
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 del 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. Usare Get-PackageSource per ottenere un elenco delle origini dei pacchetti disponibili. Una directory del file system può essere usata come origine per i pacchetti di download.

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 uno di questi.

Tipo:	String
Valori accettati:	Module, Script, All
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

None

Gli oggetti non possono essere inviati tramite pipe a questo cmdlet.

Output

SoftwareIdentify[]

Questo cmdlet restituisce un oggetto SoftwareIdentity .

Note