Freigeben über


Find-Package

Sucht Nach Softwarepaketen in verfügbaren Paketquellen.

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

Beschreibung

Find-Package sucht Nach Softwarepaketen, die in Paketquellen verfügbar sind. Get-PackageProvider und Get-PackageSource zeigen Details zu Ihren Anbietern an.

Wichtig

Die im PackageManagement-Modul enthaltenen Befehle unterscheiden sich von den Befehlen, die vom NuGet-Modul in der Paket-Manager-Konsole von Visual Studio bereitgestellt werden. Jedes Modul verfügt über Befehle, die in dem anderen nicht verfügbar sind. Befehle mit demselben Namen unterscheiden sich in ihren spezifischen Argumenten. Weitere Informationen finden Sie in der PowerShell-Referenzdokumentation für die Paket-Manager-Konsole von Visual Studio.

Beispiele

Beispiel 1: Suchen aller verfügbaren Pakete von einem Paketanbieter

Mit diesem Befehl werden alle verfügbaren PowerShell-Modulpakete in einem registrierten Katalog gefunden. Verwenden Sie Get-PackageProvider , um den Anbieternamen abzurufen.

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 verwendet den Parameter Provider , um den Anbieter NuGet anzugeben.

Beispiel 2: Suchen eines Pakets aus einer Paketquelle

Dieser Befehl sucht die neueste Version eines Pakets aus einer angegebenen Paketquelle. Wenn keine Paketquelle bereitgestellt wird, Find-Package durchsucht jeden installierten Paketanbieter und die zugehörigen Paketquellen. Verwenden Sie Get-PackageSource , um den Quellnamen abzurufen.

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 verwendet den Parameter Name , um den Paketnamen NuGet.Core anzugeben. Der Source-Parameter gibt an, nach dem Paket in MyNuGet zu suchen.

Beispiel 3: Suchen aller Versionen eines Pakets

Dieser Befehl sucht alle verfügbaren Paketversionen eines angegebenen Anbieters.

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 verwendet den Parameter Name , um das Paket NuGet.Core anzugeben. Der Parameter ProviderName gibt an, nach dem Paket in MyNuGet zu suchen. AllVersions gibt an, dass alle verfügbaren Versionen zurückgegeben werden.

Beispiel 4: Suchen eines Pakets mit einem bestimmten Namen und einer bestimmten Version

Dieser Befehl sucht eine bestimmte Paketversion von einem angegebenen Anbieter.

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 verwendet den Parameter Name , um den Paketnamen NuGet.Core anzugeben. Der Parameter ProviderName gibt an, nach dem Paket in NuGet zu suchen. RequiredVersion gibt an, dass nur Version 2.9.0 zurückgegeben wird.

Beispiel 5: Suchen von Paketen innerhalb einer Reihe von Versionen

Dieser Befehl sucht nach einer Reihe von Versionen für ein angegebenes Paket.

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 verwendet den Parameter Name , um den Paketnamen NuGet.Core anzugeben. Der Parameter ProviderName gibt an, nach dem Paket in NuGet zu suchen. MinimumVersion gibt die niedrigste Version 2.7.0 an. MaximumVersion gibt die höchste Version 2.9.0 an. AllVersions bestimmt, dass der Bereich zurückgegeben wird, wie vom Minimum und Maximum angegeben.

Beispiel 6: Suchen eines Pakets aus einem Dateisystem

Mit diesem Befehl werden Pakete mit der Dateierweiterung .nupkg gefunden, die auf dem lokalen Computer gespeichert sind. Bei den Dateien handelt es sich um Pakete, die aus einem Katalog wie nuGet heruntergeladen werden.

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

Parameter

-AcceptLicense

Akzeptiert automatisch einen Lizenzvertrag, wenn das Paket dies erfordert.

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

-AllowPrereleaseVersions

Enthält Pakete, die als Vorabversion in den Ergebnissen markiert sind.

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

-AllVersions

Gibt an, dass Find-Package alle verfügbaren Versionen des Pakets zurückgibt. Standardmäßig Find-Package wird nur die neueste verfügbare Version zurückgegeben.

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

-Command

Gibt ein Array von Befehlen an, die von durchsucht werden Find-Package.

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

-ConfigFile

