通过

Find-RoleCapability

  • 参考
模块:
PowerShellGet

在模块中查找角色功能。

语法

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

说明

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

在结果中包含标记为预发行的资源。

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

指定请求的代理服务器，而不是与 Internet 资源的直接连接。

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

-ProxyCredential

指定具有使用 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 博客中的公告。