获取 PSSessionCapability (Microsoft.PowerShell.Core)

获取 PSSessionCapability

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

句法

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

指定您正在检查的受限会话配置（端点）。

String

0

None

True

False

False

-Full

指示此 cmdlet 返回指定受限端点处指定用户的整个初始会话状态。

SwitchParameter

命名

None

False

False

False

-Username

指定您正在检查其能力的用户。

String

1

None

True

False

False

输出

别名信息

功能信息

初始会话状态