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 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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Username

Określa użytkownika, którego możliwości przeprowadzasz inspekcję.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Dane wyjściowe

AliasInfo

FunctionInfo

InitialSessionState