Delen via

Get-PSSessionCapability

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee haalt u de mogelijkheden van een specifieke gebruiker op voor een beperkte sessieconfiguratie.

Syntaxis

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

Description

De Get-PSSessionCapability cmdlet haalt de mogelijkheden van een specifieke gebruiker op voor een beperkte sessieconfiguratie. Gebruik deze cmdlet om aangepaste sessieconfiguraties voor gebruikers te controleren.

Vanaf Windows PowerShell 5.0 kunt u de eigenschap RoleDefinitions in een sessieconfiguratiebestand (.pssc) gebruiken. Met deze eigenschap kunt u gebruikers verschillende mogelijkheden verlenen op één beperkt eindpunt op basis van groepslidmaatschap. De Get-PSSessionCapability cmdlet vermindert de complexiteit bij het controleren van deze eindpunten door u de exacte mogelijkheden te laten bepalen die aan een gebruiker worden verleend.

De Get-PSSessionCapability cmdlet retourneert standaard een lijst met opdrachten die de opgegeven gebruiker kan uitvoeren in het opgegeven eindpunt. Dit komt overeen met de gebruiker die Get-Command uitvoert in het opgegeven eindpunt. Wanneer deze cmdlet wordt uitgevoerd met de parameter Full, retourneert deze cmdlet een InitialSessionState-object. Dit object bevat details over de PowerShell-runspace waarmee de opgegeven gebruiker zou communiceren voor het opgegeven eindpunt. Het bevat informatie zoals taalmodus, uitvoeringsbeleid en omgevingsvariabelen.

Voorbeelden

Voorbeeld 1: Opdrachten ophalen die beschikbaar zijn voor een gebruiker

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'

In dit voorbeeld worden de opdrachten geretourneerd die beschikbaar zijn voor de gebruiker CONTOSO\Gebruiker bij het maken van verbinding met het eindpunt1 beperkt eindpunt op de lokale computer.

Voorbeeld 2: Details ophalen over een runspace voor een gebruiker

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full

In dit voorbeeld worden details geretourneerd over de runspace waarmee de gebruiker CONTOSO\Gebruiker interactie zou hebben bij het maken van verbinding met het eindpunt1 beperkt eindpunt.

Parameters

-ConfigurationName

Hiermee geeft u de beperkte sessieconfiguratie (eindpunt) die u inspecteert.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Full

Geeft aan dat deze cmdlet de volledige initiële sessiestatus retourneert voor de opgegeven gebruiker op het opgegeven beperkte eindpunt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Username

Hiermee geeft u de gebruiker op waarvan u de mogelijkheden controleert.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

AliasInfo

FunctionInfo

InitialSessionState