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