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 对象。此对象包含有关指定用户为指定终结点与之交互Windows PowerShell运行空间的详细信息。它包括语言模式、执行策略和环境变量等信息。

示例

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

PS C:\> Get-PSSessionCapability -ConfigurationName "Endpoint1" -Username "CONTOSO\EvanNa"

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

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

PS C:\> Get-PSSessionCapability -ConfigurationName "Endpoint1" -Username "CONTOSO\PattiFul" -Full

此命令返回有关用户 CONTOSO\PattiFul 在连接到 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

通过