共用方式為

Find-RoleCapability

  • 參考
模組:
PowerShellGet

尋找模組中的角色功能。

Syntax

Find-RoleCapability
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Description

Cmdlet 會 Find-RoleCapability 搜尋已註冊的存放庫，以尋找 PowerShell 角色功能和模組。

針對 找到 Find-RoleCapability的每個角色功能，會傳回 PSGetRoleCapabilityInfo 物件。 PSGetRoleCapabilityInfo 物件可以向下傳送至 Install-Module 或 Save-Module Cmdlet。

PowerShell 角色功能可定義 Just Enough Administration (JEA) 端點的使用者可以使用哪些命令和應用程式。 角色功能是由擴展名為的 .psrc 檔案所定義。

範例

範例 1：尋找角色功能

Find-RoleCapability 在每個已註冊的存放庫中尋找角色功能。 若要搜尋特定存放庫，請使用 存放庫 參數。

Find-RoleCapability

Name             Version    ModuleName     Repository
----             -------    ----------     ----------
General-Lev1     1.0        JeaExamples    PSGallery
General-Lev2     1.0        JeaExamples    PSGallery
IIS-Lev1         1.0        JeaExamples    PSGallery
IIS-Lev2         1.0        JeaExamples    PSGallery

範例 2：依名稱尋找角色功能

Find-RoleCapability 依名稱尋找角色功能。 使用逗號分隔名稱陣列。

Find-RoleCapability -Name General-Lev1, IIS-Lev2

Name             Version    ModuleName     Repository
----             -------    ----------     ----------
General-Lev1     1.0        JeaExamples    PSGallery
IIS-Lev2         1.0        JeaExamples    PSGallery

範例 3：尋找並儲存角色功能的模組

Cmdlet Find-RoleCapability 會尋找角色功能，並將對象傳送至管線。 Save-Module 將角色功能的模組儲存至檔案系統。 Get-ChildItem 會顯示模組目錄的內容。

PS> Find-RoleCapability -Name General-Lev1 | Save-Module -Path C:\Test\Modules

PS> Get-ChildItem -Path C:\Test\Modules\JeaExamples\1.0\

    Directory: C:\Test\Modules\JeaExamples\1.0

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----          6/4/2019    16:37                RoleCapabilities
-a----          2/5/2019    18:46           1702 CreateRegisterPSSC.ps1
-a----          2/5/2019    18:46           7656 JeaExamples.psd1
-a----         10/1/2018    08:16            595 JeaExamples.psm1

Find-RoleCapability 會使用 Name 參數來指定 General-Lev1 角色功能。 物件會在管線下傳送。 Save-Module 會使用檔案系統位置的 Path 參數來儲存模組。 儲存模組之後， Get-ChildItem 指定 模組的路徑， 並顯示 JeaExamples 模組目錄的內容。

範例 4：尋找並安裝角色功能的模組

Find-RoleCapability 會尋找模組，並將對象傳送至管線。 Install-Module 安裝模組。 安裝之後，請使用 Get-InstalledModule 來查看結果。

Find-RoleCapability -Name General-Lev1 | Install-Module -Verbose

VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'JeaExamples'.
VERBOSE: InstallPackageLocal' - name='JeaExamples', version='1.0',
VERBOSE: Validating the 'JeaExamples' module contents
VERBOSE: Test-ModuleManifest successfully validated the module manifest file
VERBOSE: Module 'JeaExamples' was installed successfully to path

Get-InstalledModule

Find-RoleCapability 會使用 Name 參數來指定 General-Lev1 角色功能。 物件會在管線下傳送。 Install-Module 會使用 Verbose 參數在安裝期間顯示狀態消息。 安裝完成後，輸出 Get-InstalledModule 會確認已安裝 JeaExamples 模組。

參數

-AllowPrerelease

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

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

-AllVersions

指出此 Cmdlet 會取得模組的所有版本。 AllVersions 參數會顯示每個模組的可用版本。

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

-Filter

根據 PackageManagement 提供者的搜尋語法尋找資源。 例如，指定要在 ModuleName 和 Description 屬性內搜尋的字組。

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

-MaximumVersion

指定要包含在結果中的模組版本上限。 MaximumVersion 和 RequiredVersion 參數不能用在相同的命令中。

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

-MinimumVersion

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

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

-ModuleName

指定要在其中搜尋角色功能的模組名稱。 預設為所有模組。

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

-Name

指定角色功能的名稱。 預設值為所有角色功能。 使用逗號分隔資源名稱的陣列。

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

-Proxy

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

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

-ProxyCredential

指定具有許可權的用戶帳戶，以使用 Proxy 參數中指定的 Proxy 伺服器。

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

-Repository

指定要搜尋角色功能的存放庫。 使用逗號分隔存放庫名稱的陣列。

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

-RequiredVersion

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

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

-Tag

指定標記，以分類存放庫中的模組。 使用逗號分隔標籤列。

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

輸入

Uri

PSCredential

輸出

PSGetRoleCapabilityInfo

Cmdlet 會 Find-RoleCapability 傳回 PSGetRoleCapabilityInfo 物件。

備註

重要

從 2020 年 4 月起，PowerShell 資源庫已不再支援傳輸層安全性 (TLS) 1.0 和 1.1 版。 如果您不是使用 TLS 1.2 或更高版本，您在嘗試存取 PowerShell 資源庫時將會收到錯誤。 使用下列命令來確保您使用的是 TLS 1.2：

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

如需詳細資訊，請參閱 PowerShell 部落格中的公告 \(英文\)。