Get-PSSession

Obtient les sessions Windows PowerShell (PSSession) dans la session active.

Syntaxe

Get-PSSession [[-ComputerName] <string[]>] [<CommonParameters>]

Get-PSSession [-Id] <Int32[]> [<CommonParameters>]

Get-PSSession [-InstanceId <Guid[]>] [<CommonParameters>]

Get-PSSession [-Name <string[]>] [<CommonParameters>]

Description

L'applet de commande Get-PSSession obtient les sessions Windows PowerShell (PSSession) créées dans la session active.

Sans paramètres, Get-PSSession obtient toutes les sessions PSSession créées dans la session active. Vous pouvez utiliser les paramètres de Get-PSSession pour obtenir les sessions qui sont connectées à des ordinateurs particuliers ; vous avez également la possibilité d'identifier les sessions par leur nom, leur ID ou leur ID d'instance.

Pour plus d'informations sur les sessions Windows PowerShell, consultez about_PSSessions.

Paramètres

-ComputerName <string[]>

Obtient uniquement les sessions PSSession connectées aux ordinateurs spécifiés. Les caractères génériques sont autorisés.

Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet d'un ou de plusieurs ordinateurs. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, « localhost » ou un point (.).

Obligatoire ?	false
Position ?	1
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByPropertyName)
Accepter les caractères génériques ?	true

-Id <Int32[]>

Obtient uniquement les sessions PSSession comportant les ID spécifiés. Tapez un ou plusieurs ID (séparés par des virgules) ou utilisez l'opérateur de plage (..) pour spécifier une plage d'ID.

Un ID est un entier qui identifie de manière unique la session PSSession dans la session active. Il est plus facile à mémoriser et à taper que l'InstanceId, mais est seulement unique dans la session active. Pour rechercher l'ID d'une session PSSession, utilisez Get-PSSession sans paramètres.

Obligatoire ?	true
Position ?	1
Valeur par défaut	All sessions in the shell
Accepter l'entrée de pipeline ?	true (ByPropertyName)
Accepter les caractères génériques ?	false

-InstanceId <Guid[]>

Obtient uniquement les sessions PSSession correspondant aux ID d'instance spécifiés.

L'ID d'instance est un GUID qui identifie de manière unique une session PSSession sur un ordinateur local ou distant. L'InstanceID est unique, même quand plusieurs de vos sessions s'exécutent dans Windows PowerShell.

L'InstanceID est stocké dans la propriété InstanceID de l'objet qui représente une session PSSession. Pour rechercher l'InstanceID des sessions PSSession dans la session active, tapez « get-pssession | Format-Table Name, ComputerName, InstanceId ».

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByPropertyName)
Accepter les caractères génériques ?	true

-Name <string[]>

Obtient uniquement les sessions PSSession correspondant aux noms conviviaux spécifiés. Les caractères génériques sont autorisés.

Pour rechercher les noms des sessions PSSession dans la session active, tapez « get-pssession » sans paramètres.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByPropertyName)
Accepter les caractères génériques ?	true

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées	Aucun Vous ne pouvez pas diriger d'entrée vers cette applet de commande.
Sorties	System.Management.Automation.Runspaces.PSSession Get-PSSession retourne un objet PSSession pour chaque session PSSession obtenue.

Remarques

Get-PSSession obtient les sessions PSSession qui ont été créées dans la session active. Elle n'obtient pas la session créée lorsque vous ouvrez Windows PowerShell, ni les sessions PSSession créées dans d'autres sessions ou sur d'autres ordinateurs, même s'ils se connectent à l'ordinateur local.

Exemple 1

C:\PS>get-pssession

Description
-----------
Cette commande obtient toutes les sessions PSSession qui ont été créées dans la session active. 

Elle n'obtient pas les sessions PSSession qui ont été créées dans d'autres sessions ou sur d'autres ordinateurs, même s'ils se connectent à cet ordinateur.

Exemple 2

C:\PS>$s = get-pssession -computername Server02

Description
-----------
Cette commande obtient les sessions PSSession qui sont connectées à l'ordinateur Server02 et les enregistre dans la variable $p.

Exemple 3

C:\PS>new-pssession -computername Server01, Server02, Server03

C:\PS> $s1, $s2, $s3 = get-pssession

Description
-----------
Cet exemple montre comment enregistrer les résultats d'une commande Get-PSSession dans plusieurs variables. 

La première commande utilise l'applet de commande New-PSSession pour créer des sessions PSSession sur trois ordinateurs distants.

La deuxième commande utilise une applet de commande Get-PSSession pour obtenir les trois sessions PSSession. Elle enregistre ensuite chaque session PSSession dans une variable séparée.

Lorsque Windows PowerShell attribue un tableau d'objets à un tableau de variables, il attribue le premier objet à la première variable, le deuxième à la deuxième variable, et ainsi de suite. S'il y a plus d'objets que de variables, il attribue tous les objets restants à la dernière variable du tableau. S'il y a plus de variables que d'objets, les variables supplémentaires ne sont pas utilisées.

Exemple 4

C:\PS>get-pssession | format-table -property computername, InstanceID

C:\PS> $s = get-pssession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f

C:\PS> remove-pssession -session $s

Description
-----------
Cet exemple montre comment obtenir une session PSSession en utilisant son ID d'instance, puis comment supprimer la session PSSession.

La première commande obtient toutes les sessions PSSession sur l'ordinateur local. Elle envoie les sessions PSSession à l'applet de commande Format-Table, qui affiche les propriétés ComputerName et InstanceID de chaque session PSSession.

La deuxième commande utilise l'applet de commande Get-PSSession pour obtenir une session PSSession particulière et l'enregistrer dans la variable $s. Elle utilise le paramètre InstanceID pour identifier la session PSSession.

La troisième commande utilise l'applet de commande Remove-PSSession pour supprimer la session PSSession dans la variable $s.

Exemple 5

C:\PS>get-pssession -computername Serv*

Description
-----------
Cette commande obtient toutes les sessions PSSession qui se connectent aux ordinateurs dont les noms commencent par « Serv ».

Exemple 6

C:\PS>get-pssession -name Test*, Ux*

Description
-----------
Cette commande obtient des sessions PSSession dont les noms commencent par « Test » ou « Ux ».

Exemple 7

C:\PS>get-pssession 2

Description
-----------
Cette commande obtient la session PSSession dont l'ID est 2.

Voir aussi

Concepts

about_PSSessions
about_Remote
New-PSSession
Remove-PSSession
Enter-PSSession
Exit-PSSession
Invoke-Command