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 コマンドレットは、指定した条件に一致するリポジトリ内のモジュールを検索します。
Find-Module は、検出された各モジュールの PSRepositoryItemInfo オブジェクトを返します。 オブジェクトは、パイプラインを Install-Moduleなどのコマンドレットに送信できます。
これは、Microsoft.PowerShell.PSResourceGet のFind-PSResource コマンドレットのプロキシ コマンドレットです。 詳細については、「 Find-PSResource」を参照してください。
例
例 1: 名前でモジュールを検索する
この例では、既定のリポジトリでモジュールを検索します。
Find-Module -Name PowerShellGet
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
Find-Module コマンドレットは、Name パラメーターを使用して PowerShellGet モジュールを指定します。
例 2: 似た名前のモジュールを検索する
この例では、アスタリスク (*) ワイルドカードを使用して、類似した名前のモジュールを検索します。
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 コマンドレットは、Name パラメーターとアスタリスク (*) ワイルドカードを使用して、PowerShell を含むすべてのモジュールを検索します。
例 3: 最小バージョンでモジュールを検索する
この例では、モジュールの最小バージョンを検索します。 リポジトリにモジュールの新しいバージョンが含まれている場合は、新しいバージョンが返されます。
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 コマンドレットは、Name パラメーターを使用して PowerShellGet モジュールを指定します。
MinimumVersion はバージョン 1.6.5 を指定します。
Find-Module は、最小バージョンを超え、最新バージョンであるため、PowerShellGet バージョン 2.1.0 を返します。
例 4: 特定のバージョンでモジュールを検索する
この例では、モジュールの特定のプレリリース バージョンをインストールする方法を示します。 プレリリース バージョンには、 <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…例 5: 特定のリポジトリでモジュールを検索する
この例では、 Repository パラメーターを使用して、特定のリポジトリ内のモジュールを検索します。
Find-Module -Name PowerShellGet -Repository PSGallery
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
Find-Module コマンドレットは、Name パラメーターを使用して PowerShellGet モジュールを指定します。
Repository パラメーターは、PSGallery リポジトリを検索するように指定します。
例 6: 複数のリポジトリでモジュールを検索する
この例では、 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 コマンドレットは、新しいリポジトリを登録します。
Name パラメーターは MySource という名前を割り当てます。
SourceLocation パラメーターは、リポジトリのアドレスを指定します。
Find-Module コマンドレットは、Name パラメーターとアスタリスク (*) ワイルドカードを使用して Contoso モジュールを指定します。
Repository パラメーターは、PSGallery と MySource の 2 つのリポジトリを検索するように指定します。
例 7: DSC リソースを含むモジュールを検索する
このコマンドは、DSC リソースを含むモジュールを返します。 Includes パラメーターには、リポジトリの検索に使用される 4 つの定義済みの機能があります。 タブコンプリートを使用して、 Includes パラメーターでサポートされている 4 つの機能を表示します。
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 コマンドレットは、Repository パラメーターを使用してリポジトリ PSGallery を検索します。
Includes パラメーターは DscResource を指定します。これは、パラメーターがリポジトリ内で検索できる機能です。
例 8: フィルターを使用してモジュールを検索する
この例では、モジュールを検索するために、フィルターを使用してリポジトリを検索します。
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 コマンドレットでは、Filter パラメーターを使用して、AppDomain のリポジトリを検索します。
例 9: タグでモジュールを検索する
この例では、タグによってモジュールを検索する方法を示します。
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パラメーター
-AllowPrerelease
プレリリースとしてマークされた結果モジュールに含まれます。
プロキシ コマンドレットは、このパラメーターを Find-PSResource のプレリリース パラメーターにマップします。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AllVersions
結果にモジュールのすべてのバージョンを含むように指定します。 MinimumVersion、MaximumVersion、または RequiredVersion パラメーターで AllVersions パラメーターを使用することはできません。
プロキシ コマンドレットは、Find-PSResourceを呼び出す前に、このパラメーターを-Version *に変換します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Command
プロキシ コマンドレットは、Find-PSResourceの NameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
指定したパッケージ プロバイダーまたはソースのモジュールをインストールする権限を持つユーザー アカウントを指定します。
| 型: | PSCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-DscResource
プロキシ コマンドレットは、Find-PSResourceの NameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Filter
プロキシ コマンドレットは、Find-PSResourceの NameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IncludeDependencies
この操作に 、Name パラメーターで指定されたモジュールに依存するすべてのモジュールが含まれていることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Includes
プロキシ コマンドレットは、Find-PSResourceの NameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String[] |
| 指定可能な値: | DscResource, Cmdlet, Function, RoleCapability |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MaximumVersion
プロキシ コマンドレットは、このパラメーターの値を使用して、Find-PSResourceの Version パラメーターで使用する NuGet バージョン検索文字列を作成します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-MinimumVersion
プロキシ コマンドレットは、このパラメーターの値を使用して、Find-PSResourceの Version パラメーターで使用する NuGet バージョン検索文字列を作成します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
リポジトリ内で検索するモジュールの名前を指定します。 モジュール名のコンマ区切りのリストを使用できます。 ワイルドカードを使用できます。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | True |
-Proxy
プロキシ コマンドレットは、Find-PSResourceの NameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | Uri |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ProxyCredential
プロキシ コマンドレットは、Find-PSResourceの NameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | PSCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Repository
Repository パラメーターを使用して、モジュールを検索するリポジトリを指定します。 複数のリポジトリが登録されている場合に使用されます。 リポジトリのコンマ区切りのリストを受け入れます。 リポジトリを登録するには、 Register-PSRepositoryを使用します。 登録済みリポジトリを表示するには、 Get-PSRepositoryを使用します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RequiredVersion
プロキシ コマンドレットは、このパラメーターの値を使用して、Find-PSResourceの Version パラメーターで使用する NuGet バージョン検索文字列を作成します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-RoleCapability
プロキシ コマンドレットは、Find-PSResourceの NameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Tag
タグの配列を指定します。 タグの例としては、 DesiredStateConfiguration、 DSC、 DSCResourceKit、 PSModule などがあります。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
String[]
出力
PSRepositoryItemInfo
Find-Moduleは、パイプラインをInstall-Moduleなどのコマンドレットに送信できる PSRepositoryItemInfo オブジェクトを作成します。
メモ
PowerShell には、Find-Moduleの次のエイリアスが含まれています。
- すべてのプラットフォーム:
fimo
PowerShell ギャラリーでは、トランスポート層セキュリティ (TLS) バージョン 1.0 と 1.1 はサポートされなくなりました。 TLS 1.2 以降を使用する必要があります。 TLS 1.2 を使用していることを確認するには、次のコマンドを使用します。
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
