Find-Command

構文

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

説明

コマンドレットは Find-Command 、コマンドレット、エイリアス、関数、ワークフローなどの PowerShell コマンドを検索します。 Find-Command は、登録済みリポジトリ内のモジュールを検索します。

これは、Microsoft.PowerShell.PSResourceGet のコマンドレットのFind-PSResourceプロキシ コマンドレットです。 詳細については、「 Find-PSResource」を参照してください。

例

例 1: 名前でコマンドを検索する

Find-Command では、コマンドの名前を使用して、リポジトリ内のモジュールを検索できます。 コマンド名が複数の ModuleName に存在する可能性があります。

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送信できます。 コマンドが複数のモジュールに含まれている場合は、コマンドレット ModuleName パラメーターをFind-Command使用します。 それ以外の場合は、インストールしたくないモジュールがインストールされている可能性があります。

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。 Repository パラメーターは 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 パラメーターは、モジュールを保存する場所を決定します。 Verbose は省略可能なパラメーターですが、PowerShell コンソールに状態出力が表示されます。 詳細出力は、トラブルシューティングに役立ちます。

パラメーター

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

出力

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

関連リンク

• Get-InstalledModule
• Install-Module
• Save-Module
• Select-Object
• Uninstall-Module