Partager via

Get-PSSessionCapability

  • Référence
Module:
Microsoft.PowerShell.Core

Obtient les fonctionnalités d’un utilisateur spécifique sur une configuration de session contrainte.

Syntaxe

Get-PSSessionCapability
   [-ConfigurationName] <String>
   [-Username] <String>
   [-Full]
   [<CommonParameters>]

Description

L’applet de commande get-PSSessionCapability get-PSSessionCapability 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 point de terminaison limité unique en fonction de l’appartenance au groupe. L’applet de commande Get-PSSessionCapability réduit la complexité lors 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 de commande Get-PSSessionCapability retourne une liste de commandes que l’utilisateur spécifié peut exécuter dans le point de terminaison spécifié. Cela équivaut à l’utilisateur exécutant Get-Command dans le point de terminaison spécifié. Lors de l’exécution 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 Windows PowerShell avec lequel l’utilisateur spécifié interagit avec 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 environnementales.

Exemples

Exemple 1 : Obtenir les commandes disponibles pour un utilisateur

PS C:\> Get-PSSessionCapability -ConfigurationName "Endpoint1" -Username "CONTOSO\EvanNa"

Cet exemple retourne les commandes disponibles pour l’utilisateur CONTOSO\EvanNa lors de la connexion au point de terminaison limité Endpoint1 sur l’ordinateur local.

Exemple 2 : Obtenir des détails sur un runspace pour un utilisateur

PS C:\> Get-PSSessionCapability -ConfigurationName "Endpoint1" -Username "CONTOSO\PattiFul" -Full

Cette commande retourne des détails sur l’espace d’exécution avec lequel l’utilisateur CONTOSO\PattiFul interagit 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Full

Indique que cette applet de commande retourne l’état de session initial complet de l’utilisateur spécifié au point de terminaison contraint spécifié.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Username

Spécifie l’utilisateur dont vous inspectez les fonctionnalités.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

AliasInfo

FunctionInfo

InitialSessionState