about_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 la session 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 de variables, d’alias et de 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 sur Windows sont indépendantes des sessions dans lesquelles elles sont créées. Les sessions PSSession actives sont conservées sur l’ordinateur distant (ou l’ordinateur à la fin distante ou côté serveur de la connexion). Par conséquent, sur Windows, vous pouvez vous déconnecter d’une session PSSession sur un ordinateur Windows distant et la reconnecter ultérieurement à partir du même ordinateur ou d’un autre ordinateur Windows.

Cette rubrique explique comment créer, utiliser, obtenir et supprimer des sessions PSSession. Pour plus d’informations avancées, consultez about_PSSession_Details.

Remarque : les sessions PSSession utilisent l’infrastructure de communication à distance PowerShell. Pour utiliser des sessions PSSession, 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 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 sessions PSSession que vous créez. Vous pouvez obtenir, créer, configurer et supprimer ces derniers, les déconnecter et les reconnecter, puis exécuter plusieurs commandes dans la même session PSSession. La session PSSession reste disponible jusqu’à ce que vous le supprimiez 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 de l’applet de commande ou Enter-PSSession de l’applet Invoke-Command de commande pour exécuter une commande à distance 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 session interactive unique.

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 persistante à 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 , comme Get-Eventlog et 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 New-PSSession de commande. Pour créer la session 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 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 la session PSSession. Vous pouvez enregistrer l’objet dans une variable lorsque vous créez la session 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

Guide pratique pour créer des sessions PSSession sur plusieurs ordinateurs

Pour créer des sessions PSSession 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 sessions PSSession 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.

Comment obtenir des sessions PSSession

Pour obtenir les sessions PSSession 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 retourné New-PSSession .

La commande suivante obtient toutes les sessions PSSession qui ont été créées dans la session active.

Get-PSSession

L’affichage par défaut des sessions PSSession 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 sessions PSSession dans une variable. La commande suivante obtient les sessions PSSession 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 sessions PSSession 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 sessions PSSession 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 PSSession, utilisez l’applet de Invoke-Command commande. Utilisez le paramètre Session pour spécifier les sessions PSSession 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 PSSession

Une fois la session PSSession terminée, utilisez l’applet Remove-PSSession de commande pour supprimer la session PSSession et libérer les ressources qu’il utilise.

Remove-PSSession -Session $ps

or

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 la session PSSession, la session PSSession reste disponible pour une utilisation jusqu’à ce qu’elle expire.

Vous pouvez également utiliser le paramètre IdleTimeout de l’applet New-PSSessionOption de commande pour définir un délai d’expiration pour une session 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 active
• Disconnect-PSSession : déconnecte une session PSSession de la session active
• Entrée-PSSession : démarre une session interactive
• Exit-PSSession : met fin à une session interactive
• Get-PSSession : Obtient les sessions PSSession 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 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 les sessions PSSession, consultez about_PSSession_Details.

Voir aussi

• about_Remote
• about_Remote_Disconnected_Sessions
• about_Remote_Requirements
• Invoke-Command
• Connect-PSSession
• Disconnect-PSSession
• Enter-PSSession
• Exit-PSSession
• Get-PSSession
• New-PSSession
• Remove-PSSession