共用方式為

Find-Command

  • 參考
模組:
PowerShellGet

尋找模組中的 PowerShell 命令。

Syntax

Find-Command
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Description

Cmdlet Find-Command 會尋找 PowerShell 命令，例如 Cmdlet、別名、函式和工作流程。 Find-Command 會在已註冊的存放庫中搜尋模組。

這是Microsoft.PowerShell.PSResourceGet中 Cmdlet 的 Proxy Cmdlet Find-PSResource 。 如需詳細資訊，請參閱 Find-PSResource。

範例

範例 1：依名稱尋找命令

Find-Command 可以使用命令的名稱，在存放庫中尋找模組。 命令名稱可能存在於多個 ModuleNames 中。

Find-Command -Repository PSGallery -Name Get-TargetResource

Name                  Version    ModuleName                      Repository
----                  -------    ----------                      ----------
Get-TargetResource    3.1.0.0    xPowerShellExecutionPolicy      PSGallery
Get-TargetResource    1.0.0      xInternetExplorerHomePage       PSGallery
Get-TargetResource    1.2.0.0    SystemLocaleDsc                 PSGallery

Find-Command 會使用 Repository 參數來搜尋 PSGallery。 Name參數會指定命令 Get-TargetResource 。

範例 2：依名稱尋找命令並安裝模組

Find-Command 可以找出 命令和模組，然後將 物件傳送至 Install-Module 。 如果命令包含在多個模組中，請使用 Find-Command Cmdlets ModuleName 參數。 否則，系統可能會安裝您不想安裝的模組。

Find-Command -Name Get-TargetResource -Repository PSGallery -ModuleName SystemLocaleDsc |
    Install-Module
Get-InstalledModule

Version   Name               Repository   Description
-------   ----               ----------   -----------
1.2.0.0   SystemLocaleDsc    PSGallery    This DSC Resource allows configuration of the Windows...

Find-Command 會使用 Name 參數來指定命令 Get-TargetResource 。 存放 庫 參數會搜尋 PSGallery。 ModuleName參數會指定您想要安裝的模組SystemLocaleDsc。 物件會向下傳送至 管線， Install-Module 並安裝模組。 安裝完成之後，您可以使用 Get-InstalledModule 來顯示結果。

範例 3：尋找命令並儲存其模組

Find-Command -Name Invoke-ScriptAnalyzer -Repository PSGallery |
    Save-Module -Path C:\Test\Modules -Verbose

VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/PSScriptAnalyzer/1.18.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/PSScriptAnalyzer/1.18.0'.
VERBOSE: Completed downloading 'PSScriptAnalyzer'.
VERBOSE: Module 'PSScriptAnalyzer' was saved successfully to path 'C:\Test\Modules\PSScriptAnalyzer\1.18.0'.

Find-Command會使用Name和Repository參數來搜尋PSGallery存放庫中的命令 Invoke-ScriptAnalyzer 。 物件會向下傳送至 Save-Module 管線。 Path參數會決定儲存模組的位置。 詳細資訊 是選擇性參數，但在 PowerShell 主控台中顯示狀態輸出。 詳細資訊輸出對於疑難排解很有説明。

參數

-AllowPrerelease

在結果中包含標示為發行前版本的模組。

Proxy Cmdlet 會將此參數對應至 的 Find-PSResource發行前版本參數。

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

-AllVersions

Proxy Cmdlet 會忽略此參數，因為 的 CommandNameParameterSetFind-PSResource 不支援此參數。

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

-Filter

Proxy Cmdlet 會忽略此參數，因為 的 CommandNameParameterSetFind-PSResource 不支援此參數。

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

-MaximumVersion

Proxy Cmdlet 會忽略此參數，因為 的 CommandNameParameterSetFind-PSResource 不支援此參數。

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

-MinimumVersion

Proxy Cmdlet 會忽略此參數，因為 的 CommandNameParameterSetFind-PSResource 不支援此參數。

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

-ModuleName

Proxy Cmdlet 會忽略此參數，因為 的 CommandNameParameterSetFind-PSResource 不支援此參數。

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

-Name

指定要在存放庫中搜尋的命令名稱。 使用逗號分隔命令名稱的陣列。

Proxy Cmdlet 會將此參數對應至 的 Find-PSResourceCommandName參數。

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

-Proxy

Proxy Cmdlet 會忽略此參數，因為 的 CommandNameParameterSetFind-PSResource 不支援此參數。

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

-ProxyCredential

Proxy Cmdlet 會忽略此參數，因為 的 CommandNameParameterSetFind-PSResource 不支援此參數。

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

-Repository

指定要搜尋命令的存放庫。 使用逗號分隔存放庫名稱的陣列。 預設為所有存放庫。

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

-RequiredVersion

Proxy Cmdlet 會忽略此參數，因為 的 CommandNameParameterSetFind-PSResource 不支援此參數。

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

-Tag

Proxy Cmdlet 會忽略此參數，因為 的 CommandNameParameterSetFind-PSResource 不支援此參數。

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

輸出

PSGetCommandInfo

Find-Command 會輸出 PSGetCommandInfo 物件。

備註

PowerShell 資源庫不再支援傳輸層安全性 (TLS) 1.0 和 1.1 版。 您必須使用 TLS 1.2 或更高版本。 使用下列命令來確保您使用的是 TLS 1.2：

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