Udostępnij za pośrednictwem

Get-PSSessionCapability

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

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 konfiguracji sesji ograniczonej. 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 odpowiednik użytkownika z 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 Windows 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

PS C:\> Get-PSSessionCapability -ConfigurationName "Endpoint1" -Username "CONTOSO\EvanNa"

Ten przykład zwraca polecenia dostępne dla użytkownika CONTOSO\EvanNa 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

PS C:\> Get-PSSessionCapability -ConfigurationName "Endpoint1" -Username "CONTOSO\PattiFul" -Full

To polecenie zwraca szczegółowe informacje o przestrzeni uruchomieniowej, z którymi użytkownik CONTOSO\PattiFul 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

Dane wyjściowe

AliasInfo

FunctionInfo

InitialSessionState