Get-PSSessionCapability
Hiermee haalt u de mogelijkheden van een specifieke gebruiker op voor een beperkte sessieconfiguratie.
Syntaxis
Default (Standaard)
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>]
Description
De Get-PSSessionCapability cmdlet haalt de mogelijkheden van een specifieke gebruiker op voor een beperkte sessieconfiguratie. Gebruik deze cmdlet om aangepaste sessieconfiguraties voor gebruikers te controleren.
Vanaf Windows PowerShell 5.0 kunt u de eigenschap RoleDefinitions in een sessieconfiguratiebestand (.pssc) gebruiken. Met deze eigenschap kunt u gebruikers verschillende mogelijkheden verlenen op één beperkt eindpunt op basis van groepslidmaatschap. De Get-PSSessionCapability cmdlet vermindert de complexiteit bij het controleren van deze eindpunten door u de exacte mogelijkheden te laten bepalen die aan een gebruiker worden verleend.
De Get-PSSessionCapability cmdlet retourneert standaard een lijst met opdrachten die de opgegeven gebruiker kan uitvoeren in het opgegeven eindpunt. Dit komt overeen met de gebruiker die Get-Command uitvoert in het opgegeven eindpunt. Wanneer deze cmdlet wordt uitgevoerd met de parameter Full, retourneert deze cmdlet een InitialSessionState-object. Dit object bevat details over de PowerShell-runspace waarmee de opgegeven gebruiker zou communiceren voor het opgegeven eindpunt. Het bevat informatie zoals taalmodus, uitvoeringsbeleid en omgevingsvariabelen.
Voorbeelden
Voorbeeld 1: Opdrachten ophalen die beschikbaar zijn voor een gebruiker
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'
In dit voorbeeld worden de opdrachten geretourneerd die beschikbaar zijn voor gebruiker CONTOSO\User bij verbinding met het beperkte eindpunt Endpoint1 op de lokale computer.
Voorbeeld 2: Details ophalen over een runspace voor een gebruiker
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full
In dit voorbeeld worden details geretourneerd over de runspace waarmee de gebruiker CONTOSO\User interactie zou hebben wanneer verbinding wordt gemaakt met het beperkte eindpunt Endpoint1.
Parameters
-ConfigurationName
Geeft de beperkte sessieconfiguratie (eindpunt) op die u inspecteert.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Full
Geeft aan dat deze cmdlet de volledige initiële sessiestatus retourneert voor de opgegeven gebruiker op het opgegeven beperkte eindpunt.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Username
Hiermee geeft u de gebruiker op waarvan u de mogelijkheden controleert.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.