Find-Package
Findet Softwarepakete 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 findet Softwarepakete, die in Paketquellen verfügbar sind.
Get-PackageProvider und Get-PackageSource Zeigen Sie 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 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AllowPrereleaseVersions
Enthält Pakete, die in den Ergebnissen als Vorabversion gekennzeichnet sind.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Command
Gibt ein Array von Befehlen an, nach Find-Packagedem gesucht wird.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ConfigFile
Gibt eine Konfigurationsdatei an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Contains
Find-Package ruft Objekte ab, wenn ein Element in den Eigenschaftswerten des Objekts eine genaue Übereinstimmung für den angegebenen Wert ist.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Credential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Suchen nach Paketen verfügt.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DscResource
Gibt ein Array von DSC-Ressourcen (Desired State Configuration) an, die von diesem Cmdlet durchsucht werden.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Filter
Gibt Ausdrücke an, die in den Eigenschaften Name und Description gesucht werden sollen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-FilterOnTag
Gibt das Tag an, das die Ergebnisse filtert. Ergebnisse, die das angegebene Tag nicht enthalten, werden ausgeschlossen.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Force
Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceBootstrap
Gibt an, dass Find-PackagePackageManagement gezwungen wird, den Paketanbieter automatisch zu installieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Headers
Gibt die Header für das Paket an.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-IncludeDependencies
Gibt an, dass dieses Cmdlet Paketabhängigkeiten in den Ergebnissen enthält.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Includes
Gibt an, ob Find-Package alle Pakete in einer Kategorie gefunden werden sollen.
Die akzeptierten Werte sind wie folgt:
- Cmdlet
- DscResource
- Funktion
- RoleCapability
- Arbeitsablauf
| Typ: | String[] |
| Zulässige Werte: | Cmdlet, DscResource, Function, RoleCapability, Workflow |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MaximumVersion
Gibt die maximale Paketversion an, die Sie suchen möchten.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MinimumVersion
Gibt die Mindestpaketversion an, die Sie suchen möchten. Wenn eine höhere Version verfügbar ist, wird diese Version zurückgegeben.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt einen oder mehrere Paketnamen oder Paketnamen mit Wildcardzeichen an. Trennen Sie mehrere Paketnamen durch Kommas.
| Typ: | String[] |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | True |
-PackageManagementProvider
Gibt den Namen eines Paketverwaltungsanbieters an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | String[] |
| Aliase: | Provider |
| Zulässige Werte: | Bootstrap, NuGet, PowerShellGet |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Proxy
Gibt einen Proxyserver für die Anforderung anstelle einer direkten Verbindung mit der Internetressource an.
| Typ: | Uri |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ProxyCredential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Verwenden des Proxyservers verfügt, der durch den Proxyparameter angegeben wird.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PublishLocation
Gibt einen Speicherort für die Veröffentlichung des Pakets an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RequiredVersion
Gibt eine genaue Paketversion an, die Sie suchen möchten.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RoleCapability
Gibt ein Array von Rollenfunktionen an.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ScriptPublishLocation
Gibt einen Skriptveröffentlichungsspeicherort für das Paket an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ScriptSourceLocation
Gibt einen Skriptquellspeicherort an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SkipValidate
Wechseln, der die Überprüfung der Paketanmeldeinformationen überspringt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Tag
Gibt eine oder mehrere Zeichenfolgen an, nach der in den Paketmetadaten gesucht werden soll.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Type
Gibt an, ob nach Paketen mit einem Modul, einem Skript oder einem anderen gesucht werden soll.
| Typ: | String |
| Zulässige Werte: | Module, Script, All |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Sie können keine Objekte an dieses Cmdlet weiterleiten.
Ausgaben
SoftwareIdentify[]
Dieses Cmdlet gibt ein SoftwareIdentity-Objekt zurück.
Hinweise
Wichtig
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.
