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 に関する詳細を表示します。

例

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

-AllowPrereleaseVersions

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

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

-AllVersions

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

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

-Command

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

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

-ConfigFile

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

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

-Contains

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

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

-Credential

パッケージを検索するアクセス許可を持つユーザーアカウントを指定します。

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

-DscResource

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

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

-Filter

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

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

-FilterOnTag

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

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

-Force

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

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

-ForceBootstrap

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

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

-Headers

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

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

-IncludeDependencies

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

Type:	SwitchParameter
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

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

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

-MinimumVersion

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

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

-Name

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

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

-PackageManagementProvider

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

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

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

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

-ProxyCredential

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

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

-PublishLocation

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

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

-RequiredVersion

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

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

-RoleCapability

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

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

-ScriptPublishLocation

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

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

-ScriptSourceLocation

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

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

-SkipValidate

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

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

-Source

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

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

-Tag

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

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

-Type

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

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

入力

None

Find-Package では、パイプラインからの入力は受け入れられません。

出力

SoftwareIdentify[]

Find-Packageは SoftwareIdentity オブジェクトを出力します。

メモ

重要

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

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

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

Find-Package

構文

説明

例

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

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