次の方法で共有

Find-Command

  • リファレンス
モジュール:
PowerShellGet

モジュール内の PowerShell コマンドを検索します。

構文

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に送信できます。 コマンドが複数のモジュールに含まれている場合は、 Find-Command コマンドレット 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を指定します。 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は、名前パラメーターとリポジトリ パラメーターを使用して、PSGallery リポジトリ内のコマンド Invoke-ScriptAnalyzerを検索します。 オブジェクトはパイプラインを Save-Moduleに送信されます。 Path パラメーターは、モジュールを保存する場所を決定します。 Verbose は省略可能なパラメーターですが、PowerShell コンソールに状態出力が表示されます。 詳細出力は、トラブルシューティングに役立ちます。

パラメーター

-AllowPrerelease

結果にプレリリースとしてマークされたモジュールが含まれます。

プロキシ コマンドレットは、このパラメーターを Find-PSResource のプレリリース パラメーターにマップします。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AllVersions

プロキシ コマンドレットは、Find-PSResourceの CommandNameParameterSet でサポートされていないため、このパラメーターを無視します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Filter

プロキシ コマンドレットは、Find-PSResourceの CommandNameParameterSet でサポートされていないため、このパラメーターを無視します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MaximumVersion

プロキシ コマンドレットは、Find-PSResourceの CommandNameParameterSet でサポートされていないため、このパラメーターを無視します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MinimumVersion

プロキシ コマンドレットは、Find-PSResourceの CommandNameParameterSet でサポートされていないため、このパラメーターを無視します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ModuleName

プロキシ コマンドレットは、Find-PSResourceの CommandNameParameterSet でサポートされていないため、このパラメーターを無視します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

リポジトリ内で検索するコマンド名を指定します。 コマンド名の配列を区切るには、コンマを使用します。

プロキシ コマンドレットは、このパラメーターを Find-PSResource の CommandName パラメーターにマップします。

型:String[]
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Proxy

プロキシ コマンドレットは、Find-PSResourceの CommandNameParameterSet でサポートされていないため、このパラメーターを無視します。

型:Uri
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ProxyCredential

プロキシ コマンドレットは、Find-PSResourceの CommandNameParameterSet でサポートされていないため、このパラメーターを無視します。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Repository

コマンドを検索するリポジトリを指定します。 リポジトリ名の配列を区切るには、コンマを使用します。 既定値は、すべてのリポジトリです。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RequiredVersion

プロキシ コマンドレットは、Find-PSResourceの CommandNameParameterSet でサポートされていないため、このパラメーターを無視します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Tag

プロキシ コマンドレットは、Find-PSResourceの CommandNameParameterSet でサポートされていないため、このパラメーターを無視します。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る: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