Find-Package

Ссылка

Модуль:: PackageManagement

Находит пакеты программного обеспечения в доступных источниках пакетов.

Синтаксис

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

Описание

Find-Package находит пакеты программного обеспечения, доступные в источниках пакетов. Get-PackageProvider и Get-PackageSource отображение сведений о поставщиках.

Важно!

Команды, содержащиеся в модуле PackageManagement , отличаются от команд, предоставляемых модулем NuGet в консоли диспетчера пакетов Visual Studio. Каждый модуль содержит команды, недоступные в другом. Команды с одинаковым именем отличаются по конкретным аргументам. Дополнительные сведения см. в справочной документации по PowerShell для консоли диспетчера пакетов Visual Studio.

Примеры

Пример 1. Поиск всех доступных пакетов от поставщика пакетов

Эта команда находит все доступные пакеты модулей PowerShell в зарегистрированной коллекции. Используйте Get-PackageProvider для получения имени поставщика.

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 использует параметр Provider , чтобы указать поставщик NuGet.

Пример 2. Поиск пакета из источника пакета

Эта команда находит последнюю версию пакета из указанного источника пакета. Если источник пакета не указан, Find-Package выполняется поиск по каждому установленному поставщику пакетов и его источникам пакетов. Используйте Get-PackageSource для получения имени источника.

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 использует параметр Name для указания имени пакета NuGet.Core. Параметр Source указывает на поиск пакета в MyNuGet.

Пример 3. Поиск всех версий пакета

Эта команда находит все доступные версии пакетов от указанного поставщика.

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 использует параметр Name для указания пакета NuGet.Core. Параметр ProviderName указывает на поиск пакета в MyNuGet. AllVersions указывает, что возвращаются все доступные версии.

Пример 4. Поиск пакета с определенным именем и версией

Эта команда находит определенную версию пакета от указанного поставщика.

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 использует параметр Name для указания имени пакета NuGet.Core. Параметр ProviderName указывает на поиск пакета в NuGet. RequiredVersion указывает, что возвращается только версия 2.9.0 .

Пример 5. Поиск пакетов в диапазоне версий

Эта команда находит диапазон версий для указанного пакета.

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 использует параметр Name для указания имени пакета NuGet.Core. Параметр ProviderName указывает на поиск пакета в NuGet. MinimumVersion указывает наименьшую версию 2.7.0. MaximumVersion указывает самую высокую версию 2.9.0. AllVersions определяет, что диапазон возвращается в соответствии с минимальными и максимальными значениями.

Пример 6. Поиск пакета из файловой системы

Эта команда находит пакеты с расширением .nupkg файла, которые хранятся на локальном компьютере. Файлы представляют собой пакеты, скачанные из коллекции, например 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...

Параметры

-AcceptLicense

Автоматически принимает лицензионное соглашение, если это требуется пакету.

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

-AllowPrereleaseVersions

Включает пакеты, помеченные как предварительные выпуски, в результатах.

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

-AllVersions

Указывает, что Find-Package возвращает все доступные версии пакета. По умолчанию Find-Package возвращает только самую новую доступную версию.

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

-Command

Задает массив команд, поиск по которым выполняется .Find-Package

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

-ConfigFile

Указывает файл конфигурации.

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

-Contains

Find-Package получает объекты, если какой-либо элемент в значениях свойств объекта точно соответствует указанному значению.

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

-Credential

Указывает учетную запись пользователя, которая имеет разрешение на поиск пакетов.

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

-DscResource

Указывает массив ресурсов Desired State Configuration (DSC), которые выполняет этот командлет.

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

-Filter

Указывает термины для поиска в свойствах Name и Description .

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

-FilterOnTag

Указывает тег, который фильтрует результаты. Результаты, не содержащие указанный тег, исключаются.

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

-Force

Принудительное выполнение команды без запроса на подтверждение пользователем.

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

-ForceBootstrap

Указывает, что Find-PackagepackageManagement автоматически устанавливает поставщик пакетов.

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

-Headers

Указывает заголовки для пакета.

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

-IncludeDependencies

Указывает, что этот командлет включает в результаты зависимости пакета.

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

-Includes

Указывает, следует ли Find-Package находить все пакеты в категории.

Допустимые значения:

Командлет
DscResource
Функция
RoleCapability
Рабочий процесс

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

Указывает максимальную версию пакета, которую требуется найти.

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

-MinimumVersion

Указывает минимальную версию пакета, которую требуется найти. Если доступна более поздняя версия, возвращается эта версия.

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

-Name

Указывает одно или несколько имен пакетов или имен пакетов с подстановочными знаками. Разделите несколько имен пакетов запятыми.

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

-PackageManagementProvider

Указывает имя поставщика управления пакетами.

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

-ProviderName

Задает одно или несколько имен поставщиков пакетов. Разделяйте имена поставщиков пакетов запятыми. Используйте для Get-PackageProvider получения списка доступных поставщиков пакетов.

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

Указывает прокси-сервер для запроса, а не прямое подключение к интернет-ресурсу.

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

-ProxyCredential

Указывает учетную запись пользователя, имеющую разрешение на использование прокси-сервера, который задается параметром Proxy.

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

-PublishLocation

Указывает расположение для публикации пакета.

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

-RequiredVersion

Указывает точную версию пакета, которую требуется найти.

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

-RoleCapability

Задает массив возможностей роли.

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

-ScriptPublishLocation

Указывает расположение публикации скрипта для пакета.

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

-ScriptSourceLocation

Указывает расположение источника скрипта.

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

-SkipValidate

Параметр, пропускающий проверку учетных данных пакета.

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

-Source

Указывает один или несколько источников пакетов. Используйте Get-PackageSource для получения списка доступных источников пакетов. Каталог файловой системы можно использовать в качестве источника для скачивания пакетов.

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

-Tag

Указывает одну или несколько строк для поиска в метаданных пакета.

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

-Type

Указывает, следует ли искать пакеты с помощью модуля, скрипта или .

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

Входные данные

None

Вы не можете передавать объекты в этот командлет.

Выходные данные

SoftwareIdentify[]

Этот командлет возвращает объект SoftwareIdentity .

Примечания