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 Get-PSSessionCapability
cmdlet pobiera możliwości określonego użytkownika w konfiguracji ograniczonej 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 Get-PSSessionCapability
cmdlet 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 zwraca listę poleceń, Get-PSSessionCapability
które określony użytkownik może uruchomić w określonym punkcie końcowym. Jest to odpowiednik użytkownika uruchomionego Get-Command
w określonym punkcie końcowym. Po uruchomieniu z pełnym parametrem 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' -Full
W tym przykładzie zwracane są szczegółowe informacje o przestrzeni uruchomieniowej, z którymi użytkownik CONTOSO\User będzie wchodzić w interakcję podczas nawiązywania połączenia z ograniczonym punktem końcowym 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 przeprowadzasz inspekcję.
Typ: | String |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |