Find-Package

模組:: PackageManagement Module

尋找可用套件來源中的軟體套件。

語法

NuGet

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

PowerShellGet

Find-Package
    [[-Name] <String[]>]
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-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>]

Description

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

如果套件需要許可協定，則自動接受許可協定。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AllowPrereleaseVersions

在結果中包含標示為發行前版本的套件。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AllVersions

表示傳 Find-Package 回套件的所有可用版本。根據預設， Find-Package 只會傳回最新的可用版本。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Command

指定所 Find-Package搜尋的命令陣列。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConfigFile

指定組態檔。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NuGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Contains

Find-Package 如果物件屬性值中的任何專案與指定值完全相符，就會取得物件。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NuGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Credential

指定具有搜尋套件許可權的用戶帳戶。

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DscResource

指定此 Cmdlet 所搜尋的 Desired State Configuration （DSC）資源陣列。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Filter

指定要在名稱和 Description 屬性內搜尋的字詞。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-FilterOnTag

指定篩選結果的標記。排除不包含指定標籤的結果。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NuGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Force

強制命令執行，而不要求使用者確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ForceBootstrap

表示 Find-Package 強制 PackageManagement 自動安裝套件提供者。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Headers

指定封裝的標頭。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NuGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IncludeDependencies

指出此 Cmdlet 會在結果中包含套件相依性。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Includes

指定是否 Find-Package 應該在類別內尋找所有套件。

接受的值如下所示：

cmdlet
DscResource
功能
RoleCapability
Workflow

參數屬性

類型:	String[]
預設值:	None
接受的值:	Cmdlet, DscResource, Function, RoleCapability, Workflow
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MaximumVersion

指定您要尋找的套件版本上限。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MinimumVersion

指定您要尋找的最低套件版本。如果有較高的版本可用，則會傳回該版本。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Name

指定一或多個套件名稱，或具有通配符的封裝名稱。以逗號分隔多個套件名稱。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	True
不要顯示:	False

參數集

(All)

Position:	0
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PackageManagementProvider

指定封裝管理提供者的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ProviderName

指定一或多個套件提供者名稱。以逗號分隔多個套件提供者名稱。使用 Get-PackageProvider 取得可用套件提供者的清單。

參數屬性

類型:	String[]
預設值:	None
接受的值:	Bootstrap, NuGet, PowerShellGet
支援萬用字元:	False
不要顯示:	False
別名:	供應商

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Proxy

指定要求的 Proxy 伺服器，而不是直接連線到因特網資源。

參數屬性

類型:	Uri
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ProxyCredential

指定有權使用 Proxy 參數所指定 Proxy 伺服器的用戶帳戶。

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PublishLocation

指定發佈封裝的位置。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RequiredVersion

指定您要尋找的確切套件版本。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RoleCapability

指定角色功能的陣列。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ScriptPublishLocation

指定封裝的腳本發佈位置。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ScriptSourceLocation

指定文稿來源位置。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SkipValidate

略過套件認證驗證的切換。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NuGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Source

指定一或多個套件來源。使用 Get-PackageSource 來取得可用套件來源的清單。檔案系統目錄可作為下載套件的來源。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Tag

指定要在套件元數據中搜尋的一或多個字串。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Type

指定是否要搜尋具有模組、腳本或其中一項的套件。

參數屬性

類型:	String
預設值:	None
接受的值:	Module, Script, All
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸入

None

您不能將物件透過管道傳送到此 Cmdlet。

輸出

SoftwareIdentify

此 Cmdlet 會傳回 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

語法

NuGet

PowerShellGet

Description

範例

範例 1：從套件提供者尋找所有可用的套件

範例 2：從套件來源尋找套件

範例 3：尋找套件的所有版本

範例 4：尋找具有特定名稱和版本的套件

範例 5：尋找版本範圍內的套件

範例 6：從文件系統尋找套件

參數

-AcceptLicense

參數屬性

參數集

-AllowPrereleaseVersions

參數屬性

參數集

-AllVersions

參數屬性

參數集

-Command

參數屬性

參數集

-ConfigFile

參數屬性

參數集

-Contains

參數屬性

參數集

-Credential

參數屬性

參數集

-DscResource

參數屬性

參數集

-Filter

參數屬性

參數集

-FilterOnTag

參數屬性

參數集

-Force

參數屬性

參數集

-ForceBootstrap

參數屬性

參數集

-Headers

參數屬性

參數集

-IncludeDependencies

參數屬性

參數集

-Includes

參數屬性

參數集

-MaximumVersion

參數屬性

參數集

-MinimumVersion

參數屬性

參數集

-Name

參數屬性

參數集

-PackageManagementProvider

參數屬性

參數集

-ProviderName

參數屬性

參數集

-Proxy

參數屬性

參數集

-ProxyCredential

參數屬性

參數集