PowerShell Logo Small

Get-PSSessionCapability



This is the built-in help made by Microsoft for the command 'Get-PSSessionCapability', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Gets the capabilities of a specific user on a constrained session configuration.

SYNTAX


Get-PSSessionCapability [-ConfigurationName] <String> [-Username] <String> [-Full] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-PSSessionCapability cmdlet gets the capabilities of a specific user on a constrained session configuration. This cmdlet is used by system administrators to audit
customized session configurations for their users.


Beginning in Windows PowerShell 5.0, you can use the RoleDefinitions property in a session configuration (.pssc) file. Using this property allows you to grant users
different capabilities on a single constrained endpoint based on group membership. The Get-PSSessionCapability cmdlet reduces complexity when auditing these endpoints by
allowing you to determine the exact capabilities granted to a user.


By default, the Get-PSSessionCapability cmdlet returns a list of commands the specified user can run in the specified endpoint. This is equivalent to the user running
Get-Command in the specified endpoint. When run with the Full parameter, an InitialSessionState object is returned. This object contains details about the PowerShell
runspace the specified user would interact with for the specified endpoint, including information such as Language Mode, Execution Policy, and Environmental Variables.



<

RELATED LINKS

New-PSRoleCapabilityFile

REMARKS

<

Examples


1: ====== EXAMPLE 1 ========

PS C:\>Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'



This example returns the commands available to the user "CONTOSO\User" when connecting to the "Endpoint1" constrained endpoint on the local computer.






2: ====== EXAMPLE 2 ========

PS C:\>Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full



This example returns details about the runspace the user "CONTOSO\User" would interact with when connecting to the "Endpoint1" constrained endpoint.