Get-PSSessionCapability
Pobiera możliwości określonego użytkownika w konfiguracji ograniczonej sesji.
Składnia
Default (Domyślna)
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' -Full
W 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.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Username
Określa użytkownika, którego możliwości sprawdzasz.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
