Get-PSSession

Référence

Module:: Microsoft.PowerShell.Core

Obtient les sessions PowerShell sur les ordinateurs locaux et distants.

Syntax

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

Get-PSSession
   [-ComputerName] <String[]>
   [-ApplicationName <String>]
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-Port <Int32>]
   [-UseSSL]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]

Get-PSSession
   [-ComputerName] <String[]>
   [-ApplicationName <String>]
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-Port <Int32>]
   [-UseSSL]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]

Get-PSSession
   [-ConnectionUri] <Uri[]>
   [-ConfigurationName <String>]
   [-AllowRedirection]
   -InstanceId <Guid[]>
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]

Get-PSSession
   [-ConnectionUri] <Uri[]>
   [-ConfigurationName <String>]
   [-AllowRedirection]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -VMName <String[]>
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -ContainerId <String[]>
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -ContainerId <String[]>
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -VMId <Guid[]>
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -VMId <Guid[]>
   [<CommonParameters>]

Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -VMName <String[]>
   [<CommonParameters>]

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

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

Description

L’applet Get-PSSession de commande obtient les sessions PowerShell gérées par l’utilisateur (PSSessions) sur les ordinateurs locaux et distants.

À compter de Windows PowerShell 3.0, les sessions sont stockées sur les ordinateurs à l’extrémité distante de chaque connexion. Vous pouvez utiliser les paramètres ComputerName ou ConnectionUri de Get-PSSession pour obtenir les sessions qui se connectent à l’ordinateur local ou aux ordinateurs distants, même si elles n’ont pas été créées dans la session active.

Sans paramètres, Get-PSSession obtient toutes les sessions qui ont été créées dans la session active.

Utilisez les paramètres de filtrage, notamment Name, ID, InstanceID, State, ApplicationName et ConfigurationName pour sélectionner parmi les sessions retournées Get-PSSession .

Utilisez les paramètres restants pour configurer la connexion temporaire dans laquelle la Get-PSSession commande s’exécute lorsque vous utilisez les paramètres ComputerName ou ConnectionUri .

REMARQUE : Dans Windows PowerShell 2.0, sans paramètres, Get-PSSession obtient toutes les sessions qui ont été créées dans la session active. Le paramètre ComputerName obtient les sessions qui ont été créées dans la session active et se connectent à l’ordinateur spécifié.

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

Exemples

Exemple 1 : Obtenir des sessions créées dans la session active

Get-PSSession

Cette commande obtient toutes les sessions PSSession 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 elles se connectent à cet ordinateur.

Exemple 2 : Connecter des sessions à l’ordinateur local

Get-PSSession -ComputerName "localhost"

Cette commande obtient les sessions PSSession qui sont connectées à l’ordinateur local. Pour indiquer l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.)

La commande retourne toutes les sessions sur l'ordinateur local, même si elles ont été créées dans différentes sessions ou sur des ordinateurs différents.

Exemple 3 : Connecter des sessions à un ordinateur

Get-PSSession -ComputerName "Server02"

Id Name            ComputerName    State         ConfigurationName     Availability
 -- ----            ------------    -----         -----------------     ------------
  2 Session3        Server02       Disconnected  ITTasks                       Busy
  1 ScheduledJobs   Server02       Opened        Microsoft.PowerShell     Available
  3 Test            Server02       Disconnected  Microsoft.PowerShell          Busy

Cette commande obtient les sessions PSSession connectées à l’ordinateur Server02.

La commande retourne toutes les sessions sur Server02, même si elles ont été créées dans différentes sessions ou sur des ordinateurs différents.

La sortie montre que deux sessions ont l'état Disconnected et la disponibilité Busy. Elles ont été créées dans différentes sessions et sont en cours d'utilisation. La session ScheduledJobs, qui est Ouverte et Disponible, a été créée dans la session active.

Exemple 4 : Enregistrer les résultats de cette commande

New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSession

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

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

La deuxième commande utilise une Get-PSSession applet de commande pour obtenir les trois sessions PSSession. Il enregistre ensuite chacune des sessions PSSession dans une variable distincte.

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

Exemple 5 : Supprimer une session à l’aide d’un ID de instance

Get-PSSession | Format-Table -Property ComputerName, InstanceID
$s = Get-PSSession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $s

Cet exemple montre comment obtenir une session PSSession à l’aide de son ID de instance, puis comment supprimer la session PSSession.

La première commande obtient toutes les sessions PSSession qui ont été créées dans la session active. Il envoie les sessions PSSession à l’applet de commande Format-Table, qui affiche les propriétés ComputerName et InstanceID de chaque PSSession.

La deuxième commande utilise l’applet Get-PSSession de commande pour obtenir une session PSSession particulière et l’enregistrer dans la $s variable. La commande 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 $s variable.

Exemple 6 : Obtenir une session portant un nom particulier

Les commandes de cet exemple montrent comment rechercher une session qui a un format de nom particulier et qui utilise une configuration de session particulière, puis comment se connecter à la session. Vous pouvez utiliser une commande similaire à celle-ci pour rechercher une session dans laquelle un collègue a démarré une tâche et vous connecter pour terminer la tâche.

Get-PSSession -ComputerName Server02, Server12 -Name BackupJob* -ConfigurationName ITTasks -SessionOption @{OperationTimeout=240000}

Id Name            ComputerName    State         ConfigurationName     Availability
 -- ----            ------------    -----         -----------------     ------------
  3 BackupJob04     Server02        Disconnected        ITTasks                  None

$s = Get-PSSession -ComputerName Server02 -Name BackupJob04 -ConfigurationName ITTasks | Connect-PSSession
$s

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 5 BackupJob04     Server02        Opened        ITTasks                  Available

La première commande obtient des sessions sur les ordinateurs distants Server02 et Server12 dont les noms commencent par BackupJob et utilisent la configuration de session ITTasks. La commande utilise le paramètre Name pour spécifier le modèle de nom et le paramètre ConfigurationName pour spécifier la configuration de session. La valeur du paramètre SessionOption est une table de hachage qui définit la valeur d'OperationTimeout sur 240 000 millisecondes (4 minutes). Ce paramètre donne à la commande plus de temps pour se terminer. Les paramètres ConfigurationName et SessionOption sont utilisés pour configurer les sessions temporaires dans lesquelles l’applet de Get-PSSession commande s’exécute sur chaque ordinateur. La sortie indique que la commande retourne la session BackupJob04. La session est déconnectée et la disponibilité est None, ce qui indique qu’elle n’est pas utilisée.

La deuxième commande utilise l’applet Get-PSSession de commande pour accéder à la session BackupJob04 et l’applet de commande Connect-PSSession pour se connecter à la session. La commande enregistre la session dans la variable $s.

La troisième commande obtient la session stockée dans la variable $s. La sortie indique que la Connect-PSSession commande a réussi. La session est dans l'état Opened et est utilisable.

Exemple 7 : Obtenir une session à l’aide de son ID

Get-PSSession -Id 2

Cette commande obtient la session PSSession avec l’ID 2. Étant donné que la valeur de la propriété ID est unique uniquement dans la session active, le paramètre Id est valide uniquement pour les commandes locales.

Paramètres

-AllowRedirection

Indique que cette applet de commande autorise la redirection de cette connexion vers un autre URI (Uniform Resource Identifier). Par défaut, PowerShell ne redirige pas les connexions.

Ce paramètre configure la connexion temporaire créée pour exécuter une Get-PSSession commande avec le paramètre ConnectionUri .

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationName

Spécifie le nom d'une application. Cette applet de commande se connecte uniquement aux sessions qui utilisent l’application spécifiée.

Entrez le segment de nom d'application de l'URI de connexion. Par exemple, dans l’URI de connexion suivant, le nom de l’application est WSMan : https://localhost:5985/WSMAN. Le nom d'application d'une session est stocké dans la propriété Runspace.ConnectionInfo.AppName de la session.

La valeur de ce paramètre est utilisée pour sélectionner et filtrer les sessions. Elle ne modifie pas l'application utilisée par la session.

Type:	String
Position:	Named
Default value:	All sessions
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Authentication

Spécifie le mécanisme utilisé pour authentifier les informations d’identification de la session dans laquelle la commande s’exécute Get-PSSession .

Ce paramètre configure la connexion temporaire créée pour exécuter une Get-PSSession commande avec le paramètre ComputerName ou ConnectionUri .

Les valeurs valides pour ce paramètre sont :

Default
De base
Credssp
Digest
Kerberos
Negotiate
NegotiateWithImplicitCredential.

La valeur par défaut est Default.

Pour plus d’informations sur les valeurs de ce paramètre, consultez AuthenticationMechanism, énumération.

ATTENTION : L’authentification credSSP (Credential Security Support Provider), dans laquelle les informations d’identification de l’utilisateur sont transmises à un ordinateur distant pour être authentifiées, est conçue pour les commandes qui nécessitent une authentification sur plusieurs ressources, telles que l’accès à un partage réseau distant. Ce mécanisme augmente le risque de sécurité lié à l'opération distante. Si l'ordinateur distant n'est pas fiable, les informations d'identification qui lui sont passées peuvent être utilisées pour contrôler la session réseau.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:	AuthenticationMechanism
Accepted values:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:	Named
Default value:	Default
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Spécifie le certificat de clé publique numérique (X509) d’un compte d’utilisateur qui est autorisé à créer la session dans laquelle la commande s’exécute Get-PSSession . Entrez l’empreinte numérique du certificat.

