Share via


Find-Package

Megkeresi a szoftvercsomagokat az elérhető csomagforrásokban.

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 megkeresi a csomagforrásokban elérhető szoftvercsomagokat. Get-PackageProvider és Get-PackageSource megjelenítheti a szolgáltatók adatait.

Fontos

A PackageManagement modulban található parancsok eltérnek a Visual Studio Csomagkezelő konzolján található NuGet-modul parancsaitól. Mindegyik modul olyan parancsokkal rendelkezik, amelyek nem érhetők el a másikban. Az azonos nevű parancsok az argumentumaikban különböznek. További információkért tekintse meg a Visual Studio Package Manager-konzoljának PowerShell-referenciadokumentációját .

Példák

1. példa: Csomagszolgáltatótól származó összes elérhető csomag megkeresése

Ez a parancs megkeresi az összes elérhető PowerShell-modulcsomagot egy regisztrált katalógusban. A használatával Get-PackageProvider lekérheti a szolgáltató nevét.

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 a Provider paramétert használja a NuGet szolgáltató megadásához.

2. példa: Csomag megkeresése csomagforrásból

Ez a parancs megkeresi egy csomag legújabb verzióját egy adott csomagforrásból. Ha nincs megadva csomagforrás, Find-Package minden telepített csomagszolgáltatóban és annak csomagforrásaiban keres. A forrásnév lekéréséhez használja a parancsot 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 a Name paramétert használja a NuGet.Core csomagnév megadásához. A Forrás paraméter azt adja meg, hogy a myNuGetben keresse meg a csomagot.

3. példa: Csomag összes verziójának megkeresése

Ez a parancs megkeresi a megadott szolgáltató összes elérhető csomagverzióit.

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 a Name paramétert használja a NuGet.Core csomag megadásához. A ProviderName paraméter azt adja meg, hogy a myNuGetben keresse meg a csomagot. Az AllVersions azt adja meg, hogy a rendszer az összes elérhető verziót visszaadja.

4. példa: Adott nevű és verziójú csomag keresése

Ez a parancs megkeres egy adott csomagverziót egy adott szolgáltatótól.

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 a Name paramétert használja a NuGet.Core csomagnév megadásához. A ProviderName paraméter azt adja meg, hogy a nuGetben keresse meg a csomagot. A RequiredVersion azt adja meg, hogy a rendszer csak a 2.9.0-s verziót adja vissza.

5. példa: Csomagok keresése több verzióban

Ez a parancs egy adott csomaghoz tartozó verziótartományt keres.

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 a Name paramétert használja a NuGet.Core csomagnév megadásához. A ProviderName paraméter azt adja meg, hogy a nuGetben keresse meg a csomagot. A MinimumVersion a legalacsonyabb 2.7.0-s verziót adja meg. A MaximumVersion a legmagasabb 2.9.0-s verziót adja meg. Az AllVersions azt határozza meg, hogy a rendszer a tartományt a minimum és a maximum által megadott módon adja vissza.

6. példa: Csomag keresése fájlrendszerből

Ez a parancs megkeresi a helyi számítógépen tárolt fájlkiterjesztésű .nupkg csomagokat. A fájlok egy katalógusból letöltött csomagok, például a 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...

Paraméterek

-AcceptLicense

Automatikusan elfogadja a licencszerződést, ha a csomag megköveteli.

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

-AllowPrereleaseVersions

Az eredményekben előzetesként megjelölt csomagokat tartalmaz.

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

-AllVersions

Azt jelzi, hogy a Find-Package csomag összes elérhető verzióját visszaadja. Alapértelmezés szerint Find-Package csak a legújabb elérhető verziót adja vissza.

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

-Command

A által Find-Packagekeresett parancsok tömbje.

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

-ConfigFile

Konfigurációs fájlt ad meg.

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

-Contains

Find-Package objektumokat kér le, ha az objektum tulajdonságértékeinek bármelyik eleme pontosan megegyezik a megadott értékkel.

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

-Credential

Olyan felhasználói fiókot ad meg, amely engedéllyel rendelkezik a csomagok kereséséhez.

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

-DscResource

A parancsmag által keresett Desired State Configuration (DSC) erőforrások tömbje.

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

-Filter

A Név és a Leírás tulajdonságban keresendő kifejezéseket adja meg.

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

-FilterOnTag

Meghatározza az eredményeket szűrő címkét. A megadott címkét nem tartalmazó eredmények ki vannak zárva.

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

-Force

Kényszeríti a parancs futtatását a felhasználó megerősítésének kérése nélkül.

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

-ForceBootstrap

Azt jelzi, hogy a Find-PackagePackageManagement kényszeríti a csomagszolgáltató automatikus telepítését.

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

-Headers

Megadja a csomag fejléceit.

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

-IncludeDependencies

Azt jelzi, hogy ez a parancsmag csomagfüggőségeket tartalmaz az eredményekben.

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

-Includes

Meghatározza, hogy az adott kategóriában található-e Find-Package az összes csomag.

Az elfogadott értékek a következők:

  • Parancsmag
  • DscResource
  • Függvény
  • RoleCapability
  • Munkafolyamat
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

Megadja a megkeresni kívánt maximális csomagverziót.

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

-MinimumVersion

Megadja a minimálisan keresett csomagverziót. Ha magasabb verzió érhető el, a rendszer ezt a verziót adja vissza.

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

-Name

Egy vagy több csomagnevet vagy helyettesítő karaktert tartalmazó csomagnevet ad meg. Több csomagnév vesszővel elválasztva.

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

-PackageManagementProvider

Egy csomagkezelő szolgáltató nevét adja meg.

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

-ProviderName

Egy vagy több csomagszolgáltató nevét adja meg. Több csomagszolgáltató neve vesszővel elválasztva. A használatával Get-PackageProvider lekérheti az elérhető csomagszolgáltatók listáját.

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

A kéréshez proxykiszolgálót ad meg, nem pedig az internetes erőforrással való közvetlen kapcsolatot.

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

-ProxyCredential

Olyan felhasználói fiókot ad meg, amely engedéllyel rendelkezik a Proxy paraméter által megadott proxykiszolgáló használatára.

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

-PublishLocation

Megadja a csomag közzétételének helyét.

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

-RequiredVersion

Pontos csomagverziót ad meg, amelyet meg szeretne keresni.

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

-RoleCapability

A szerepkör-képességek tömbjének megadása.

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

-ScriptPublishLocation

Megadja a csomag szkript-közzétételi helyét.

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

-ScriptSourceLocation

Megadja a szkript forráshelyét.

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

-SkipValidate

Kapcsoló, amely kihagyja a csomag hitelesítő adatainak ellenőrzését.

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

-Source

Egy vagy több csomagforrást határoz meg. A használatával Get-PackageSource lekérheti az elérhető csomagforrások listáját. A fájlrendszerkönyvtárak a letöltési csomagok forrásaként használhatók.

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

-Tag

Egy vagy több sztringet ad meg a csomag metaadataiban való kereséshez.

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

-Type

Meghatározza, hogy modullal, szkripttel vagy valamelyikkel szeretne-e csomagokat keresni.

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat átirányítani.

Kimenetek

SoftwareIdentify[]

Ez a parancsmag egy SoftwareIdentity objektumot ad vissza.

Jegyzetek

Fontos

2020 áprilisától a PowerShell-galéria már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. Ha nem TLS 1.2-t vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-galéria elérésekor. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:

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

További információt a PowerShell-blog közleményében talál.