Get-PSSessionCapability

Ruft die Funktionen eines bestimmten Benutzers auf einer eingeschränkten Sitzungskonfiguration ab.

Syntax

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

Beschreibung

Das Get-PSSessionCapability Cmdlet ruft die Funktionen eines bestimmten Benutzers auf einer eingeschränkten Sitzungskonfiguration ab. Verwenden Sie dieses Cmdlet, um angepasste Sitzungskonfigurationen für Benutzer zu überwachen.

Ab Windows PowerShell 5.0 können Sie die RoleDefinitions-Eigenschaft in einer Sitzungskonfigurationsdatei (.pssc) verwenden. Mithilfe dieser Eigenschaft können Sie Benutzern verschiedene Funktionen auf einem einzelnen eingeschränkten Endpunkt basierend auf der Gruppenmitgliedschaft gewähren. Das Get-PSSessionCapability Cmdlet reduziert die Komplexität beim Überwachen dieser Endpunkte, indem Sie die genauen Funktionen bestimmen, die einem Benutzer gewährt werden.

Standardmäßig gibt das Get-PSSessionCapability Cmdlet eine Liste der Befehle zurück, die der angegebene Benutzer im angegebenen Endpunkt ausführen kann. Dies entspricht dem Benutzer, der im angegebenen Endpunkt ausgeführt wird Get-Command . Wenn Sie mit dem Full-Parameter ausgeführt werden, gibt dieses Cmdlet ein InitialSessionState-Objekt zurück. Dieses Objekt enthält Details zum PowerShell-Runspace, mit dem der angegebene Benutzer für den angegebenen Endpunkt interagieren würde. Es enthält Informationen wie Sprachmodus, Ausführungsrichtlinie und Umgebungsvariablen.

Beispiele

Beispiel 1: Abrufen von Befehlen, die für einen Benutzer verfügbar sind

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

In diesem Beispiel werden die Befehle zurückgegeben, die dem Benutzer CONTOSO\User zur Verfügung stehen, wenn eine Verbindung mit dem endpunkt1 eingeschränkten Endpunkt auf dem lokalen Computer hergestellt wird.

Beispiel 2: Abrufen von Details zu einem Runspace für einen Benutzer

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

In diesem Beispiel werden Details zum Runspace zurückgegeben, mit dem der Benutzer CONTOSO\User interagieren würde, wenn eine Verbindung mit dem eingeschränkten Endpunkt Endpunkt hergestellt wird.

Parameter

-ConfigurationName

Gibt die eingeschränkte Sitzungskonfiguration (Endpunkt) an, die Sie überprüfen.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Full

Gibt an, dass dieses Cmdlet den gesamten anfänglichen Sitzungszustand für den angegebenen Benutzer am angegebenen eingeschränkten Endpunkt zurückgibt.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Username

Gibt den Benutzer an, dessen Funktionen Sie überprüfen.

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

Ausgaben

AliasInfo

FunctionInfo

InitialSessionState