Get-PSSessionCapability
Ruft die Funktionen eines bestimmten Benutzers für eine eingeschränkte Sitzungskonfiguration ab.
Syntax
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-PSSessionCapability 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. Mit dieser Eigenschaft können Sie Benutzern basierend auf der Gruppenmitgliedschaft verschiedene Funktionen für einen einzelnen eingeschränkten Endpunkt gewähren. Das Cmdlet Get-PSSessionCapability 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 Cmdlet Get-PSSessionCapability eine Liste von Befehlen zurück, die der angegebene Benutzer am angegebenen Endpunkt ausführen kann. Dies entspricht dem Benutzer, der Get-Command am angegebenen Endpunkt ausführt. 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 dem Benutzer CONTOSO\User beim Herstellen einer Verbindung mit dem eingeschränkten Endpunkt Endpoint1 auf dem lokalen Computer zur Verfügung stehen.
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 interagiert.
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 Sitzungszustand 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 |