Find-Package

リファレンス

モジュール:: PackageManagement

使用可能なパッケージソース内のソフトウェアパッケージを検索します。

構文

Find-Package
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

Find-Package
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-AllowPrereleaseVersions]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [-AcceptLicense]
    [<CommonParameters>]

説明

Find-Package は、パッケージソースで使用可能なソフトウェアパッケージを検索します。 Get-PackageProvider プロバイダー Get-PackageSource に関する詳細を表示します。

重要

PackageManagement モジュールに含まれるコマンドは、Visual Studio のパッケージマネージャーコンソールの NuGet モジュールによって提供されるコマンドとは異なります。各モジュールには、他方では使用できないコマンドがあります。同じ名前のコマンドは、特定の引数で異なります。詳細については、Visual Studio のパッケージマネージャーコンソールの PowerShell リファレンスドキュメントを参照してください。

例

例 1: パッケージプロバイダーから使用可能なすべてのパッケージを検索する

このコマンドは、登録済みギャラリーで使用可能なすべての PowerShell モジュールパッケージを検索します。プロバイダー名を取得するには、を使用 Get-PackageProvider します。

Find-Package -ProviderName NuGet

Name               Version   Source     Summary
----               -------   ------     -------
NUnit              3.11.0    MyNuGet    NUnit is a unit-testing framework for all .NET langua...
Newtonsoft.Json    12.0.1    MyNuGet    Json.NET is a popular high-performance JSON framework...
EntityFramework    6.2.0     MyNuGet    Entity Framework is Microsoft's recommended data acce...
MySql.Data         8.0.15    MyNuGet    MySql.Data.MySqlClient .Net Core Class Library
bootstrap          4.3.1     MyNuGet    Bootstrap framework in CSS. Includes fonts and JavaSc...
NuGet.Core         2.14.0    MyNuGet    NuGet.Core is the core framework assembly for NuGet...

Find-Packageは Provider パラメーターを使用してプロバイダー NuGet を指定します。

例 2: パッケージソースからパッケージを検索する

このコマンドは、指定されたパッケージソースからパッケージの最新バージョンを検索します。パッケージソースが指定されていない場合は、 Find-Package インストールされている各パッケージプロバイダーとそのパッケージソースを検索します。ソース名を取得するには、を使用 Get-PackageSource します。

Find-Package -Name NuGet.Core -Source MyNuGet

Name         Version   Source    Summary
----         -------   ------    -------
NuGet.Core   2.14.0    MyNuGet   NuGet.Core is the core framework assembly for NuGet...

Find-Package では、 Name パラメーターを使用してパッケージ名 NuGet.Core を指定します。 Source パラメーターは、MyNuGet でパッケージを検索するように指定します。

例 3: パッケージのすべてのバージョンを検索する

このコマンドは、指定されたプロバイダーから使用可能なすべてのパッケージバージョンを検索します。

Find-Package -Name NuGet.Core -Source MyNuGet -AllVersions

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.14.0           MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.14.0-rtm-832   MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.13.0           MyNuGet      NuGet.Core is the core framework assembly for NuGet...
...
NuGet.Core    1.1.229.159      MyNuGet      NuGet.Core is the core framework assembly for NuGet...
Nuget.Core    1.0.1120.104     MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Find-Package では、 Name パラメーターを使用してパッケージ NuGet.Core を指定します。 ProviderName パラメーターは、MyNuGet でパッケージを検索するように指定します。 AllVersions は、 使用可能なすべてのバージョンが返されることを指定します。

例 4: 特定の名前とバージョンを持つパッケージを検索する

このコマンドは、指定されたプロバイダーから特定のパッケージバージョンを検索します。

Find-Package -Name NuGet.Core -ProviderName NuGet -RequiredVersion 2.9.0

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.9.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Find-Package では、 Name パラメーターを使用してパッケージ名 NuGet.Core を指定します。 ProviderName パラメーターは、NuGet でパッケージを検索するように指定します。 RequiredVersion では、バージョン 2.9.0 のみが返されることを指定します。

例 5: バージョンの範囲内のパッケージを検索する

このコマンドは、指定されたパッケージのバージョンの範囲を検索します。

Find-Package -Name NuGet.Core -ProviderName NuGet -MinimumVersion 2.7.0 -MaximumVersion 2.9.0 -AllVersions

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.9.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.8.6            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.8.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.7.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Find-Package では、 Name パラメーターを使用してパッケージ名 NuGet.Core を指定します。 ProviderName パラメーターは、NuGet でパッケージを検索するように指定します。 MinimumVersion は、最小バージョン 2.7.0 を指定します。 MaximumVersion は、最高バージョン 2.9.0 を指定します。 AllVersions は、 最小値と最大値で指定された範囲が返されるように決定します。

