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 benutzerdefinierte Sitzungskonfigurationen für Benutzer zu überwachen.

Ab Windows PowerShell 5.0 können Sie die RoleDefinitions-Eigenschaft in einer Sitzungskonfigurationsdatei (.pssc) verwenden. Mit dieser Eigenschaft können Sie Benutzern basierend auf der Gruppenmitgliedschaft verschiedene Funktionen für einen einzelnen eingeschränkten Endpunkt gewähren. Das Get-PSSessionCapability Cmdlet reduziert 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 . Bei Ausführung mit dem Full-Parameter 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 eingeschränkten Endpunkt Endpoint1 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 beim Herstellen einer Verbindung mit dem eingeschränkten Endpunkt Endpoint1 interagieren würde.

Parameter

-ConfigurationName

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

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

-Full

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

AliasInfo

FunctionInfo

InitialSessionState