Find-Package

Reference

Modul:: PackageManagement

Vyhledá softwarové balíčky v dostupných zdrojích balíčků.

Syntax

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>]

Description

Find-Package vyhledá softwarové balíčky, které jsou k dispozici ve zdrojích balíčků. Get-PackageProvider a Get-PackageSource zobrazit podrobnosti o vašich poskytovatelích.

Důležité

Příkazy obsažené v modulu PackageManagement se liší od příkazů poskytovaných modulem NuGet v konzole Správce balíčků sady Visual Studio. Každý modul obsahuje příkazy, které nejsou k dispozici v druhém modulu. Příkazy se stejným názvem se liší v konkrétních argumentech. Další informace najdete v referenční dokumentaci k PowerShellu pro konzolu Správce balíčků sady Visual Studio.

Příklady

Příklad 1: Vyhledání všech dostupných balíčků od poskytovatele balíčků

Tento příkaz najde všechny dostupné balíčky modulů PowerShellu v registrované galerii. Použijte Get-PackageProvider k získání názvu zprostředkovatele.

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 Použije parametr Provider k určení zprostředkovatele NuGet.

Příklad 2: Vyhledání balíčku ze zdroje balíčku

Tento příkaz vyhledá nejnovější verzi balíčku ze zadaného zdroje balíčku. Pokud zdroj balíčku není k dispozici, Find-Package prohledává každého nainstalovaného poskytovatele balíčků a jeho zdroje balíčků. Použijte Get-PackageSource k získání názvu zdroje.

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 použije parametr Name k zadání názvu balíčku NuGet.Core. Parametr Source určuje, že se má vyhledat balíček v MyNuGet.

Příklad 3: Vyhledání všech verzí balíčku

Tento příkaz najde všechny dostupné verze balíčků od zadaného zprostředkovatele.

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 použije parametr Name k zadání balíčku NuGet.Core. Parametr ProviderName určuje, že se má balíček vyhledat v MyNuGet. AllVersions určuje, že se vrátí všechny dostupné verze.

Příklad 4: Vyhledání balíčku s konkrétním názvem a verzí

Tento příkaz najde konkrétní verzi balíčku od zadaného zprostředkovatele.

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 použije parametr Name k zadání názvu balíčku NuGet.Core. Parametr ProviderName určuje, že se má balíček vyhledat v NuGetu. RequiredVersion určuje, že je vrácena pouze verze 2.9.0 .

Příklad 5: Vyhledání balíčků v rozsahu verzí

Tento příkaz najde rozsah verzí pro zadaný balíček.

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 použije parametr Name k zadání názvu balíčku NuGet.Core. Parametr ProviderName určuje, že se má balíček vyhledat v NuGetu. MinimumVersion určuje nejnižší verzi 2.7.0. MaximumVersion určuje nejvyšší verzi 2.9.0. AllVersions určuje, že rozsah se vrátí podle minimálních a maximálních hodnot.

Příklad 6: Vyhledání balíčku ze systému souborů

Tento příkaz vyhledá balíčky s příponou .nupkg souboru, které jsou uložené v místním počítači. Soubory jsou balíčky stažené z galerie, jako je 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...

Parametry

-AcceptLicense

Automaticky přijme licenční smlouvu, pokud to balíček vyžaduje.

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

-AllowPrereleaseVersions

Zahrne do výsledků balíčky označené jako předběžné vydání.

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

-AllVersions

Označuje, že Find-Package vrátí všechny dostupné verze balíčku. Ve výchozím nastavení Find-Package vrátí jenom nejnovější dostupnou verzi.

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

-Command

Určuje pole příkazů prohledáných nástrojem Find-Package.

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

-ConfigFile

Určuje konfigurační soubor.

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

-Contains

Find-Package získá objekty, pokud se některá položka v hodnotách vlastnosti objektu přesně shoduje se zadanou hodnotou.

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

-Credential

Určuje uživatelský účet, který má oprávnění k vyhledávání balíčků.

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

-DscResource

Určuje pole prostředků Desired State Configuration (DSC), které tato rutina prohledá.

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

-Filter

Určuje termíny, které se mají hledat ve vlastnostech Název a Popis .

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

-FilterOnTag

Určuje značku, která filtruje výsledky. Výsledky, které neobsahují zadanou značku, jsou vyloučené.

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

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

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

-ForceBootstrap

Označuje, že Find-Packagevynutí, aby PackageManagement automaticky nainstaloval zprostředkovatele balíčku.

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

-Headers

Určuje hlavičky balíčku.

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

-IncludeDependencies

Označuje, že tato rutina zahrnuje závislosti balíčků ve výsledcích.

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

-Includes

Určuje, jestli Find-Package mají najít všechny balíčky v rámci kategorie.

Přijaté hodnoty jsou následující:

Rutina
DscResource
Funkce
RoleCapability
Pracovní postup

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

Určuje maximální verzi balíčku, kterou chcete najít.

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

-MinimumVersion

Určuje minimální verzi balíčku, kterou chcete najít. Pokud je k dispozici vyšší verze, vrátí se tato verze.

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

-Name

Určuje jeden nebo více názvů balíčků nebo názvů balíčků se zástupnými znaky. Několik názvů balíčků oddělte čárkami.

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

-PackageManagementProvider

Určuje název zprostředkovatele správy balíčků.

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

-ProviderName

Určuje jeden nebo více názvů zprostředkovatelů balíčků. Oddělte několik názvů zprostředkovatelů balíčků čárkami. Použijte Get-PackageProvider k získání seznamu dostupných poskytovatelů balíčků.

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

Určuje proxy server pro požadavek, nikoli přímé připojení k internetovému prostředku.

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

-ProxyCredential

Určuje uživatelský účet, který má oprávnění používat proxy server určený parametrem Proxy .

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

-PublishLocation

Určuje umístění pro publikování balíčku.

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

-RequiredVersion

Určuje přesnou verzi balíčku, kterou chcete najít.

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

-RoleCapability

Určuje pole funkcí rolí.

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

-ScriptPublishLocation

Určuje umístění publikování skriptu pro balíček.

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

-ScriptSourceLocation

Určuje umístění zdroje skriptu.

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

-SkipValidate

Přepínač, který přeskočí ověřování přihlašovacích údajů balíčku.

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

-Source

Určuje jeden nebo více zdrojů balíčků. Použijte Get-PackageSource k získání seznamu dostupných zdrojů balíčků. Adresář systému souborů lze použít jako zdroj pro stahování balíčků.

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

-Tag

Určuje jeden nebo více řetězců, které se mají vyhledat v metadatech balíčku.

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

-Type

Určuje, zda mají být balíčky vyhledávány pomocí modulu, skriptu nebo některého z těchto modulů.

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

Vstupy

None

Do této rutiny nemůžete připojit objekty.

Výstupy

SoftwareIdentify[]

Tato rutina vrátí objekt SoftwareIdentity .

Poznámky