À propos de PSSessions
Description courte
Décrit les sessions PowerShell (PSSessions) et explique comment établir une connexion persistante à un ordinateur distant.
Description longue
Pour exécuter des commandes PowerShell sur un ordinateur distant, vous pouvez utiliser le paramètre ComputerName d’une applet de commande ou créer une session PowerShell (PSSession) et exécuter des commandes dans PSSession.
Lorsque vous créez une session PSSession, PowerShell établit une connexion persistante à l’ordinateur distant. Utilisez une session PSSession pour exécuter une série de commandes associées sur un ordinateur distant. Les commandes qui s’exécutent dans la même session PSSession peuvent partager des données, telles que les valeurs des variables, des alias et des fonctions.
Vous pouvez également créer une session PSSession sur l’ordinateur local et exécuter des commandes dans celle-ci. Une session PSSession locale utilise l’infrastructure de communication à distance PowerShell pour créer et gérer la session PSSession.
À compter de Windows PowerShell 3.0, les sessions PSSession sont indépendantes des sessions dans lesquelles elles sont créées. Les sessions PSSession actives sont conservées sur l’ordinateur distant (ou sur l’ordinateur à la fin distante ou côté serveur de la connexion). Par conséquent, vous pouvez vous déconnecter du PSSession et le reconnecter ultérieurement à partir du même ordinateur ou d’un autre ordinateur.
Cette rubrique explique comment créer, utiliser, obtenir et supprimer des psSessions. Pour plus d’informations avancées, consultez about_PSSession_Details.
Remarque : les sessions PSSession utilisent l’infrastructure de communication à distance PowerShell. Pour utiliser PSSessions, les ordinateurs locaux et distants doivent être configurés pour la communication à distance. Pour plus d'informations, consultez about_Remote_Requirements.
Dans Windows Vista et les versions ultérieures de Windows, pour créer une session PSSession sur un ordinateur local, vous devez démarrer PowerShell avec l’option « Exécuter en tant qu’administrateur ».
Qu’est-ce qu’une session ?
Une session est un environnement dans lequel PowerShell s’exécute.
Chaque fois que vous démarrez PowerShell, une session est créée pour vous et vous pouvez exécuter des commandes dans la session. Vous pouvez également ajouter des éléments à votre session, tels que des modules et des composants logiciels enfichables, et vous pouvez créer des éléments, tels que des variables, des fonctions et des alias. Ces éléments existent uniquement dans la session et sont supprimés lorsque la session se termine.
Vous pouvez également créer des sessions gérées par l’utilisateur, appelées « sessions PowerShell » ou « PSSessions », sur l’ordinateur local ou sur un ordinateur distant. Comme la session par défaut, vous pouvez exécuter des commandes dans une session PSSession et ajouter et créer des éléments. Toutefois, contrairement à la session qui démarre automatiquement, vous pouvez contrôler les PSSessions que vous créez. Vous pouvez obtenir, créer, configurer et les supprimer, déconnecter et se reconnecter à eux, et exécuter plusieurs commandes dans la même session PSSession. PsSession reste disponible jusqu’à ce que vous le supprimez ou qu’il expire.
En règle générale, vous créez une session PSSession pour exécuter une série de commandes associées sur un ordinateur distant. Lorsque vous créez une session PSSession sur un ordinateur distant, PowerShell établit une connexion persistante à l’ordinateur distant pour prendre en charge la session.
Si vous utilisez le paramètre ComputerName du ou Enter-PSSession
de l’applet Invoke-Command
de commande pour exécuter une commande distante ou pour démarrer une session interactive, PowerShell crée une session temporaire sur l’ordinateur distant et ferme la session dès que la commande est terminée ou dès que la session interactive se termine. Vous ne pouvez pas contrôler ces sessions temporaires et vous ne pouvez pas les utiliser pour plusieurs commandes ou une seule session interactive.
Dans PowerShell, la « session active » est la session dans laquelle vous travaillez. La « session active » peut faire référence à n’importe quelle session, y compris une session temporaire ou une session PSSession.
Pourquoi utiliser une session PSSession ?
Utilisez une session PSSession lorsque vous avez besoin d’une connexion permanente à un ordinateur distant. Avec une session PSSession, vous pouvez exécuter une série de commandes qui partagent des données, telles que la valeur des variables, le contenu d’une fonction ou la définition d’un alias.
Vous pouvez exécuter des commandes distantes sans créer de session PSSession. Utilisez le paramètre ComputerName des applets de commande à distance pour exécuter une seule commande ou une série de commandes non liées sur un ou plusieurs ordinateurs.
Lorsque vous utilisez le paramètre ComputerName de Invoke-Command
ou Enter-PSSession
, PowerShell établit une connexion temporaire à l’ordinateur distant, puis ferme la connexion dès que la commande est terminée. Tous les éléments de données que vous créez sont perdus lorsque la connexion est fermée.
D’autres applets de commande qui ont un paramètre ComputerName , par Get-Eventlog
exemple, Get-WmiObject
utilisent différentes technologies de communication à distance pour collecter des données. Aucun ne crée une connexion persistante comme une session PSSession.
Comment créer une session PSSession
Pour créer une session PSSession, utilisez l’applet de New-PSSession
commande. Pour créer psSession sur un ordinateur distant, utilisez le paramètre ComputerName de l’applet New-PSSession
de commande.
Par exemple, la commande suivante crée une nouvelle session PSSession sur l’ordinateur Server01.
New-PSSession -ComputerName Server01
Lorsque vous envoyez la commande, New-PSSession
crée la session PSSession et retourne un objet qui représente psSession. Vous pouvez enregistrer l’objet dans une variable lorsque vous créez psSession, ou vous pouvez utiliser une Get-PSSession
commande pour obtenir la session PSSession ultérieurement.
Par exemple, la commande suivante crée une session PSSession sur l’ordinateur Server01 et enregistre l’objet résultant dans la variable $ps.
$ps = New-PSSession -ComputerName Server01
Procédure de création de PSSessions sur plusieurs ordinateurs
Pour créer des psSessions sur plusieurs ordinateurs, utilisez le paramètre ComputerName de l’applet New-PSSession
de commande. Tapez les noms des ordinateurs distants dans une liste séparée par des virgules.
Par exemple, pour créer des psSessions sur les ordinateurs Server01, Server02 et Server03, tapez :
New-PSSession -ComputerName Server01, Server02, Server03
New-PSSession
crée une session PSSession sur chacun des ordinateurs distants.
Procédure d’obtention de PSSessions
Pour obtenir les PSSessions qui ont été créées dans votre session active, utilisez l’applet Get-PSSession
de commande sans le paramètre ComputerName . Get-PSSession
retourne le même type d’objet que celui qui New-PSSession
retourne.
La commande suivante obtient tous les PSSessions qui ont été créés dans la session active.
Get-PSSession
L’affichage par défaut des PSSessions affiche leur ID et un nom d’affichage par défaut. Vous pouvez attribuer un autre nom d’affichage lorsque vous créez la session.
Id Name ComputerName State ConfigurationName
--- ---- ------------ ----- ---------------------
1 Session1 Server01 Opened Microsoft.PowerShell
2 Session2 Server02 Opened Microsoft.PowerShell
3 Session3 Server03 Opened Microsoft.PowerShell
Vous pouvez également enregistrer les psSessions dans une variable. La commande suivante obtient les psSessions et les enregistre dans la variable $ps 123.
$ps123 = Get-PSSession
Lorsque vous utilisez les applets de commande PSSession, vous pouvez faire référence à une session PSSession par son ID, par son nom ou par son ID d’instance (un GUID). La commande suivante obtient une session PSSession par son ID et l’enregistre dans la variable $ps 01.
$ps01 = Get-PSSession -Id 1
À compter de Windows PowerShell 3.0, les sessions PSSession sont conservées sur l’ordinateur distant. Pour obtenir des sessions PSSession que vous avez créées sur des ordinateurs distants particuliers, utilisez le paramètre ComputerName de l’applet Get-PSSession
de commande. La commande suivante obtient les PSSessions que vous avez créées sur l’ordinateur distant Server01. Cela inclut les sessions PSSession créées dans la session active et dans d’autres sessions sur l’ordinateur local ou d’autres ordinateurs.
Get-PSSession -ComputerName Server01
Dans Windows PowerShell 2.0, Get-PSSession
obtient uniquement les psSessions qui ont été créées dans la session active. Il n’obtient pas les sessions PSSession créées dans d’autres sessions ou sur d’autres ordinateurs, même si les sessions sont connectées et exécutent des commandes sur l’ordinateur local.
Comment exécuter des commandes dans une session PSSession
Pour exécuter une commande dans une ou plusieurs sessions PSSessions, utilisez l’applet de Invoke-Command
commande.
Utilisez le paramètre Session pour spécifier les psSessions et le paramètre ScriptBlock pour spécifier la commande.
Par exemple, pour exécuter une Get-ChildItem
commande (« dir ») dans chacune des trois sessions PSSession enregistrées dans la variable $ps 123, tapez :
Invoke-Command -Session $ps123 -ScriptBlock { Get-ChildItem }
Comment supprimer des sessions PSSessions
Lorsque vous avez terminé avec PSSession, utilisez l’applet Remove-PSSession
de commande pour supprimer psSession et libérer les ressources qu’il utilise.
Remove-PSSession -Session $ps
ou
Remove-PSSession -Id 1
Pour supprimer une session PSSession d’un ordinateur distant, utilisez le paramètre ComputerName de l’applet Remove-PSSession
de commande.
Remove-PSSession -ComputerName Server01 -Id 1
Si vous ne supprimez pas psSession, psSession reste disponible pour une utilisation jusqu’à ce qu’il expire.
Vous pouvez également utiliser le paramètre IdleTimeout de l’applet New-PSSessionOption
de commande pour définir une heure d’expiration pour une PSSession inactive. Pour plus d’informations, consultez New-PSSessionOption.
Applets de commande PSSession
Pour obtenir la liste des applets de commande PSSession, tapez :
Get-Help *-PSSession
- Connect-PSSession : connecte une session PSSession à la session actuelle
- Disconnect-PSSession : déconnecte une session PSSession à partir de la session actuelle
- Entrée-PSSession : démarre une session interactive
- Exit-PSSession : termine une session interactive
- Get-PSSession : Obtient les PSSessions dans la session active
- New-PSSession : crée une session PSSession sur un ordinateur local ou distant
- Receive-PSSession : obtient les résultats des commandes qui ont été exécutées dans une session déconnectée
- Remove-PSSession : Supprime les sessions PSSession dans la session active
Pour plus d'informations
Pour plus d’informations sur PSSessions, consultez about_PSSession_Details.