Get-PSSessionCapability
Hiermee haalt u de mogelijkheden van een specifieke gebruiker op voor een beperkte sessieconfiguratie.
Syntax
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 Windows 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 de gebruiker CONTOSO\Gebruiker bij het maken van verbinding met het eindpunt1 beperkt eindpunt 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\Gebruiker interactie zou hebben bij het maken van verbinding met het eindpunt1 beperkt eindpunt.
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.