Gibt eine Konfigurationsdatei an.

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

-Contains

Find-Package ruft Objekte ab, wenn ein Element in den Eigenschaftswerten des Objekts eine genaue Übereinstimmung mit dem angegebenen Wert ist.

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

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Suchen nach Paketen verfügt.

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

-DscResource

Gibt ein Array von Desired State Configuration (DSC)-Ressourcen an, die dieses Cmdlet durchsucht.

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

-Filter

Gibt Begriffe an, nach den in den Eigenschaften Name und Beschreibung gesucht werden sollen.

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

-FilterOnTag

Gibt das Tag an, mit dem die Ergebnisse gefiltert werden. Ergebnisse, die das angegebene Tag nicht enthalten, werden ausgeschlossen.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-ForceBootstrap

Gibt an, dass Find-PackagePackageManagement erzwingt, den Paketanbieter automatisch zu installieren.

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

-Headers

Gibt die Header für das Paket an.

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

-IncludeDependencies

Gibt an, dass dieses Cmdlet Paketabhängigkeiten in die Ergebnisse einschließt.

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

-Includes

Gibt an, ob Find-Package alle Pakete innerhalb einer Kategorie gefunden werden sollen.

Die akzeptierten Werte sind wie folgt:

  • Cmdlet
  • DscResource
  • Funktion
  • RoleCapability
  • Workflow
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

Gibt die maximale Paketversion an, die Sie finden möchten.

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

-MinimumVersion

Gibt die Mindestpaketversion an, die Sie finden möchten. Wenn eine höhere Version verfügbar ist, wird diese Version zurückgegeben.

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

-Name

Gibt einen oder mehrere Paketnamen oder Paketnamen mit Wildcardzeichen an. Trennen Sie mehrere Paketnamen durch Kommas.

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

-PackageManagementProvider

Gibt den Namen eines Paketverwaltungsanbieters an.

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

-ProviderName

Gibt einen oder mehrere Paketanbieternamen an. Trennen Sie mehrere Paketanbieternamen durch Kommas. Verwenden Sie Get-PackageProvider , um eine Liste der verfügbaren Paketanbieter abzurufen.

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

Gibt einen Proxyserver für die Anforderung anstelle einer direkten Verbindung mit der Internetressource an.

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

-ProxyCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zur Verwendung des Proxyservers verfügt, der durch den Proxy-Parameter angegeben wird.

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

-PublishLocation

Gibt einen Speicherort für die Veröffentlichung des Pakets an.

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

-RequiredVersion

Gibt eine genaue Paketversion an, die Sie finden möchten.

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

-RoleCapability

Gibt ein Array von Rollenfunktionen an.

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

-ScriptPublishLocation

Gibt einen Skriptveröffentlichungsspeicherort für das Paket an.

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

-ScriptSourceLocation

Gibt einen Skriptquellspeicherort an.

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

-SkipValidate

Switch, der die Überprüfung von Paketanmeldeinformationen überspringt.

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

-Source

Gibt mindestens eine Paketquelle an. Verwenden Sie Get-PackageSource , um eine Liste der verfügbaren Paketquellen abzurufen. Ein Dateisystemverzeichnis kann als Quelle für Downloadpakete verwendet werden.

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

-Tag

Gibt eine oder mehrere Zeichenfolgen an, nach der in den Paketmetadaten gesucht werden soll.

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

-Type

Gibt an, ob nach Paketen mit einem Modul, einem Skript oder einem gesucht werden soll.

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

Eingaben

None

Sie können keine Objekte an dieses Cmdlet übergeben.

Ausgaben

SoftwareIdentify[]

Dieses Cmdlet gibt ein SoftwareIdentity-Objekt zurück.

Hinweise

Wichtig

Ab April 2020 unterstützt der PowerShell-Katalog die TLS-Versionen (Transport Layer Security) 1.0 und 1.1 nicht mehr. Wenn Sie nicht TLS 1.2 oder höher verwenden, erhalten Sie beim Versuch des Zugriffs auf den PowerShell-Katalog eine Fehlermeldung. Mit dem folgenden Befehl können Sie sicherstellen, dass Sie TLS 1.2 verwenden:

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

Weitere Informationen finden Sie im PowerShell-Blog in der Ankündigung.