Get-PSSessionCapability

  • Referens
Modul:
Microsoft.PowerShell.Core

Hämtar funktionerna för en specifik användare i en begränsad sessionskonfiguration.

Syntax

Get-PSSessionCapability
   [-ConfigurationName] <String>
   [-Username] <String>
   [-Full]
   [<CommonParameters>]

Description

Cmdleten Get-PSSessionCapability hämtar funktionerna för en specifik användare i en begränsad sessionskonfiguration. Använd den här cmdleten för att granska anpassade sessionskonfigurationer för användare.

Från och med Windows PowerShell 5.0 kan du använda egenskapen RoleDefinitions i en sessionskonfigurationsfil (.pssc). Med den här egenskapen kan du ge användare olika funktioner på en enda begränsad slutpunkt baserat på gruppmedlemskap. Cmdleten Get-PSSessionCapability minskar komplexiteten vid granskning av dessa slutpunkter genom att du kan fastställa de exakta funktioner som beviljas en användare.

Som standard returnerar cmdleten Get-PSSessionCapability en lista med kommandon som den angivna användaren kan köra i den angivna slutpunkten. Detta motsvarar användaren som körs Get-Command i den angivna slutpunkten. När den körs med den fullständiga parametern returnerar den här cmdleten ett InitialSessionState-objekt . Det här objektet innehåller information om den PowerShell-runspace som den angivna användaren skulle interagera med för den angivna slutpunkten. Den innehåller information som språkläge, körningsprincip och miljövariabler.

Exempel

Exempel 1: Hämta kommandon som är tillgängliga för en användare

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'

Det här exemplet returnerar de kommandon som är tillgängliga för användaren CONTOSO\User när du ansluter till slutpunkten1-begränsad slutpunkt på den lokala datorn.

Exempel 2: Hämta information om en runspace för en användare

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full

I det här exemplet returneras information om det runspace som användaren CONTOSO\User interagerar med när de ansluter till slutpunkten1-begränsad slutpunkt.

Parametrar

-ConfigurationName

Anger den begränsade sessionskonfiguration (slutpunkt) som du inspekterar.

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

-Full

Anger att den här cmdleten returnerar hela det inledande sessionstillståndet för den angivna användaren vid den angivna begränsade slutpunkten.

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

-Username

Anger den användare vars funktioner du inspekterar.

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

Utdata

AliasInfo

FunctionInfo

InitialSessionState