Find-Module

Find-Module
    [[-Name] <string[]>]
    [-MinimumVersion <string>]
    [-MaximumVersion <string>]
    [-RequiredVersion <string>]
    [-AllVersions]
    [-IncludeDependencies]
    [-Filter <string>]
    [-Tag <string[]>]
    [-Includes <string[]>]
    [-DscResource <string[]>]
    [-RoleCapability <string[]>]
    [-Command <string[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-Repository <string[]>]
    [-Credential <pscredential>]
    [-AllowPrerelease]
    [<CommonParameters>]

该 Find-Module cmdlet 查找与指定条件匹配的存储库中的模块。 Find-Module 为找到的每个模块返回 PSRepositoryItemInfo 对象。 可以将对象向下发送到 cmdlet，例如 Install-Module。

首次 Find-Module 尝试使用存储库时，系统可能会提示你安装更新。 如果未向 Register-PSRepository cmdlet 注册存储库源，则返回错误。

Find-Module 如果未使用任何参数来限制版本，则返回模块的最新版本。 若要获取模块版本的存储库列表，请使用参数 AllVersions。

如果指定 MinimumVersion 参数， Find-Module 则返回等于或大于最小值的模块版本。 如果存储库中提供了较新版本，则会返回较新版本。

如果指定 了 MaximumVersion 参数， Find-Module 则返回未超过指定版本的模块的最新版本。

如果指定 RequiredVersion 参数， Find-Module 则仅返回与指定版本完全匹配的模块版本。 Find-Module 搜索所有可用模块，因为源之间可能发生名称冲突。

采用模块版本号的参数需要格式化为版本号的字符串。

• 标准版本号的格式为 x.y.z x、y 和 z 是数字
• 预发行版版本的格式是x.y.z-<prerelease_label><prerelease_label>分配给该版本的任意字符串。

以下示例使用 PowerShell 库 作为唯一注册的存储库。 Get-PSRepository 显示已注册的存储库。 如果有多个已注册的存储库，请使用 -Repository 参数指定存储库的名称。

此示例在默认存储库中找到一个模块。

Find-Module -Name PowerShellGet

Version   Name              Repository           Description
-------   ----              ----------           -----------
2.1.0     PowerShellGet     PSGallery            PowerShell module with commands for discovering...

该 Find-Module cmdlet 使用 Name 参数指定 PowerShellGet 模块。

此示例使用星号 （*） 通配符查找具有类似名称的模块。

Find-Module -Name PowerShell*

Version   Name                            Repository    Description
-------   ----                            ----------    -----------
0.4.0     powershell-yaml                 PSGallery     Powershell module for serializing and...
2.1.0     PowerShellGet                   PSGallery     PowerShell module with commands for...
1.9       Powershell.Helper.Extension     PSGallery     # Powershell.Helper.Extension...
3.1       PowerShellHumanizer             PSGallery     PowerShell Humanizer wraps Humanizer...
4.0       PowerShellISEModule             PSGallery     a module that adds capability to the ISE

该 Find-Module cmdlet 使用 Name 参数和星号 （*） 通配符查找包含 PowerShell 的所有模块。

此示例搜索模块的最低版本。 如果存储库包含较新版本的模块，则返回较新版本。

Find-Module -Name PowerShellGet -MinimumVersion 1.6.5

Version   Name             Repository     Description
-------   ----             ----------     -----------
2.1.0     PowerShellGet    PSGallery      PowerShell module with commands for discovering...

该 Find-Module cmdlet 使用 Name 参数指定 PowerShellGet 模块。 MinimumVersion 指定版本 1.6.5。 Find-Module 返回 PowerShellGet 版本 2.1.0 ，因为它超出了最低版本，并且是最新版本。

此示例演示如何安装模块的特定预发行版。 预发行版本的格式为 <version_number>-<prerelease_label>.

Find-Module PSReadLine -AllowPrerelease -RequiredVersion 2.2.4-beta1

Version        Name             Repository       Description
-------        ----             ----------       -----------
2.2.4-beta1    PSReadLine       PSGallery        Great command line editing in the PowerS…

此示例使用 Repository 参数查找特定存储库中的模块。

Find-Module -Name PowerShellGet -Repository PSGallery

Version   Name             Repository     Description
-------   ----             ----------     -----------
2.1.0     PowerShellGet    PSGallery      PowerShell module with commands for discovering...

该 Find-Module cmdlet 使用 Name 参数指定 PowerShellGet 模块。 Repository 参数指定搜索 PSGallery 存储库。

此示例使用指定 Register-PSRepository 存储库。 Find-Module 使用存储库搜索模块。

Register-PSRepository -Name MySource -SourceLocation https://www.myget.org/F/powershellgetdemo/
Find-Module -Name Contoso* -Repository PSGallery, MySource

Repository    Version   Name             Description
----------    -------   ----             -----------
PSGallery     2.0.0.0   ContosoServer    Cmdlets and DSC resources for managing Contoso Server...
MySource      1.2.0.0   ContosoClient    Cmdlets and DSC resources for managing Contoso Client...

该 Register-PSRepository cmdlet 注册新的存储库。 Name 参数分配名称 MySource。 SourceLocation 参数指定存储库的地址。

cmdlet Find-Module 使用 带 星号 （*） 通配符的 Name 参数来指定 Contoso 模块。 Repository 参数指定搜索两个存储库：PSGallery 和 MySource。

此命令返回包含 DSC 资源的模块。 Includes 参数具有四个预定义的功能，用于搜索存储库。 使用 Tab-complete 显示 Includes 参数支持的四个功能。

Find-Module -Repository PSGallery -Includes DscResource

Version     Name                            Repository    Description
-------     ----                            ----------    -----------
2.7.0       Carbon                          PSGallery     Carbon is a PowerShell module...
8.5.0.0     xPSDesiredStateConfiguration    PSGallery     The xPSDesiredStateConfiguration module...
1.3.1       PackageManagement               PSGallery     PackageManagement (a.k.a. OneGet) is...
2.7.0.0     xWindowsUpdate                  PSGallery     Module with DSC Resources...
3.2.0.0     xCertificate                    PSGallery     This module includes DSC resources...
3.1.0.0     xPowerShellExecutionPolicy      PSGallery     This DSC resource can change the user...

该 Find-Module cmdlet 使用 Repository 参数搜索存储库 PSGallery。 Includes 参数指定 DscResource，这是参数可以在存储库中搜索的功能。

在此示例中，若要查找模块，将使用筛选器来搜索存储库。

对于基于 NuGet 的存储库， Filter 参数通过参数的名称、说明和标记进行搜索。

Find-Module -Filter AppDomain

Version    Name              Repository           Description
-------    ----              ----------           -----------
1.0.0.0  AppDomainConfig     PSGallery            Manipulate AppDomain configuration...
1.1.0    ClassExplorer       PSGallery            Quickly search the AppDomain for classes...

该 Find-Module cmdlet 使用 Filter 参数搜索 AppDomain 的存储库。

此示例演示如何按标记查找模块。 该值 CrescendoBuilt 是自动添加到使用 Microsoft.PowerShell.Crescendo 模块创建的模块的标记。

Find-Module -Tag CrescendoBuilt

Version Name            Repository Description
------- ----            ---------- -----------
0.1.0   Foil            PSGallery  A PowerShell Crescendo wrapper for Chocolatey
0.3.1   Cobalt          PSGallery  A PowerShell Crescendo wrapper for WinGet
1.1.0   SysInternals    PSGallery  PowerShell cmdlets for SysInternal tools
0.0.4   Croze           PSGallery  A PowerShell Crescendo wrapper for Homebrew
0.0.2   AptPackage      PSGallery  PowerShell Crescendo-generated Module to query APT-Package Information
1.0.1   RoboCopy        PSGallery  PowerShell cmdlet for the official RoboCopy.exe
1.0.2   TShark          PSGallery  PowerShell cmdlet for tshark.exe
1.0.0   SpeedTestCLI    PSGallery  PowerShell cmdlets speedtest-cli
1.0.0   SpeedTest-CLI   PSGallery  PowerShell cmdlets for Internet Speed Test
1.0.2   Image2Text      PSGallery  PowerShell Images into ASCII art
0.1.1   Quser.Crescendo PSGallery  This module displays session information of users logged onto a local or remote m...
1.0.2   Takeown         PSGallery  Crescendo Powershell wrapper of takeown.exe

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

Find-Module 创建可将管道发送到 cmdlet 的 PSRepositoryItemInfo 对象，例如 Install-Module。

PowerShell 包含以下与 Find-Module相关的别名：

• 所有平台：
  • fimo