Partager via


État de session Windows PowerShell

L’état de session fait référence à la configuration actuelle d’une session ou d’un module Windows PowerShell. Une session Windows PowerShell est l’environnement opérationnel utilisé de manière interactive par l’utilisateur de ligne de commande ou par programme par une application hôte. L’état de session d’une session est appelé état de session global.

Du point de vue du développeur, une session Windows PowerShell fait référence au temps entre le moment où une application hôte ouvre un runspace Windows PowerShell et lorsqu’elle ferme l’espace d’exécution. Examiné d’une autre façon, la session est la durée de vie d’une instance du moteur Windows PowerShell qui est appelée pendant l’exécution.

État de session du module

Les états de session de module sont créés chaque fois que le module ou l’un de ses modules imbriqués est importé dans la session. Lorsqu’un module exporte un élément tel qu’une applet de commande, une fonction ou un script, une référence à cet élément est ajoutée à l’état de session global de la session. Toutefois, lorsque l’élément est exécuté, il est exécuté dans l’état de session du module.

données Session-State

Les données d’état de session peuvent être publiques ou privées. Les données publiques sont disponibles pour les appels en dehors de l’état de session, tandis que les données privées sont disponibles uniquement pour les appels à partir de l’état de session. Par exemple, un module peut avoir une fonction privée qui peut être appelée uniquement par le module ou uniquement en interne par un élément public qui a été exporté. Ceci est similaire aux membres privés et publics d’un type .NET Framework.

Les données d’état de session sont stockées par l’instance actuelle du moteur d’exécution dans le contexte de la session Windows PowerShell actuelle. Les données d’état de session se composent des éléments suivants :

  • Informations sur le chemin d’accès

  • Informations sur le lecteur

  • Informations sur le fournisseur Windows PowerShell

  • Informations sur les modules importés et les références aux éléments de module (tels que les applets de commande, les fonctions et les scripts) exportés par le module. Ces informations et ces références concernent uniquement l’état de session globale.

  • Informations sur la variable d’état de session

Accès aux données Session-State dans les applets de commande

Les applets de commande peuvent accéder indirectement aux données d’état de session via la propriété System.Management.Automation.PSCmdlet.SessionState* de la classe d’applet de commande ou directement via la classe System.Management.Automation.SessionState. La classe System.Management.Automation.SessionState fournit des propriétés qui peuvent être utilisées pour examiner différents types de données d’état de session.

Voir aussi

System.Management.Automation.PSCmdlet.SessionState

System.Management.Automation.SessionState

applets de commande Windows PowerShell

écriture d’une applet de commande Windows PowerShell

sdk Windows PowerShell Shell