Get-PSSessionCapability

参考

模块:: Microsoft.PowerShell.Core

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

语法

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：获取可供用户使用的命令

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

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

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

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

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

参数

-ConfigurationName

指定要检查 (终结点) 的约束会话配置。

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

-Full

指示此 cmdlet 返回指定用户在指定约束终结点处的整个初始会话状态。

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

-Username

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

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

输出

AliasInfo

FunctionInfo

InitialSessionState

New-PSRoleCapabilityFile

通过