Get-PSSessionCapability
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ändarna 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 funktionerna som beviljas en användare.
Som standard returnerar cmdleten Get-PSSessionCapability en lista över kommandon som den angivna användaren kan köra i den angivna slutpunkten. Detta motsvarar den användare som kör Get-Command i den angivna slutpunkten. När du kör med den fullständiga parametern returnerar den här cmdleten ett InitialSessionState-objekt . Det här objektet innehåller information om det 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 slutpunkt1-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
Det här exemplet returnerar information om det runspace som användaren CONTOSO\User interagerar med när den ansluter till slutpunkt1-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 |