Find-Package

Odwołanie

Moduł:: PackageManagement

Wyszukuje pakiety oprogramowania w dostępnych źródłach pakietów.

Składnia

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

Opis

Find-Package program znajduje pakiety oprogramowania, które są dostępne w źródłach pakietów. Get-PackageProvider i Get-PackageSource wyświetlić szczegółowe informacje o dostawcach.

Ważne

Polecenia zawarte w module PackageManagement różnią się od poleceń dostarczonych przez moduł NuGet w konsoli menedżera pakietów programu Visual Studio. Każdy moduł ma polecenia, które nie są dostępne w drugiej. Polecenia o tej samej nazwie różnią się w swoich konkretnych argumentach. Aby uzyskać więcej informacji, zobacz dokumentację referencyjną programu PowerShell dotyczącą konsoli menedżera pakietów programu Visual Studio.

Przykłady

Przykład 1. Znajdowanie wszystkich dostępnych pakietów od dostawcy pakietów

To polecenie znajduje wszystkie dostępne pakiety modułów programu PowerShell w zarejestrowanej galerii. Użyj polecenia Get-PackageProvider , aby uzyskać nazwę dostawcy.

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 używa parametru Dostawcy , aby określić dostawcę NuGet.

Przykład 2. Znajdowanie pakietu ze źródła pakietu

To polecenie znajduje najnowszą wersję pakietu z określonego źródła pakietu. Jeśli źródło pakietu nie zostanie podane, Find-Package przeszukuje każdego zainstalowanego dostawcę pakietów i jego źródła pakietów. Użyj polecenia Get-PackageSource , aby uzyskać nazwę źródła.

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 używa parametru Name , aby określić nazwę pakietu NuGet.Core. Parametr Source określa, aby wyszukać pakiet w myNuGet.

Przykład 3. Znajdowanie wszystkich wersji pakietu

To polecenie znajduje wszystkie dostępne wersje pakietów od określonego dostawcy.

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 używa parametru Name do określenia pakietu NuGet.Core. Parametr ProviderName określa, aby wyszukać pakiet w myNuGet. AllVersions określa, że są zwracane wszystkie dostępne wersje.

Przykład 4. Znajdowanie pakietu o określonej nazwie i wersji

To polecenie znajduje określoną wersję pakietu od określonego dostawcy.

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 używa parametru Name , aby określić nazwę pakietu NuGet.Core. Parametr ProviderName określa, aby wyszukać pakiet w pakiecie NuGet. RequiredVersion określa, że jest zwracana tylko wersja 2.9.0 .

Przykład 5. Znajdowanie pakietów w zakresie wersji

To polecenie znajduje zakres wersji dla określonego pakietu.

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 używa parametru Name , aby określić nazwę pakietu NuGet.Core. Parametr ProviderName określa, aby wyszukać pakiet w pakiecie NuGet. MinimumVersion określa najniższą wersję 2.7.0. MaximumVersion określa najwyższą wersję 2.9.0. AllVersions określa zakres jest zwracany zgodnie z wartością minimalną i maksymalną.

Przykład 6. Znajdowanie pakietu z systemu plików

To polecenie znajduje pakiety z rozszerzeniem .nupkg pliku, które są przechowywane na komputerze lokalnym. Pliki to pakiety pobierane z galerii, takiej jak 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...

Parametry

-AcceptLicense

Automatycznie akceptuje umowę licencyjną, jeśli pakiet go wymaga.

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

-AllowPrereleaseVersions

Obejmuje pakiety oznaczone jako wersję wstępną w wynikach.

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

-AllVersions

Wskazuje, że Find-Package zwraca wszystkie dostępne wersje pakietu. Domyślnie Find-Package zwraca tylko najnowszą dostępną wersję.

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

-Command

Określa tablicę poleceń przeszukanych przez Find-Package.

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

-ConfigFile

Określa plik konfiguracji.

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

-Contains

Find-Package pobiera obiekty, jeśli dowolny element w wartościach właściwości obiektu jest dokładnie zgodny z określoną wartością.

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

-Credential

Określa konto użytkownika, które ma uprawnienia do wyszukiwania pakietów.

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

-DscResource

Określa tablicę zasobów Desired State Configuration (DSC), które to polecenie cmdlet wyszukuje.

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

-Filter

Określa terminy do wyszukania we właściwościach Nazwa i Opis .

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

-FilterOnTag

Określa tag, który filtruje wyniki. Wyniki, które nie zawierają określonego tagu, są wykluczone.

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

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

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

-ForceBootstrap

Wskazuje, że Find-Package polecenie PackageManagement wymusza automatyczne zainstalowanie dostawcy pakietów.

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

-Headers

Określa nagłówki pakietu.

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

-IncludeDependencies

Wskazuje, że to polecenie cmdlet zawiera zależności pakietów w wynikach.

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

-Includes

Określa, czy Find-Package powinny znajdować wszystkie pakiety w kategorii.

Akceptowane wartości są następujące:

Polecenie cmdlet
DscResource
Funkcja
RoleCapability
Przepływ pracy

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

Określa maksymalną wersję pakietu, którą chcesz znaleźć.

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

-MinimumVersion

Określa minimalną wersję pakietu, którą chcesz znaleźć. Jeśli jest dostępna wyższa wersja, zwracana jest ta wersja.

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

-Name

Określa co najmniej jedną nazwę pakietu lub nazwy pakietów z symbolami wieloznacznymi. Oddziel wiele nazw pakietów przecinkami.

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

-PackageManagementProvider

Określa nazwę dostawcy zarządzania pakietami.

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

-ProviderName

Określa co najmniej jedną nazwę dostawcy pakietów. Oddziel wiele nazw dostawców pakietów przecinkami. Użyj Get-PackageProvider polecenia , aby uzyskać listę dostępnych dostawców pakietów.

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

Określa serwer proxy dla żądania, a nie bezpośrednie połączenie z zasobem internetowym.

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

-ProxyCredential

Określa konto użytkownika, które ma uprawnienia do korzystania z serwera proxy, który jest określony przez parametr proxy .

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

-PublishLocation

Określa lokalizację publikowania pakietu.

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

-RequiredVersion

Określa dokładną wersję pakietu, którą chcesz znaleźć.

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

-RoleCapability

Określa tablicę możliwości roli.

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

-ScriptPublishLocation

Określa lokalizację publikowania skryptu dla pakietu.

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

-ScriptSourceLocation

Określa lokalizację źródłową skryptu.

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

-SkipValidate

Przełącz pomijający weryfikację poświadczeń pakietu.

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

-Source

Określa co najmniej jedno źródło pakietu. Użyj Get-PackageSource polecenia , aby uzyskać listę dostępnych źródeł pakietów. Katalog systemu plików może służyć jako źródło pakietów pobierania.

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

-Tag

Określa co najmniej jeden ciąg do wyszukania w metadanych pakietu.

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

-Type

Określa, czy wyszukiwać pakiety za pomocą modułu, skryptu, czy też.

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

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

SoftwareIdentify[]

To polecenie cmdlet zwraca obiekt SoftwareIdentity .

Uwagi

Ważne

Od kwietnia 2020 r. Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do Galeria programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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

Aby uzyskać więcej informacji, zobacz ogłoszenie w blogu programu PowerShell.

Udostępnij za pośrednictwem

Find-Package

Składnia

Opis

Przykłady

Przykład 1. Znajdowanie wszystkich dostępnych pakietów od dostawcy pakietów

Przykład 2. Znajdowanie pakietu ze źródła pakietu

Przykład 3. Znajdowanie wszystkich wersji pakietu

Przykład 4. Znajdowanie pakietu o określonej nazwie i wersji

Przykład 5. Znajdowanie pakietów w zakresie wersji

Przykład 6. Znajdowanie pakietu z systemu plików

Parametry

-AcceptLicense

-AllowPrereleaseVersions

-AllVersions

-Command

-ConfigFile

-Contains

-Credential

-DscResource

-Filter

-FilterOnTag

-Force

-ForceBootstrap

-Headers

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-PackageManagementProvider

-ProviderName

-Proxy

-ProxyCredential

-PublishLocation

-RequiredVersion

-RoleCapability

-ScriptPublishLocation

-ScriptSourceLocation

-SkipValidate

-Source

-Tag

-Type

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby