Obtiene las sesiones de Windows PowerShell (PSSessions) en la sesión actual.

Sintaxis

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

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

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

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

Descripción

El cmdlet Get-PSSession obtiene las sesiones de Windows PowerShell (PSSessions) que se crearon en la sesión actual.

Sin parámetros, Get-PSSession obtiene todas las PSSessions creadas en la sesión actual. Se pueden utilizar los parámetros de Get-PSSession para obtener las sesiones que están conectadas a equipos concretos, o bien identificar las sesiones por sus nombres, identificadores o identificadores de instancia.

Para obtener más información sobre sesiones de Windows PowerShell, vea about_PSSessions.

Parámetros

-ComputerName <string[]>

Obtiene solamente las PSSessions que están conectadas a los equipos especificados. Se permite el uso de caracteres comodín.

Escriba el nombre NetBIOS, la dirección IP o el nombre de dominio completo de uno o varios equipos. Para especificar el equipo local, escriba el nombre del equipo, "localhost", o bien, un punto (.).

¿Requerido?

false

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

true

-Id <Int32[]>

Obtiene solamente las PSSessions con los identificadores especificados. Pueden escribirse uno o más identificadores (separados por comas) o bien usar el operador de intervalo (..) para especificar un intervalo de identificadores.

Un identificador es un entero que identifica de forma única la PSSession en la sesión actual. Es más fácil de recordar y escribir que InstanceId, pero es único solamente en la sesión actual. Para buscar el identificador de una PSSession, se utiliza Get-PSSession sin parámetros.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

All sessions in the shell

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

false

-InstanceId <Guid[]>

Obtiene únicamente las PSSessions con los identificadores de instancia especificados.

El identificador de instancia es un GUID que identifica de forma única una PSSession en un equipo local o remoto. InstanceID es único, aunque se estén ejecutando varias sesiones en Windows PowerShell.

InstanceID se almacena en la propiedad InstanceID del objeto que representa una PSSession. Para buscar el valor de InstanceID de las PSSessions de la sesión actual, escriba "get-pssession | Format-Table Name, ComputerName, InstanceId".

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

true

-Name <string[]>

Obtiene únicamente las PSSessions con los nombres simples especificados. Se permite el uso de caracteres comodín.

Para buscar los nombres de las PSSessions de la sesión actual, escriba "get-pssession" sin parámetros.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

true

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

Ninguno

No se pueden canalizar entradas a este cmdlet.

Salidas

System.Management.Automation.Runspaces.PSSession

Get-PSSession devuelve un objeto PSSession para cada PSSession que obtiene.

Notas

Get-PSSession obtiene las PSSessions que se crearon en la sesión actual. No obtiene la sesión creada al abrir Windows PowerShell y tampoco obtiene las PSSessions que se crearon en otras sesiones o en otros equipos, aunque estén conectadas al equipo local.

Ejemplo 1

C:\PS>get-pssession

Descripción
-----------
Este comando obtiene todas las PSSessions que se crearon en la sesión actual. 

No obtiene las PSSessions que se crearon en otras sesiones o en otros equipos, aunque estén conectadas a este equipo.






Ejemplo 2

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

Descripción
-----------
Este comando obtiene las PSSessions que están conectadas al equipo Server02 y las guarda en la variable $.






Ejemplo 3

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

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

Descripción
-----------
En este ejemplo se muestra la forma de guardar los resultados de un comando Get-PSSession en varias variables. 

El primer comando utiliza el cmdlet New-PSSession para crear PSSessions en tres equipos remotos.

El segundo comando usa un cmdlet Get-PSSession para obtener las tres PSSessions. A continuación, guarda cada una de las PSSessions en una variable independiente.

Cuando Windows PowerShell asigna una matriz de objetos a una matriz de variables, asigna el primer objeto a la primera variable, el segundo objeto a la segunda variable, etc. Si hay más objetos que variables, asigna todos los objetos restantes a la última variable de la matriz. Si hay más variables que objetos, no se utilizan las variables adicionales.






Ejemplo 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

Descripción
-----------
En este ejemplo se muestra la forma de obtener una PSSession utilizando su identificador de instancia y eliminar a continuación la PSSession.

El primer comando obtiene todas las PSSessions en el equipo local. Envía las PSSessions al cmdlet Format-Table, que muestra las propiedades ComputerName e InstanceID de cada PSSession.

El segundo comando usa el cmdlet Get-PSSession para obtener una PSSession concreta y guardarla en la variable $s. El comando utiliza el parámetro InstanceID para identificar la PSSession.

El tercer comando usa el cmdlet Remove-PSSession para eliminar la PSSession en la variable $s.






Ejemplo 5

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

Descripción
-----------
Este comando obtiene todas las PSSessions que se conectan a equipos cuyos nombres comienzan por "Serv".






Ejemplo 6

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

Descripción
-----------
Este comando obtiene PSSessions que tienen nombres que comienzan con "Comprobación" o "Ux".






Ejemplo 7

C:\PS>get-pssession 2

Descripción
-----------
Este comando obtiene la PSSession cuyo identificador es 2.






Vea también




Tabla de contenido