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