Get-PSSessionCapability
Pobiera możliwości określonego użytkownika w konfiguracji ograniczonej sesji.
Składnia
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>] Opis
Polecenie cmdlet Get-PSSessionCapability pobiera możliwości określonego użytkownika w ograniczonej konfiguracji sesji. To polecenie cmdlet służy do inspekcji niestandardowych konfiguracji sesji dla użytkowników.
Począwszy od programu Windows PowerShell 5.0, można użyć właściwości RoleDefinitions w pliku konfiguracji sesji (.pssc). Użycie tej właściwości umożliwia przyznawanie użytkownikom różnych możliwości dla pojedynczego ograniczonego punktu końcowego na podstawie członkostwa w grupie. Polecenie cmdlet Get-PSSessionCapability zmniejsza złożoność podczas inspekcji tych punktów końcowych, umożliwiając określenie dokładnych możliwości przyznanych użytkownikowi.
Domyślnie polecenie cmdlet Get-PSSessionCapability zwraca listę poleceń, które określony użytkownik może uruchomić w określonym punkcie końcowym. Jest to równoznaczne z tym, że użytkownik uruchamia Get-Command w określonym punkcie końcowym. Po uruchomieniu z parametrem Full, to polecenie cmdlet zwraca obiekt InitialSessionState. Ten obiekt zawiera szczegółowe informacje o przestrzeni uruchomieniowej programu PowerShell, z którym określony użytkownik będzie wchodzić w interakcję dla określonego punktu końcowego. Zawiera informacje, takie jak Tryb językowy, Zasady wykonywania i Zmienne środowiskowe.
Przykłady
Przykład 1. Pobieranie poleceń dostępnych dla użytkownika
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'Ten przykład zwraca polecenia dostępne dla użytkownika CONTOSO\User podczas nawiązywania połączenia z ograniczonym punktem końcowym Endpoint1 na komputerze lokalnym.
Przykład 2. Uzyskiwanie szczegółowych informacji o przestrzeni uruchomieniowej dla użytkownika
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -FullW tym przykładzie zwracane są szczegółowe informacje o sesji, z którą użytkownik CONTOSO\User będzie miał interakcję podczas nawiązywania połączenia z ograniczonym punktem końcowym o nazwie Endpoint1.
Parametry
-ConfigurationName
Określa konfigurację sesji ograniczonej (punkt końcowy), która jest sprawdzana.
| Typ: | String |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Full
Wskazuje, że to polecenie cmdlet zwraca cały początkowy stan sesji dla określonego użytkownika w określonym ograniczonym punkcie końcowym.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Username
Określa użytkownika, którego możliwości sprawdzasz.
| Typ: | String |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
