Get-PSSessionCapability
Obtient les fonctionnalités d’un utilisateur spécifique sur une configuration de session contrainte.
Syntax
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>]
Description
L’applet Get-PSSessionCapability
de commande obtient les fonctionnalités d’un utilisateur spécifique sur une configuration de session contrainte. Utilisez cette applet de commande pour auditer les configurations de session personnalisées pour les utilisateurs.
À compter de Windows PowerShell 5.0, vous pouvez utiliser la propriété RoleDefinitions dans un fichier de configuration de session (.pssc
). L’utilisation de cette propriété vous permet d’accorder aux utilisateurs différentes fonctionnalités sur un seul point de terminaison limité en fonction de l’appartenance au groupe. L’applet Get-PSSessionCapability
de commande réduit la complexité de l’audit de ces points de terminaison en vous permettant de déterminer les fonctionnalités exactes accordées à un utilisateur.
Par défaut, l’applet Get-PSSessionCapability
de commande retourne une liste de commandes que l’utilisateur spécifié peut exécuter dans le point de terminaison spécifié. Cela équivaut à l’exécution de l’utilisateur Get-Command
dans le point de terminaison spécifié. Lorsqu’elle est exécutée avec le paramètre Full , cette applet de commande renvoie un objet InitialSessionState . Cet objet contient des détails sur l’espace d’exécution PowerShell avec lequel l’utilisateur spécifié doit interagir pour le point de terminaison spécifié. Il inclut des informations telles que le mode de langage, la stratégie d’exécution et les variables d’environnement.
Exemples
Exemple 1 : Obtenir les commandes disponibles pour un utilisateur
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'
Cet exemple retourne les commandes disponibles pour l’utilisateur CONTOSO\User lors de la connexion au point de terminaison limité Endpoint1 sur l’ordinateur local.
Exemple 2 : Obtenir des détails sur une instance d’exécution pour un utilisateur
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full
Cet exemple retourne des détails sur l’espace d’exécution avec lequel CONTOSO\User interagirait lors de la connexion au point de terminaison limité Endpoint1.
Paramètres
-ConfigurationName
Spécifie la configuration de session contrainte (point de terminaison) que vous inspectez.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Full
Indique que cette applet de commande retourne l’état de session initial entier pour l’utilisateur spécifié au niveau du point de terminaison contraint spécifié.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Username
Spécifie l’utilisateur dont vous inspectez les fonctionnalités.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |