Freigeben über


Find-Package

Findet Softwarepakete in verfügbaren Paketquellen.

Syntax

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

Beschreibung

Find-Package findet Softwarepakete, die in Paketquellen verfügbar sind. Get-PackageProvider und Get-PackageSource Zeigen Sie Details zu Ihren Anbietern an.

Von Bedeutung

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

Dieser Befehl findet alle verfügbaren PowerShell-Modulpakete in einem registrierten Katalog. Dient Get-PackageProvider zum Abrufen des Anbieternamens.

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

Beispiel 2: Suchen eines Pakets aus einer Paketquelle

Dieser Befehl findet die neueste Version eines Pakets aus einer angegebenen Paketquelle. Wenn keine Paketquelle bereitgestellt wird, Find-Package durchsucht jeder installierte Paketanbieter und seine Paketquellen. Dient Get-PackageSource zum Abrufen des Quellnamens.

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

Mit diesem Befehl werden alle verfügbaren Paketversionen eines angegebenen Anbieters gefunden.

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 findet eine bestimmte Paketversion eines angegebenen Anbieters.

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 eines Bereichs von Versionen

Dieser Befehl findet einen Bereich 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 wie durch das Minimum und maximum angegeben zurückgegeben wird.

Beispiel 6: Suchen eines Pakets aus einem Dateisystem

Dieser Befehl findet Pakete mit der Dateierweiterung .nupkg , die auf dem lokalen Computer gespeichert sind. Die Dateien sind Pakete, die aus einem Katalog heruntergeladen werden, z. B. 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...

Parameter

-AcceptLicense

Akzeptiert automatisch einen Lizenzvertrag, wenn es für das Paket erforderlich ist.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AllowPrereleaseVersions

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AllVersions

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Command

Gibt ein Array von Befehlen an, nach Find-Packagedem gesucht wird.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ConfigFile

Gibt eine Konfigurationsdatei an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NuGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Contains

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NuGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Credential

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

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DscResource

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Filter

Gibt Ausdrücke an, die in den Eigenschaften Name und Description gesucht werden sollen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FilterOnTag

Gibt das Tag an, das die Ergebnisse filtert. Ergebnisse, die das angegebene Tag nicht enthalten, werden ausgeschlossen.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NuGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ForceBootstrap

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Headers

Gibt die Header für das Paket an.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NuGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IncludeDependencies

Gibt an, dass dieses Cmdlet Paketabhängigkeiten in den Ergebnissen enthält.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Includes

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

Die akzeptierten Werte sind wie folgt:

  • Cmdlet
  • DscResource
  • Funktion
  • Rollenfähigkeit
  • Arbeitsablauf

Parametereigenschaften

Typ:

String[]

Standardwert:None
Zulässige Werte:Cmdlet, DscResource, Function, RoleCapability, Workflow
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MaximumVersion

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MinimumVersion

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PackageManagementProvider

Gibt den Namen eines Paketverwaltungsanbieters an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ProviderName

Gibt einen oder mehrere Paketanbieternamen an. Trennen Sie mehrere Paketanbieternamen durch Kommas. Dient Get-PackageProvider zum Abrufen einer Liste der verfügbaren Paketanbieter.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Zulässige Werte:Bootstrap, NuGet, PowerShellGet
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Anbieter

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Proxy

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

Parametereigenschaften

Typ:Uri
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ProxyCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Verwenden des Proxyservers verfügt, der durch den Proxyparameter angegeben wird.

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PublishLocation

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RequiredVersion

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RoleCapability

Gibt ein Array von Rollenfunktionen an.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ScriptPublishLocation

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ScriptSourceLocation

Gibt einen Skriptquellspeicherort an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SkipValidate

Wechseln, der die Überprüfung der Paketanmeldeinformationen überspringt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NuGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Source

Gibt eine oder mehrere Paketquellen an. Dient Get-PackageSource zum Abrufen einer Liste der verfügbaren Paketquellen. Ein Dateisystemverzeichnis kann als Quelle für Downloadpakete verwendet werden.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Tag

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Type

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

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Module, Script, All
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PowerShellGet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

SoftwareIdentify

Dieses Cmdlet gibt ein SoftwareIdentity-Objekt zurück.

Hinweise

Von Bedeutung

Ab April 2020 unterstützt der PowerShell-Katalog die Tls-Versionen 1.0 und 1.1 nicht mehr. Wenn Sie TLS 1.2 oder höher nicht verwenden, wird beim Versuch, auf den PowerShell-Katalog zuzugreifen, eine Fehlermeldung angezeigt. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:

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

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