Find-Package

Modul:

PackageManagement Module

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

Syntaxe

NuGet

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

PowerShellGet

Find-Package
    [[-Name] <String[]>]
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-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 najde 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 jejich konkrétních argumentech. Další informace najdete v referenční dokumentaci 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. K získání názvu zprostředkovatele použijte Get-PackageProvider.

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

používá parametr poskytovatele k určení poskytovatele NuGet.

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

Tento příkaz najde nejnovější verzi balíčku ze zadaného zdroje balíčku. Pokud zdroj balíčku není zadaný, Find-Package prohledat každého nainstalovaného zprostředkovatele balíčku a jeho zdroje balíčků. K získání názvu zdroje použijte Get-PackageSource.

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

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

používá parametr název k určení balíčku NuGet.Core. Parametr ProviderName určuje, že se má balíček vyhledat vMyNuGet . 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 poskytovatele.

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

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

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

Pokud balíček vyžaduje, automaticky přijme licenční smlouvu.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AllowPrereleaseVersions

Obsahuje balíčky označené jako předběžné verze ve výsledcích.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AllVersions

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Command

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ConfigFile

Určuje konfigurační soubor.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Contains

Find-Package získá objekty, pokud jakákoli položka v hodnotách vlastností objektu je přesná shoda pro zadanou hodnotu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Credential

Určuje uživatelský účet, který má oprávnění hledat balíčky.

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DscResource

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Filter

Určuje termíny, které se mají hledat ve vlastnostech Name a Description.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FilterOnTag

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Force

Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ForceBootstrap

Označuje, že Find-Package vynutí PackageManagement automaticky nainstalovat zprostředkovatele balíčku.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Headers

Určuje hlavičky balíčku.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-IncludeDependencies

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Includes

Určuje, zda má Find-Package najít všechny balíčky v kategorii.

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

• cmdlet
• DscResource
• Funkce
• Schopnost role
• Workflow

Vlastnosti parametru

Typ:	String[]
Default value:	None
Přípustné hodnoty:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MaximumVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MinimumVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PackageManagementProvider

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ProviderName

Určuje jeden nebo více názvů zprostředkovatelů balíčků. Oddělte více názvů zprostředkovatelů balíčků čárkami. Seznam dostupných poskytovatelů balíčků získáte pomocí Get-PackageProvider.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Přípustné hodnoty:	Bootstrap, NuGet, PowerShellGet
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Poskytovatel

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Proxy

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

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ProxyCredential

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

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PublishLocation

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RequiredVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RoleCapability

Určuje pole funkcí rolí.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ScriptPublishLocation

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ScriptSourceLocation

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SkipValidate

Přepněte, který přeskočí ověření přihlašovacích údajů balíčku.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Source

Určuje jeden nebo více zdrojů balíčků. Seznam dostupných zdrojů balíčků získáte pomocí Get-PackageSource. Adresář systému souborů lze použít jako zdroj ke stažení balíčků.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Tag

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Type

Určuje, jestli se mají hledat balíčky s modulem, skriptem nebo některou z těchto.

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	Module, Script, All
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

SoftwareIdentify

Tato rutina vrátí objekt SoftwareIdentity .

Poznámky

Důležité

Od dubna 2020 galerie Prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo vyšší, při pokusu o přístup k galerii Prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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

Další informace najdete v oznámení v blogu PowerShellu.

Související odkazy

• about_SprávaBalíčků
• Get-Package
• Get-PackageProvider
• Get-PackageSource
• Install-Package
• Save-Package
• Odebrat-Balíček