Ce paramètre configure la connexion temporaire créée pour exécuter une Get-PSSession commande avec le paramètre ComputerName ou ConnectionUri .

Les certificats sont utilisés dans l'authentification par certificat client. Ils peuvent être mappés uniquement aux comptes d'utilisateur locaux ; ils ne fonctionnent pas avec les comptes de domaine.

Pour obtenir une empreinte numérique de certificat, utilisez une commande Get-Item ou Get-ChildItem dans le lecteur PowerShell Cert :.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Spécifie un tableau de noms d’ordinateurs. Obtient les sessions qui se connectent aux ordinateurs spécifiés. Les caractères génériques ne sont pas autorisés. Il n'y a pas de valeur par défaut.

À compter de Windows PowerShell 3.0, les objets PSSession sont stockés sur les ordinateurs à l’extrémité distante de chaque connexion. Pour obtenir les sessions sur les ordinateurs spécifiés, PowerShell crée une connexion temporaire à chaque ordinateur et exécute une Get-PSSession commande.

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 (.).

Remarque : ce paramètre obtient des sessions uniquement à partir d’ordinateurs qui exécutent Windows PowerShell 3.0 ou versions ultérieures de PowerShell. Les versions antérieures ne stockent pas de sessions.

Type:	String[]
Aliases:	Cn
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ConfigurationName

Spécifie le nom d’une configuration. Cette applet de commande obtient uniquement les sessions qui utilisent la configuration de session spécifiée.

Entrez un nom de configuration ou l'URI de ressource complet d'une configuration de session. Si vous spécifiez uniquement le nom de configuration, l’URI de schéma suivant est ajouté : https://schemas.microsoft.com/powershell. Le nom de configuration d'une session est stocké dans la propriété ConfigurationName de la session.

La valeur de ce paramètre est utilisée pour sélectionner et filtrer les sessions. Elle ne modifie pas la configuration de session utilisée par la session.

Pour plus d’informations sur les configurations de session, consultez about_Session_Configurations.

Type:	String
Position:	Named
Default value:	All sessions
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ConnectionUri

Spécifie un URI qui définit le point de terminaison de connexion pour la session temporaire dans laquelle la commande s’exécute Get-PSSession . L’URI doit être complet.

Ce paramètre configure la connexion temporaire créée pour exécuter une Get-PSSession commande avec le paramètre ConnectionUri .

Le format de cette chaîne est :

<Transport>://<ComputerName>:<Port\>/<ApplicationName>

La valeur par défaut est https://localhost:5985/WSMAN.

Si vous ne spécifiez pas de ConnectionUri, vous pouvez utiliser les paramètres UseSSL, ComputerName, Port et ApplicationName pour spécifier les valeurs ConnectionURI . Les valeurs valides du segment Transport de l'URI sont HTTP et HTTPS. Si vous spécifiez un URI de connexion avec un segment transport, mais que vous ne spécifiez pas de port, la session est créée avec des ports standard : 80 pour HTTP et 443 pour HTTPS. Pour utiliser les ports par défaut pour la communication à distance PowerShell, spécifiez le port 5985 pour HTTP ou 5986 pour HTTPS.

Si l’ordinateur de destination redirige la connexion vers un autre URI, PowerShell empêche la redirection, sauf si vous utilisez le paramètre AllowRedirection dans la commande.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Ce paramètre obtient des sessions uniquement à partir des ordinateurs qui exécutent Windows PowerShell 3.0 ou versions ultérieures de Windows PowerShell. Les versions antérieures ne stockent pas de sessions.

Type:	Uri[]
Aliases:	URI, CU
Position:	0
Default value:	Http://localhost:5985/WSMAN
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ContainerId

Spécifie un tableau d’ID de conteneurs. Cette applet de commande démarre une session interactive avec chacun des conteneurs spécifiés. Utilisez la docker ps commande pour obtenir la liste des ID de conteneur. Pour plus d’informations, consultez l’aide de la commande docker ps .

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Credential

Spécifie les informations d’identification d’un utilisateur. Cette applet de commande exécute la commande avec les autorisations de l’utilisateur spécifié. Spécifiez un compte d’utilisateur autorisé à se connecter à l’ordinateur distant et à exécuter une Get-PSSession commande. La valeur par défaut est l’utilisateur actuel.

Tapez un nom d’utilisateur, par exemple User01 ou Domain01\User01, ou entrez un objet PSCredential généré par l’applet de Get-Credential commande. Si vous tapez un nom d’utilisateur, vous êtes invité à entrer le mot de passe.

Les informations d’identification sont stockées dans un objet PSCredential et le mot de passe est stocké en tant que SecureString.

Notes

Pour plus d’informations sur la protection des données SecureString , consultez Comment SecureString est-il sécurisé ?.

Ce paramètre est configuré sur la connexion temporaire créée pour exécuter une Get-PSSession commande avec le paramètre ComputerName ou ConnectionUri .

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:	PSCredential
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Spécifie un tableau d’ID de session. Cette applet de commande obtient uniquement les sessions avec 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. Vous ne pouvez pas utiliser le paramètre ID avec le paramètre ComputerName .

Un ID est un entier qui identifie de manière unique les sessions gérées par l’utilisateur dans la session active. Il est plus facile de mémoriser et de taper que l’InstanceId, mais il n’est unique que dans la session active. L'ID d'une session est stocké dans la propriété ID de la session.

Type:	Int32[]
Position:	0
Default value:	All sessions
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstanceId

Spécifie un tableau d’ID de instance de sessions. Cette applet de commande obtient uniquement les sessions avec les ID de instance spécifiés.

L'ID d'instance est un GUID qui identifie une session sur un ordinateur local ou distant. InstanceID est unique, même si plusieurs sessions s’exécutent dans PowerShell.

L'ID d'instance d'une session est stocké dans la propriété InstanceID de la session.

Type:	Guid[]
Position:	Named
Default value:	All sessions
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Spécifie un tableau de noms de session. Cette applet de commande obtient uniquement les sessions qui ont les noms conviviaux spécifiés. Les caractères génériques sont autorisés.

Le nom convivial d'une session est stocké dans la propriété Name de la session.

Type:	String[]
Position:	Named
Default value:	All sessions
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-Port

Spécifie le port réseau spécifié utilisé pour la connexion temporaire dans laquelle la commande s’exécute Get-PSSession . Pour établir une connexion à un ordinateur distant, l’ordinateur distant doit être à l’écoute sur le port utilisé par la connexion. Les ports par défaut sont 5985, qui est le port WinRM pour HTTP, et 5986, qui est le port WinRM pour HTTPS.

Avant d'utiliser un autre port, vous devez configurer l'écouteur WinRM sur l'ordinateur distant pour qu'il écoute sur ce port. Pour configurer l’écouteur, tapez les deux commandes suivantes à l’invite PowerShell :

Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse

New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>

Ce paramètre est configuré sur la connexion temporaire créée pour exécuter une Get-PSSession commande avec le paramètre ComputerName ou ConnectionUri .

N'utilisez pas le paramètre Port à moins que vous n'y soyez obligé. Le port défini dans la commande s’applique à tous les ordinateurs ou sessions sur lesquels la commande s’exécute. Un autre paramètre de port peut empêcher la commande de s'exécuter sur tous les ordinateurs.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:	Int32
Position:	Named
Default value:	5985, 5986
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SessionOption

Spécifie les options avancées pour la session. Entrez un objet SessionOption , tel que celui que vous créez à l’aide de l’applet de commande New-PSSessionOption, ou une table de hachage dans laquelle les clés sont des noms d’options de session et les valeurs sont des valeurs d’option de session.

Les valeurs par défaut des options sont déterminées par la valeur de la variable de préférence PSSessionOption, si elle est définie. Sinon, les valeurs par défaut sont établies par les options définies dans la configuration de session.

Les valeurs des options de la session sont prioritaires sur les valeurs par défaut des sessions définies dans la variable de préférence $PSSessionOption et dans la configuration de session. Elles ne sont cependant pas prioritaires sur les valeurs maximales, les quotas ou les limites définis dans la configuration de session.

Pour obtenir une description des options de session, y compris les valeurs par défaut, consultez New-PSSessionOption. Pour plus d’informations sur la $PSSessionOption variable de préférence, consultez about_Preference_Variables. Pour plus d’informations sur les configurations de session, consultez about_Session_Configurations.

Type:	PSSessionOption
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-State

Spécifie un état de session. Cette applet de commande obtient uniquement les sessions dans l’état spécifié. Les valeurs acceptables pour ce paramètre sont : All, Opened, Disconnected, Closed et Broken. La valeur par défaut est All.

La valeur d'état de session dépend des sessions actives. Les sessions qui n'ont pas été créées dans les sessions actives et qui ne sont pas connectées à la session active ont l'état Disconnected même si elles sont connectées à une autre session.

