Delen via

Get-PSSessionCapability

  • Referentie
Module:
Microsoft.PowerShell.Core

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

Syntax

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 gebruiken in een sessieconfiguratiebestand (.pssc). 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 zijn verleend.

De cmdlet retourneert standaard Get-PSSessionCapability een lijst met opdrachten die de opgegeven gebruiker kan uitvoeren in het opgegeven eindpunt. Dit komt overeen met de gebruiker die wordt uitgevoerd Get-Command in het opgegeven eindpunt. Wanneer deze cmdlet wordt uitgevoerd met de parameter Volledig , retourneert deze cmdlet een InitialSessionState-object . Dit object bevat details over de Windows 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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Username

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Uitvoerwaarden

AliasInfo

FunctionInfo

InitialSessionState