Get-PSSession

Obtient les sessions PowerShell sur les ordinateurs locaux et distants.

Syntaxe

Get-PSSession
   [-Name <String[]>]
   [<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
   [-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
   [-ConnectionUri] <Uri[]>
   [-ConfigurationName <String>]
   [-AllowRedirection]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-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
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-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>]
   [-Name <String[]>]
   [-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 à la fin distante de chaque connexion. Vous pouvez utiliser les paramètres ComputerName ou ConnectionUri pour Get-PSSession 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 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 qui Get-PSSession retournent.

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 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 créées dans la session active. Il 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 : Obtenir des sessions connectées à l’ordinateur local

Get-PSSession -ComputerName "localhost"

Cette commande obtient les sessions PSSession 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 : Obtenir des sessions connectées à 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 indique que deux des sessions ont un Disconnected état et une Busy disponibilité. Elles ont été créées dans différentes sessions et sont en cours d'utilisation. La ScheduledJobs session, qui est Opened et Available, 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 d’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 d’instance, puis 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 Format-Table de commande, qui affiche les propriétés ComputerName et InstanceID de chaque session 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 qui ont des noms qui commencent BackupJob par et utilisent la configuration de sessionITTasks. 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 de OperationTimeout sur 240000 millisecondes (4 minutes). Ce paramètre donne plus de temps à la commande. Les paramètres ConfigurationName et SessionOption sont utilisés pour configurer les sessions temporaires dans lesquelles l’applet Get-PSSession de commande s’exécute sur chaque ordinateur. La sortie indique que la commande retourne la BackupJob04 session. La session est déconnectée et la disponibilité indique Nonequ’elle n’est pas utilisée.

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

La troisième commande obtient la session dans la $s variable. La sortie indique que la Connect-PSSession commande a réussi. La session est dans l’état Ouvert et est disponible pour une utilisation.

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
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 : http://localhost:5985/WSMAN. Le nom de l’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
Valeur par défaut:All sessions
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Authentication

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

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
  • Basic
  • 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 à authentifier, 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
Valeurs acceptées:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Valeur par défaut:Default
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CertificateThumbprint

Spécifie le certificat de clé publique numérique (X509) d’un compte d’utilisateur autorisé à créer la session dans laquelle la Get-PSSession commande s’exécute. 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 ou Get-ChildItem une Get-Item commande dans le lecteur PowerShellCert:.

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 à la fin 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, localhostou 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[]
Alias:Cn
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 prédéfini : http://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
Valeur par défaut:All sessions
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ConnectionUri

Spécifie un URI qui définit le point de terminaison de connexion pour la session temporaire dans laquelle la Get-PSSession commande s’exécute. 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 http://localhost:5985/WSMAN.

Si vous ne spécifiez pas 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 de transport, mais que vous ne spécifiez pas de port, la session est créée avec des ports standards : 80 pour HTTP et 443 pour HTTPS. Pour utiliser les ports par défaut pour la communication à distance PowerShell, spécifiez le port 5985 http ou 5986 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 d’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[]
Alias:URI, CU
Position:0
Valeur par défaut:Http://localhost:5985/WSMAN
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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écutez une Get-PSSession commande. La valeur par défaut est l’utilisateur actuel.

Tapez un nom d’utilisateur, tel que User01 ou Domain01\User01, ou entrez un objet PSCredential généré par l’applet Get-Credential de 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.

Remarque

Pour plus d’informations sur la protection des données SecureString , consultez Comment secure is SecureString ?.

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
Valeur par défaut:Current user
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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’Id d’instance, mais il est unique uniquement dans la session active. L’ID d’une session est stocké dans la propriété ID de la session.

Type:Int32[]
Position:0
Valeur par défaut:All sessions
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InstanceId

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

L'ID d'instance est un GUID qui identifie une session sur un ordinateur local ou distant. L’ID d’instance est unique, même lorsque vous avez plusieurs sessions en cours d’exécution dans PowerShell.

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

Type:Guid[]
Position:Named
Valeur par défaut:All sessions
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:All sessions
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Port

Spécifie le port réseau spécifié utilisé pour la connexion temporaire dans laquelle la Get-PSSession commande s’exécute. 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 , sauf si vous devez. 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
Valeur par défaut:5985, 5986
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SessionOption

Spécifie les options avancées de la session. Entrez un objet SessionOption , tel qu’un objet que vous créez à l’aide de l’applet New-PSSessionOption de commande, 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 $PSSessionOption variable de préférence, 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 d’option de session sont prioritaires sur les valeurs par défaut pour les sessions définies dans la $PSSessionOption variable de préférence 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-State

Spécifie un état de session. Cette applet de commande obtient uniquement les sessions à l’état spécifié. Les valeurs acceptables pour ce paramètre sont les suivantes : All, , OpenedDisconnected, 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 actuelles et qui ne sont pas connectées à la session active ont un état même Disconnected lorsqu’elles sont connectées à une autre session.

L’état d’une session est stocké dans la propriété État de la session.

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

Type:SessionFilterState
Valeurs acceptées:All, Opened, Disconnected, Closed, Broken
Position:Named
Valeur par défaut:All
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 une valeur de 0 (zéro), la valeur par défaut, 32est 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
Valeur par défaut:32
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UseSSL

Indique que cette applet de commande utilise le protocole SSL (Secure Sockets Layer) pour établir la connexion dans laquelle la Get-PSSession commande s’exécute. 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
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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[]
Alias:VMGuid
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

PSSession

Notes

PowerShell inclut les alias suivants pour Get-PSSession:

  • Toutes les plateformes :

    • gsn
  • Cette applet de commande obtient des objets PSSession gérés par l’utilisateur, tels que ceux créés à l’aide des applets de commande et Enter-PSSessionInvoke-Command des New-PSSessionapplets de commande. 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 recevant 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 des 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 Get-PSSession obtiennent, 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 des 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, une valeur de 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 à psSession à partir de la session active, utilisez la propriété Availability.

Une valeur de disponibilité de None indique que vous pouvez vous connecter à la session. La valeur Busy indique que vous ne pouvez pas vous connecter à la session PSSession , car elle est connectée à une autre session.

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

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