Get-PSSessionCapability

参考

模块:: Microsoft.PowerShell.Core

在特定会话配置中获取特定用户的权限。

语法

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

说明

Get-PSSessionCapability cmdlet 获取特定用户在受限会话配置中的权限。使用此 cmdlet 审核用户的自定义会话配置。

从 Windows PowerShell 5.0 开始，可以在会话配置（）文件中使用 .pssc 属性。使用此属性，可以根据组成员身份在单个约束终结点上向用户授予不同的功能。 Get-PSSessionCapability cmdlet 通过让您确定分配给用户的确切权限，简化了审核这些终结点的流程。

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

示例

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

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

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

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

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

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

参数

-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

通过