次の方法で共有


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 パラメーターは、PSGalleryMySource の 2 つのリポジトリを検索するように指定します。

例 7: DSC リソースを含むモジュールを検索する

このコマンドは、DSC リソースを含むモジュールを返します。 Includes パラメーターには、リポジトリの検索に使用される 4 つの定義済みの機能があります。 Tab-complete を使用して、 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-ModuleRepository パラメーターを使用してリポジトリ 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-ModuleFilter パラメーターを使用して、 AppDomain のリポジトリを検索します。

例 9: タグでモジュールを検索する

この例では、タグでモジュールを検索する方法を示します。 値は CrescendoBuiltMicrosoft.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

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

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

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

-AllVersions

モジュールのすべてのバージョンを結果に含むように指定します。 MinimumVersion、MaximumVersion、または RequiredVersion パラメーターで AllVersions パラメーターを使用することはできません。

プロキシ コマンドレットは、 を呼び出すFind-PSResource前に、このパラメーターを に-Version *変換します。

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

-Command

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

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

-Credential

指定したパッケージ プロバイダーまたはソースのモジュールをインストールする権限を持つユーザー アカウントを指定します。

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

-DscResource

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

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

-Filter

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

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

-IncludeDependencies

この操作に、 Name パラメーターで指定されたモジュールに依存するすべてのモジュールが含まれていることを示します。

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

-Includes

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

Type:String[]
Accepted values:DscResource, Cmdlet, Function, RoleCapability
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

プロキシ コマンドレットでは、このパラメーターの値を使用して、 の Version パラメーターで使用する NuGet バージョン検索文字列を作成します Find-PSResource

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

-MinimumVersion

プロキシ コマンドレットでは、このパラメーターの値を使用して、 の Version パラメーターで使用する NuGet バージョン検索文字列を作成します Find-PSResource

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

-Name

リポジトリで検索するモジュールの名前を指定します。 モジュール名のコンマ区切りのリストが受け入れられます。 ワイルドカードを使用できます。

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

-Proxy

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

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

-ProxyCredential

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

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

-Repository

Repository パラメーターを使用して、モジュールを検索するリポジトリを指定します。 複数のリポジトリが登録されている場合に使用されます。 リポジトリのコンマ区切りのリストを受け入れます。 リポジトリを登録するには、 を使用 Register-PSRepositoryします。 登録済みリポジトリを表示するには、 を使用 Get-PSRepositoryします。

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

-RequiredVersion

プロキシ コマンドレットでは、このパラメーターの値を使用して、 の Version パラメーターで使用する NuGet バージョン検索文字列を作成します Find-PSResource

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

-RoleCapability

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

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

-Tag

タグの配列を指定します。 タグの例としては、 DesiredStateConfigurationDSCDSCResourceKitPSModule などがあります

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

入力

String[]

String

Uri

PSCredential

出力

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