Find-Module

模組:

PowerShellGet Module

在符合指定準則的存放庫中尋找模組。

語法

All

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>]

Description

Cmdlet 會在 Find-Module 符合指定準則的存放庫中尋找模組。 Find-Module 會針對找到的每個模組傳回 PSRepositoryItemInfo 物件。 物件可以向下傳送至 Cmdlet，例如 Install-Module。

第一次 Find-Module 嘗試使用存放庫時，系統可能會提示您安裝更新。 如果存放庫來源未向 Register-PSRepository Cmdlet 註冊，則會傳回錯誤。

Find-Module 如果未使用任何限制版本的參數，則會傳回模組的最新版本。 若要取得模組版本的存放庫清單，請使用 AllVersions參數。

如果指定 MinimumVersion 參數， Find-Module 則傳回等於或大於最小值的模組版本。 如果存放庫中有較新版本可用，則會傳回較新版本。

如果指定 MaximumVersion 參數， Find-Module 則會傳回未超過指定之版本的最新模組版本。

如果指定 RequiredVersion 參數， Find-Module 則只會傳回與指定版本完全相符的模組版本。 Find-Module 會搜尋所有可用的模組，因為來源之間可能會發生名稱衝突。

下列範例使用 PowerShell資源庫 作為唯一已註冊的存放庫。 Get-PSRepository 會顯示已註冊的存放庫。 如果您有多個已註冊的存放庫，請使用 -Repository 參數來指定存放庫的名稱。

範例

範例 1：依名稱尋找模組

此範例會在預設存放庫中尋找模組。

Find-Module -Name PowerShellGet

Version   Name              Repository           Description
-------   ----              ----------           -----------
2.1.0     PowerShellGet     PSGallery            PowerShell module with commands for discovering...

Cmdlet 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

Cmdlet 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...

Cmdlet Find-Module 會使用 Name 參數來指定 PowerShellGet 模組。 MinimumVersion 指定 1.6.5 版。 Find-Module 會傳回 PowerShellGet 2.1.0 版，因為它超過最低版本，而且是最新的版本。

範例 4：依特定版本尋找模組

此示例返回一個表示模組特定版本的物件。 如果未找到指定的版本，則返回錯誤。

Find-Module -Name PowerShellGet -RequiredVersion 1.6.5

Version   Name             Repository     Description
-------   ----             ----------     -----------
1.6.5     PowerShellGet    PSGallery      PowerShell module with commands for discovering...

Cmdlet Find-Module 會使用 Name 參數來指定 PowerShellGet 模組。 RequiredVersion 參數指定版本 1.6.5。

範例 5：在特定存放庫中尋找模組

此範例會使用 Repository 參數來尋找特定存放庫中的模組。

Find-Module -Name PowerShellGet -Repository PSGallery

Version   Name             Repository     Description
-------   ----             ----------     -----------
2.1.0     PowerShellGet    PSGallery      PowerShell module with commands for discovering...

Cmdlet 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...

Cmdlet Register-PSRepository 會註冊新的存放庫。 Name 參數會指派 MySource 名稱。 SourceLocation 參數會指定存放庫的位址。

Cmdlet Find-Module 使用 Name 參數搭配星號 （*） 通配符來指定 Contoso 模組。 Repository 參數會指定搜尋兩個存放庫 PSGallery 和 MySource。

範例 7：尋找包含 DSC 資源的模組

此命令會傳回包含 DSC 資源的模組。 Includes 參數有四個預先定義的功能，可用來搜尋存放庫。 使用 Tab 鍵完成來顯示 Includes 參數支援的四項功能。

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...

Cmdlet Find-Module 會使用 Repository 參數來搜尋 存放庫 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...

Cmdlet Find-Module 會使用 Filter 參數來搜尋 AppDomain 的存放庫。

參數

-AllowPrerelease

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

參數屬性

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

參數集

(All)

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

-AllVersions

指定在結果中包含模組的所有版本。 您無法搭配 MinimumVersion、MaximumVersion 或 RequiredVersion 參數使用 AllVersions 參數。

參數屬性

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

參數集

(All)

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

-Command

指定要在模組中尋找的命令陣列。 命令可以是函式或工作流程。

參數屬性

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

參數集

(All)

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

-Credential

指定有權為指定的套件提供者或來源安裝模組的用戶帳戶。

參數屬性

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

參數集

(All)

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

-DscResource

指定包含 DSC 資源的模組名稱或部分名稱。 根據 PowerShell 慣例，當您提供多個自變數時，會執行 OR 搜尋。

參數屬性

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

參數集

(All)

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

-Filter

根據 PackageManagement 提供者特定的搜尋語法指定篩選條件。 對於 NuGet 模組，此參數等效於使用 PowerShell 庫 網站上的搜索欄進行搜索。

參數屬性

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

參數集

(All)

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

-IncludeDependencies

表示這項作業包含所有相依於 Name 參數中所指定模組的模組。

參數屬性

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

參數集

(All)

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

-Includes

只傳回那些包含特定 PowerShell 功能的模組。 例如，您可能只想尋找包含 DSCResource 的模組。 此參數可接受的值如下：

• cmdlet
• DscResource
• 功能
• RoleCapability

參數屬性

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

參數集

(All)

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

-MaximumVersion

指定要包含在搜尋結果中的模組最大值或最新版本。 MaximumVersion 和 RequiredVersion 不能用在相同的命令中。

參數屬性

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

參數集

(All)

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

-MinimumVersion

指定要包含在結果中的模組最低版本。 MinimumVersion 和 RequiredVersion 不能用在相同的命令中。

參數屬性

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

參數集

(All)

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

-Name

指定要在存放庫中搜尋的模組名稱。 接受以逗號分隔的模組名稱清單。 接受通配符。

參數屬性

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

參數集

(All)

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

-Proxy

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

參數屬性

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

參數集

(All)

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

-ProxyCredential

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

參數屬性

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

參數集

(All)

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

-Repository

使用 Repository 參數指定要搜尋模組的存放庫。 註冊多個存放庫時使用。 接受以逗號分隔的存放庫清單。 若要註冊存放庫，請使用 Register-PSRepository。 若要顯示已註冊的存放庫，請使用 Get-PSRepository。

參數屬性

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

參數集

(All)

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

-RequiredVersion

指定要包含在結果中的模組確切版本號碼。 RequiredVersion 不能用在與 MinimumVersion 或 MaximumVersion 相同的命令中。

參數屬性

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

參數集

(All)

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

-RoleCapability

指定角色功能的陣列。

參數屬性

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

參數集

(All)

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

-Tag

指定一組標記的陣列。 範例卷標包括 DesiredStateConfiguration、DSC、DSCResourceKit 或 PSModule。

參數屬性

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

參數集

(All)

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

CommonParameters

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

輸入

String

String

Uri

PSCredential

輸出

PSRepositoryItemInfo

Find-Module 會建立可將管線向下傳送至 Cmdlet 的 PSRepositoryItemInfo 物件，例如 Install-Module。

備註

這很重要

自 2020 年 4 月起，PowerShell 資源庫不再支援傳輸層安全性 （TLS） 1.0 和 1.1 版。 如果您未使用 TLS 1.2 或更高版本，當您嘗試存取 PowerShell 資源庫時，會收到錯誤。 使用下列命令以確保您使用 TLS 1.2：

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

如需詳細資訊，請參閱 PowerShell 部落格中的 公告 。

相關連結

• Get-PSRepository
• Install-Module
• Publish-Module
• Save-Module
• Uninstall-Module
• Update-Module
• Register-PSRepository