Condividi tramite


Find-Package

Trova 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 del pacchetto. 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 ha 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 un'origine del pacchetto non è specificata, Find-Package cerca ogni provider di pacchetti installato e le relative origini del pacchetto. 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 per cercare il pacchetto in MyNuGet.

Esempio 3: Trovare tutte le versioni di un pacchetto

Questo comando trova tutte le versioni del pacchetto 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 per cercare il pacchetto in MyNuGet. AllVersions specifica che tutte le versioni disponibili vengono restituite.

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

Questo comando trova una versione del pacchetto specifica 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...

Find-Package usa il parametro Name per specificare il nome del pacchetto NuGet.Core. Il parametro ProviderName specifica per cercare il pacchetto in NuGet. RequiredVersion specifica che viene restituita solo la versione 2.9.0 .

Esempio 5: Trovare pacchetti all'interno di un intervallo 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 per cercare il pacchetto in NuGet. MinimumVersion specifica la versione più bassa 2.7.0. MaximumVersion specifica la versione 2.9.0 più alta. 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.

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

-AllowPrereleaseVersions

Include pacchetti contrassegnati come versione preliminare nei risultati.

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

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

-Command

Specifica una matrice di comandi ricercati da Find-Package.

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

-ConfigFile

Specifica un file di configurazione.

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

-Contains

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

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

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

-DscResource

Specifica una matrice di risorse Desired State Configuration (DSC) che il cmdlet cerca.

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

-Filter

Specifica i termini per cercare all'interno delle proprietà Name e Description .

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

-FilterOnTag

Specifica il tag che filtra i risultati. I risultati che non contengono il tag specificato sono esclusi.

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.

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

-ForceBootstrap

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

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

-Headers

Specifica le intestazioni per il pacchetto.

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

-IncludeDependencies

Indica che questo cmdlet include le dipendenze del pacchetto nei risultati.

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

-Includes

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

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

-MaximumVersion

Specifica la versione massima del pacchetto che si desidera trovare.

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

-MinimumVersion

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

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

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

-PackageManagementProvider

Specifica il nome di un provider di gestione pacchetti.

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

-ProviderName

Specifica uno o più nomi del provider di pacchetti. Separare più nomi del provider di pacchetti con virgole. Usare Get-PackageProvider per ottenere un elenco di provider di pacchetti disponibili.

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é una connessione diretta alla risorsa Internet.

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

-ProxyCredential

Specifica un account utente con autorizzazioni per l'uso del 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 un percorso per la pubblicazione del pacchetto.

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

-RequiredVersion

Specifica una versione esatta del pacchetto che si desidera trovare.

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

-ScriptPublishLocation

Specifica un percorso di pubblicazione script per il pacchetto.

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

-ScriptSourceLocation

Specifica un percorso di origine script.

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

-SkipValidate

Switch che ignora la convalida delle credenziali del pacchetto.

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

-Source

Specifica una o più origini pacchetti. Usare Get-PackageSource per ottenere un elenco di origini pacchetti disponibili. Una directory del file system può essere usata come origine per i pacchetti di download.

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 uno dei due.

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

Input

None

Non è possibile eseguire la pipe degli oggetti a questo cmdlet.

Output

SoftwareIdentify[]

Questo cmdlet restituisce un oggetto SoftwareIdentity .

Note

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.