Find-RoleCapability
尋找模組中的角色功能。
語法
All
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 在每個已註冊的存放庫中尋找角色功能。 若要搜尋特定存放庫，請使用 Repository 參數。
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
在結果中包含標示為發行前版本的資源。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AllVersions
指出此 Cmdlet 會取得模組的所有版本。 AllVersions 參數會顯示每個模組的可用版本。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Filter
根據 PackageManagement 提供者的搜尋語法尋找資源。 例如，指定要在 ModuleName 內搜尋的字組，並 Description 屬性。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaximumVersion
指定要包含在結果中的模組最大版本。 MaximumVersion 和 RequiredVersion 參數不能在同一個命令中使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MinimumVersion
指定要包含在結果中的模組最低版本。 MinimumVersion 和 RequiredVersion 參數不能在同一個命令中使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ModuleName
指定要在其中搜尋角色功能的模組名稱。 預設值為所有模組。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定角色功能的名稱。 預設值為所有角色功能。 使用逗號分隔資源名稱的陣列。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | 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
指定要搜尋角色功能的存放庫。 使用逗號分隔存放庫名稱的陣列。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RequiredVersion
指定要包含在結果中的模組確切版本號碼。 RequiredVersion 和 MinimumVersion 參數不能在同一個命令中使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Tag
指定將存放庫中模組分類的標記。 使用逗號分隔標記陣列。
參數屬性
| 類型: | 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。
輸入
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 部落格中的 公告 。