Freigeben über

Get-PSSessionCapability

  • Referenz
Modul:
Microsoft.PowerShell.Core

Ruft die Funktionen eines bestimmten Benutzers für eine eingeschränkte Sitzungskonfiguration ab.

Syntax

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

Beschreibung

Das Get-PSSessionCapability Cmdlet ruft die Funktionen eines bestimmten Benutzers für eine eingeschränkte 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 für einen einzelnen eingeschränkten Endpunkt basierend auf der Gruppenmitgliedschaft gewähren. Das Get-PSSessionCapability Cmdlet verringert die Komplexität bei der Überwachung dieser Endpunkte, indem Sie die genauen Funktionen bestimmen können, die einem Benutzer gewährt werden.

Standardmäßig gibt das Get-PSSessionCapability Cmdlet eine Liste von Befehlen 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 dieses Cmdlet mit dem Parameter Full ausgeführt wird, 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 interagiert. Sie 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 für den Benutzer CONTOSO\User verfügbar sind, wenn eine Verbindung mit dem endpunktgeschrä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 Endpoint1 hergestellt wird.

Parameter

-ConfigurationName

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

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Full

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Username

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

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

AliasInfo

FunctionInfo

InitialSessionState