次の方法で共有


Find-Package

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

構文

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 ブログのお知らせを参照してください。