例 6: ファイルシステムからパッケージを検索する

このコマンドは、ローカルコンピューターに格納されているファイル拡張子 .nupkg を持つパッケージを検索します。ファイルは、 NuGet などのギャラリーからダウンロードされたパッケージです。

PS> Find-Package -Source C:\LocalPkg

Name                 Version    Source           Summary
----                 -------    ------           -------
Microsoft.Web.Xdt    3.0.0      C:\LocalPkg\     Microsoft Xml Document Transformation (XDT)...
NuGet.Core           2.14.0     C:\LocalPkg\     NuGet.Core is the core framework assembly...

パラメーター

-AcceptLicense

パッケージで必要な場合は、ライセンス契約を自動的に受け入れます。

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

-AllowPrereleaseVersions

結果にプレリリースとしてマークされたパッケージが含まれます。

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

-AllVersions

使用可能なすべてのバージョンのパッケージを返すを Find-Package 示します。既定では、 Find-Package 使用可能な最新バージョンのみが返されます。

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

-Command

で検索されるコマンドの配列を Find-Package指定します。

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

-ConfigFile

構成ファイルを指定します。

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

-Contains

Find-Package は、オブジェクトのプロパティ値内の項目が指定された値と完全に一致する場合にオブジェクトを取得します。

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:	False
Accept wildcard characters:	False

-DscResource

このコマンドレットが検索するDesired State Configuration (DSC) リソースの配列を指定します。

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

-Filter

Name プロパティと Description プロパティ内で検索する用語を指定します。

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

-FilterOnTag

結果をフィルター処理するタグを指定します。指定したタグを含まない結果は除外されます。

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

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

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

-ForceBootstrap

PackageManagement がパッケージプロバイダーを自動的にインストールすることを強制することをFind-Package示します。

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

-Headers

パッケージのヘッダーを指定します。

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

-IncludeDependencies

このコマンドレットにパッケージの依存関係が結果に含まれていることを示します。

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

-Includes

カテゴリ内のすべてのパッケージを検索するかどうかを Find-Package 指定します。

許容される値は次のとおりです。

コマンドレット
DscResource
機能
RoleCapability
ワークフロー

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

-MaximumVersion

検索するパッケージの最大バージョンを指定します。

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

-MinimumVersion

検索する最小パッケージバージョンを指定します。より高いバージョンが使用可能な場合は、そのバージョンが返されます。

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

-Name

1 つ以上のパッケージ名、またはワイルドカード文字を持つパッケージ名を指定します。複数のパッケージ名をコンマで区切ります。

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

-PackageManagementProvider

パッケージ管理プロバイダーの名前を指定します。

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

-ProviderName

1 つ以上のパッケージプロバイダー名を指定します。複数のパッケージプロバイダー名をコンマで区切ります。を使用して Get-PackageProvider 、使用可能なパッケージプロバイダーの一覧を取得します。

Type:	String[]
Aliases:	Provider
Accepted values:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

インターネットリソースへの直接接続ではなく、要求のプロキシサーバーを指定します。

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

-ProxyCredential

Proxy パラメーターに指定したプロキシサーバーを使用するアクセス許可を持つユーザーアカウントを指定します。

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

-PublishLocation

パッケージを発行する場所を指定します。

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

-RequiredVersion

検索する正確なパッケージバージョンを指定します。

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

-RoleCapability

ロール機能の配列を指定します。

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

-ScriptPublishLocation

パッケージのスクリプト発行場所を指定します。

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

-ScriptSourceLocation

スクリプトソースの場所を指定します。

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

-SkipValidate

パッケージの資格情報の検証をスキップするスイッチ。

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

-Source

1 つ以上のパッケージソースを指定します。を使用して Get-PackageSource 、使用可能なパッケージソースの一覧を取得します。ファイルシステムディレクトリは、ダウンロードパッケージのソースとして使用できます。

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

-Tag

パッケージメタデータで検索する 1 つ以上の文字列を指定します。

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

-Type

モジュール、スクリプト、またはいずれかを使用してパッケージを検索するかどうかを指定します。

Type:	String
Accepted values:	Module, Script, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

None

オブジェクトをこのコマンドレットにパイプすることはできません。

出力

SoftwareIdentify[]

このコマンドレットは、 SoftwareIdentity オブジェクトを返します。

メモ

重要

2020 年 4 月時点で、PowerShell ギャラリーでは、トランスポート層セキュリティ (TLS) バージョン 1.0 および 1.1 がサポートされなくなります。 TLS 1.2 以降を使用していない場合、PowerShell ギャラリーにアクセスしようとするとエラーが発生します。次のコマンドを使用して、確実に TLS 1.2 を使用するようにします。

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

詳細については、PowerShell ブログのお知らせを参照してください。