Get-PSSessionCapability
Hämtar funktionerna för en specifik användare i en begränsad sessionskonfiguration.
Syntax
Default (Standard)
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 den användare som kör Get-Command i den angivna slutpunkten. När den körs med parametern Fullständig 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
Det här exemplet returnerar information om det runspace som användaren CONTOSO\User skulle interagera med när de ansluter till den begränsade endpointen Endpoint1.
Parametrar
-ConfigurationName
Anger den begränsade sessionskonfiguration (slutpunkt) som du inspekterar.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Username
Anger den användare vars funktioner du inspekterar.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 1 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
