Get-PSSessionCapability

模块:

Microsoft.PowerShell.Core

获取受约束会话配置上特定用户的功能。

语法

PowerShell

Get-PSSessionCapability
   [-ConfigurationName] <String>
   [-Username] <String>
   [-Full]
   [<CommonParameters>]

说明

Get-PSSessionCapability cmdlet 获取受约束会话配置上特定用户的功能。 使用此 cmdlet 审核用户的自定义会话配置。

从 Windows PowerShell 5.0 开始，可以在会话配置（.pssc）文件中使用 RoleDefinitions 属性。 使用此属性，可以根据组成员身份在单个约束终结点上向用户授予不同的功能。 Get-PSSessionCapability cmdlet 通过确定向用户授予的确切功能，可以减少审核这些终结点时的复杂性。

默认情况下，Get-PSSessionCapability cmdlet 返回指定用户可以在指定终结点中运行的命令列表。 这相当于在指定终结点中运行 Get-Command 的用户。 当使用 Full 参数运行时，此 cmdlet 返回 InitialSessionState 对象。 此对象包含有关指定用户为指定终结点与之交互的 PowerShell 运行空间的详细信息。 它包括语言模式、执行策略和环境变量等信息。

示例

示例 1：获取用户可用的命令

PowerShell

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'

本示例返回连接到本地计算机上的 Endpoint1 约束终结点时用户 CONTOSO\User 可用的命令。

示例 2：获取有关用户的运行空间的详细信息

PowerShell

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full

此示例返回有关用户 CONTOSO\User 连接到 Endpoint1 约束终结点时与之交互的运行空间的详细信息。

参数

-ConfigurationName

指定要检查的受约束会话配置（终结点）。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Full

指示此 cmdlet 返回指定终结点上指定用户的完整初始会话状态。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Username

指定要检查其功能的用户。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

输出

AliasInfo

FunctionInfo

InitialSessionState

相关链接

• New-PSRoleCapabilityFile