Cierra una o más sesiones de Windows PowerShell (PSSessions).
Sintaxis
Remove-PSSession [[-ComputerName] <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>] Remove-PSSession [-Id] <Int32[]> [-Confirm] [-WhatIf] [<CommonParameters>] Remove-PSSession [-InstanceId <Guid[]>] [-Confirm] [-WhatIf] [<CommonParameters>] Remove-PSSession [-Name <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>] Remove-PSSession [-Session] <PSSession[]> [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Remove-PSSession cierra las sesiones de Windows PowerShell (PSSessions) de la sesión actual. Detiene los comandos que se están ejecutando en la PSSession, finaliza la PSSession y libera los recursos que la PSSession estaba utilizando. Si la PSSession está conectada a un equipo remoto, Remove-PSSession también cierra la conexión entre los equipos local y remoto.
Para quitar una PSSession, debe escribirse el parámetro Name, ComputerName, ID o InstanceID de la sesión.
Si ha guardado la PSSession en una variable, el objeto de sesión permanece en la variable, pero el estado de la PSSession es "Closed" (cerrado).
Parámetros
-ComputerName <string[]>
Cierra las PSSessions que están conectadas a los equipos especificados. Se permite el uso de caracteres comodín.
Se debe escribir el nombre NetBIOS, la dirección IP o el nombre de dominio completo de uno o varios equipos remotos. 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[]>
Cierra las PSSessions con los identificadores especificados. Escriba uno o más identificadores (separados por comas) o use 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 |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-InstanceId <Guid[]>
Cierra las PSSessions con los identificadores de instancia especificados.
El identificador de instancia es un GUID que identifica de forma única una PSSession en la sesión actual. InstanceID es único, aunque se estén ejecutando varias sesiones en un solo equipo.
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? |
false |
-Name <string[]>
Cierra las PSSessions con los nombres simples especificados. Se permite el uso de caracteres comodín.
Dado que el nombre simple de una PSSession podría no ser único, al utilizar el parámetro Name, considere también la posibilidad de utilizar el parámetro WhatIf o Confirm en el comando Remove-PSSession.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
true |
-Session <PSSession[]>
Especifica los objetos de sesión de las PSSessions que se han de cerrar. Escriba una variable que contenga las PSSessions o un comando que las cree u obtenga, como un comando New-PSSession o Get-PSSession. También se pueden canalizar uno o más objetos de sesión a Remove-PSSession.
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si se ejecutara el comando, sin ejecutarlo realmente.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<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 |
System.Management.Automation.Runspaces.PSSession Se puede canalizar un objeto de sesión a Remove-PSSession. |
Salidas |
Ninguno Remove-PSSession no devuelve ningún objeto. |
Notas
El parámetro ID es obligatorio. No se puede escribir "remove-pssession" sin parámetros. Para eliminar todas las PSSessions de la sesión actual, escriba "Get-PSSession | remove-pssession".
Una PSSession utiliza una conexión persistente con un equipo remoto. Cree una PSSession para ejecutar una serie de comandos que comparten datos. Para obtener más información, vea about_PSSessions.
Las PSSessions son específicas de la sesión actual. Al finalizar una sesión, se cierran forzosamente las PSSessions creadas en esa sesión.
Ejemplo 1
C:\PS>remove-pssession -id 1, 2 Descripción ----------- Este comando quita las PSSessions cuyo identificador es 1 y 2.
Ejemplo 2
C:\PS>get-pssession | remove-pssession C:\PS> remove-pssession -session (get-pssession) C:\PS> $s = get-pssession C:\PS> remove-pssession -session $s". Descripción ----------- Estos comandos quitan todas las PSSessions de la sesión actual. Aunque los tres formatos de comando son diferentes, tienen el mismo efecto.
Ejemplo 3
C:\PS>$r = get-pssession -computername Serv* $r | remove-pssession Descripción ----------- Estos comandos cierran las PSSessions que están conectadas a equipos que tienen nombres que empiezan por "Serv".
Ejemplo 4
C:\PS>get-pssession | where {$_.port -eq 90} | remove-pssession Descripción ----------- Este comando cierra las PSSessions que están conectadas al puerto 90. Se puede utilizar este formato de comando para identificar PSSessions por propiedades distintas de ComputerName, Name, InstanceID e ID.
Ejemplo 5
C:\PS>get-pssession | ft computername, instanceID -auto ComputerName InstanceId ------------ ---------------- Server01 875d231b-2788-4f36-9f67-2e50d63bb82a localhost c065ffa0-02c4-406e-84a3-dacb0d677868 Server02 4699cdbc-61d5-4e0d-b916-84f82ebede1f Server03 4e5a3245-4c63-43e4-88d0-a7798bfc2414 TX-TEST-01 fc4e9dfa-f246-452d-9fa3-1adbdd64ae85 C:\PS> remove-pssession -InstanceID fc4e9dfa-f246-452d-9fa3-1adbdd64ae85 Descripción ----------- Estos comandos muestran la forma de cerrar una PSSession basándose en su identificador de instancia (RemoteRunspaceID). El primer comando utiliza el cmdlet Get-PSsession para obtener las PSSessions en la sesión actual. Utiliza un operador de canalización (|) para enviar las PSSessions al cmdlet Format-Table (alias: ft), que aplica formato a sus propiedades ComputerName e InstanceID en una tabla. El parámetro AutoSize ("auto") comprime las columnas para la presentación. En la presentación resultante, el administrador puede identificar la PSSession que se ha de cerrar, así como copiar y pegar el parámetro InstanceID de esa PSSession en el segundo comando. El segundo comando usa el cmdlet Remove-PSSession para quitar la PSSession con el identificador de instancia especificado.
Ejemplo 6
C:\PS>function EndPSS { get-pssession | remove-pssession } Descripción ----------- Esta función elimina todas las PSSessions en la sesión actual. Después de agregar esta función al perfil de Windows PowerShell, para eliminar todas las sesiones basta con escribir "endpss".
Vea también