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 gebruiker CONTOSO\User bij verbinding met het beperkte eindpunt Endpoint1 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\User interactie zou hebben wanneer verbinding wordt gemaakt met het beperkte eindpunt Endpoint1.

Parameters

-ConfigurationName

Geeft de beperkte sessieconfiguratie (eindpunt) op 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