通过

Find-Package

模块:
PackageManagement Module

查找可用包源中的软件包。

语法

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

说明

Find-Package 查找包源中可用的软件包。 Get-PackageProvider 和 Get-PackageSource 显示有关提供程序的详细信息。

重要

PackageManagement 模块中包含的命令不同于 Visual Studio 的包管理器控制台中 NuGet 模块提供的命令。 每个模块都有在其他模块中不可用的命令。 具有相同名称的命令在其特定参数中有所不同。 有关详细信息，请参阅 Visual Studio 的包管理器控制台的 PowerShell 参考 文档。

示例

示例 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 使用 提供程序 参数来指定提供程序 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...

使用 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...

使用 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...

使用 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...

使用 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

如果包需要许可协议，则自动接受许可协议。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AllowPrereleaseVersions

在结果中包含标记为预发行版的包。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AllVersions

指示 Find-Package 返回包的所有可用版本。 默认情况下，Find-Package 仅返回最新可用版本。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Command

指定由 Find-Package搜索的命令数组。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ConfigFile

指定配置文件。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

NuGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Contains

Find-Package 如果对象的属性值中的任何项与指定值完全匹配，则获取对象。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

NuGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Credential

指定有权搜索包的用户帐户。

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DscResource

指定此 cmdlet 搜索的 Desired State Configuration （DSC） 资源的数组。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Filter

指定要在 名称 和 说明 属性中搜索的术语。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FilterOnTag

指定筛选结果的标记。 不包括不包含指定标记的结果。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

NuGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Force

强制命令运行而不要求用户确认。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ForceBootstrap

指示 Find-Package 强制 PackageManagement 自动安装包提供程序。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Headers

指定包的标头。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

NuGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IncludeDependencies

指示此 cmdlet 在结果中包含包依赖项。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Includes

指定 Find-Package 是否应查找类别中的所有包。

接受的值如下所示：

  • Cmdlet (命令行工具)
  • DscResource
  • 功能
  • RoleCapability
  • Workflow

参数属性

类型:

String[]

默认值:None
接受的值:Cmdlet, DscResource, Function, RoleCapability, Workflow
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-MaximumVersion

指定要查找的最大包版本。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-MinimumVersion

指定要查找的最低包版本。 如果较高版本可用，则返回该版本。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Name

指定一个或多个包名称，或包含通配符的包名称。 用逗号分隔多个包名称。

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

(All)
Position:0
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PackageManagementProvider

指定包管理提供程序的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ProviderName

指定一个或多个包提供程序名称。 用逗号分隔多个包提供程序名称。 使用 Get-PackageProvider 获取可用包提供程序的列表。

参数属性

类型:

String[]

默认值:None
接受的值:Bootstrap, NuGet, PowerShellGet
支持通配符:False
不显示:False
别名:提供者

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Proxy

为请求指定代理服务器，而不是直接连接到 Internet 资源。

参数属性

类型:Uri
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ProxyCredential

指定有权使用 Proxy 参数指定的代理服务器的用户帐户。

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PublishLocation

指定用于发布包的位置。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-RequiredVersion

指定要查找的确切包版本。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-RoleCapability

指定角色功能的数组。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ScriptPublishLocation

指定包的脚本发布位置。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ScriptSourceLocation

指定脚本源位置。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SkipValidate

跳过包凭据验证的开关。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

NuGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Source

指定一个或多个包源。 使用 Get-PackageSource 获取可用包源的列表。 文件系统目录可用作下载包的源。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Tag

指定要在包元数据中搜索的一个或多个字符串。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Type

指定是搜索包含模块、脚本的包，还是搜索包。

参数属性

类型:String
默认值:None
接受的值:Module, Script, All
支持通配符:False
不显示:False

参数集

PowerShellGet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

None

不能用管道将对象传送到此 cmdlet。

输出

SoftwareIdentify

此 cmdlet 返回 SoftwareIdentity 对象。

备注

重要

截至 2020 年 4 月，PowerShell 库不再支持传输层安全性（TLS）版本 1.0 和 1.1。 如果未使用 TLS 1.2 或更高版本，则尝试访问 PowerShell 库时会收到错误。 使用以下命令确保使用的是 TLS 1.2：

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

有关详细信息，请参阅 PowerShell 博客中的 公告。