L'état d'une session est stocké dans la propriété State de la session.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:	SessionFilterState
Accepted values:	All, Opened, Disconnected, Closed, Broken
Position:	Named
Default value:	All
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ThrottleLimit

Spécifie le nombre maximal de connexions simultanées qui peuvent être établies pour exécuter la Get-PSSession commande. Si vous omettez ce paramètre ou entrez la valeur 0 (zéro), la valeur par défaut 32 est utilisée. La limite d'accélération s'applique uniquement à la commande actuelle, et non à la session ou à l'ordinateur.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:	Int32
Position:	Named
Default value:	32
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSSL

Indique que cette applet de commande utilise le protocole SSL (Secure Sockets Layer) pour établir la connexion dans laquelle la commande s’exécute Get-PSSession . Par défaut, SSL n'est pas utilisé. Si vous utilisez ce paramètre, mais que SSL n'est pas disponible sur le port utilisé pour la commande, celle-ci échoue.

Ce paramètre configure la connexion temporaire créée pour exécuter une Get-PSSession commande avec le paramètre ComputerName .

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMId

Spécifie un tableau d’ID de machines virtuelles. Cette applet de commande démarre une session interactive avec chacune des machines virtuelles spécifiées. Pour afficher les machines virtuelles disponibles, utilisez la commande suivante :

Get-VM | Select-Object -Property Name, ID

Type:	Guid[]
Aliases:	VMGuid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

Spécifie un tableau de noms d'ordinateurs virtuels. Cette applet de commande démarre une session interactive avec chacune des machines virtuelles spécifiées. Pour afficher les machines virtuelles disponibles, utilisez l’applet de Get-VM commande .

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Entrées

None

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

PSSession

Notes

Cette applet de commande obtient des objets PSSession de sessions gérées par l’utilisateur », comme ceux créés à l’aide des applets de commande New-PSSession, Enter-PSSessionet Invoke-Command. Il n’obtient pas la session gérée par le système qui est créée lorsque vous démarrez PowerShell.
À compter de Windows PowerShell 3.0, les objets PSSession sont stockés sur l’ordinateur qui se trouve côté serveur ou reçoit la fin d’une connexion. Pour obtenir les sessions stockées sur l’ordinateur local ou un ordinateur distant, PowerShell établit une session temporaire sur l’ordinateur spécifié et exécute des commandes de requête dans la session.
Pour obtenir les sessions qui se connectent à un ordinateur distant, utilisez les paramètres ComputerName ou ConnectionUri pour spécifier l'ordinateur distant. Pour filtrer les sessions qui obtiennent Get-PSSession , utilisez les paramètres Name, ID, InstanceID et State . Utilisez les paramètres restants pour configurer la session temporaire qui Get-PSSession utilise.
Lorsque vous utilisez les paramètres ComputerName ou ConnectionUri, Get-PSSession obtient uniquement les sessions des ordinateurs exécutant Windows PowerShell 3.0 et versions ultérieures de PowerShell.
La valeur de la propriété State d’une session PSSession est relative à la session active. Par conséquent, la valeur Disconnected signifie que la session PSSession n’est pas connectée à la session active. Toutefois, cela ne signifie pas que la session PSSession est déconnectée de toutes les sessions. Elle peut être connectée à une autre session. Pour déterminer si vous pouvez vous connecter ou vous reconnecter à la session PSSession à partir de la session active, utilisez la propriété Availability .

Une propriété Availability avec la valeur None signifie que vous pouvez vous connecter à la session. La valeur Busy indique que vous ne pouvez pas vous connecter à psSession , car il est connecté à une autre session.

Pour plus d’informations sur les valeurs de la propriété State des sessions, consultez Énumération RunspaceState.

Pour plus d’informations sur les valeurs de la propriété Availability des sessions, consultez Énumération RunspaceAvailability.

Get-PSSession

Syntax

Description

Exemples

Exemple 1 : Obtenir des sessions créées dans la session active

Exemple 2 : Connecter des sessions à l’ordinateur local

Exemple 3 : Connecter des sessions à un ordinateur

Exemple 4 : Enregistrer les résultats de cette commande

Exemple 5 : Supprimer une session à l’aide d’un ID de instance

Exemple 6 : Obtenir une session portant un nom particulier

Exemple 7 : Obtenir une session à l’aide de son ID

Paramètres

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-ConnectionUri

-ContainerId

-Credential

-Id

-InstanceId

-Name

-Port

-SessionOption

-State

-ThrottleLimit

-UseSSL

-VMId

-VMName

Entrées

Sorties

Notes

Liens associés

Ressources supplémentaires