Get-PSSessionCapability
获取受约束会话配置上特定用户的功能。
语法
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>]
说明
cmdlet Get-PSSessionCapability
获取受约束会话配置上特定用户的功能。 使用此 cmdlet 审核用户的自定义会话配置。
从 Windows PowerShell 5.0 开始,可以在会话配置中使用 RoleDefinitions 属性 (.pssc
) 文件。 使用此属性可以根据组成员身份在单个受约束终结点上向用户授予不同的功能。 cmdlet Get-PSSessionCapability
通过让你确定授予用户的确切功能,降低了审核这些终结点时的复杂性。
默认情况下, 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 |