Elimina del equipo una configuración de sesión registrada.

Sintaxis

Unregister-PSSessionConfiguration [-Name] <string> [-Force] [-NoServiceRestart] [-Confirm] [-WhatIf] [<CommonParameters>]

Descripción

El cmdlet Unregister-PSSessionConfiguration elimina del equipo una configuración de sesión registrada. Es un cmdlet avanzado diseñado para que lo utilicen los administradores de sistemas a fin de administrar configuraciones de sesión personalizadas para sus usuarios.

Si se eliminan las configuraciones de sesión predeterminadas Microsoft.PowerShell o Microsoft.PowerShell32 accidentalmente, se debe utilizar el cmdlet Enable-PSRemoting para restaurarlas.

Parámetros

-Force

Elimina todas las confirmaciones de usuario y reinicia el servicio WinRM sin pedir confirmación. Al reiniciar el equipo surte efecto el cambio de configuración.

Para evitar un reinicio y suprimir la confirmación de reinicio, utilice el parámetro NoServiceRestart.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Name <string>

Especifica los nombres de las configuraciones de sesión que se van a eliminar. Escriba uno o varios nombres de configuración. Se permite el uso de caracteres comodín. Este parámetro es obligatorio.

También se puede canalizar un objeto de configuración de sesión a Unregister-PSSessionConfiguration.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

false

-NoServiceRestart

No reinicia el servicio WinRM y suprime la confirmación para reiniciar el servicio.

De forma predeterminada, al escribir un comando Unregister-PSSessionConfiguration, se solicita al usuario que reinicie el servicio WinRM para que el cambio surta efecto. Hasta que se reinicie el servicio WinRM, los usuarios podrán utilizar igualmente la configuración de sesión no registrada, si bien Get-PSSessionConfiguration no la encontrará.

Para reiniciar el servicio WinRM sin pedir confirmación, utilice el parámetro Force. Para reiniciar el servicio WinRM manualmente, utilice el cmdlet Restart-Service.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿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

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration

Se puede canalizar un objeto de configuración de sesión de Get-PSSessionConfiguration a Unregister-PSSessionConfiguration.

Salidas

Ninguno

Este cmdlet no devuelve objetos.

Notas

Para ejecutar este cmdlet en Windows Vista, Windows Server 2008 y versiones posteriores de Windows, se debe iniciar Windows PowerShell con la opción "Ejecutar como administrador".

Ejemplo 1

C:\PS>unregister-pssessionconfiguration -name MaintenanceShell

Descripción
-----------
Este comando elimina del equipo la configuración de sesión MaintenanceShell.






Ejemplo 2

C:\PS>unregister-pssessionconfiguration -maintenanceShell -force

Descripción
-----------
Este comando elimina del equipo la configuración de sesión MaintenanceShell. El comando utiliza el parámetro Force para suprimir todos los mensajes de usuario y reiniciar el servicio WinRM sin pedir confirmación.






Ejemplo 3

C:\PS>unregister-pssessionconfiguration -name *

C:\PS> get-pssessionconfiguration -name * | unregister-pssessionconfiguration

Descripción
-----------
Estos comandos eliminan del equipo todas las configuraciones de sesión. Los comandos tienen el mismo efecto y se pueden intercambiar.






Ejemplo 4

C:\PS>unregister-pssessionconfiguration -name maintenanceShell -noServiceRestart

C:\PS> get-pssessionconfiguration -name maintenanceShell

Get-PSSessionConfiguration -name maintenanceShell : No Session Configuration matches criteria "maintenanceShell".
    + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

C:\PS> new-pssession -configurationName MaintenanceShell

 Id Name      ComputerName    State    Configuration         Availability
 -- ----      ------------    -----    -------------         ------------
  1 Session1  localhost       Opened   MaintenanceShell      Available

C:\PS> restart-service winrm

C:\PS> new-pssession -configurationName MaintenanceShell
[localhost] Connecting to remote server failed with the following error message : The WS-Management service cannot process the request. The resource
URI (https://schemas.microsoft.com/powershell/MaintenanceShell) was not found in the WS-Management catalog. The catalog contains the metadata that describes resour
ces, or logical endpoints. For more information, see the about_Remote_Troubleshooting Help topic.
    + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
    + FullyQualifiedErrorId : PSSessionOpenFailed

Descripción
-----------
En este ejemplo se muestra el efecto de utilizar el parámetro NoServiceRestart de Unregister-PSSessionConfiguration. Este parámetro se ha diseñado para evitar un reinicio del servicio, que interrumpiría las sesiones del equipo.

El primer comando utiliza el cmdlet Unregister-PSSessionConfiguration para eliminar la configuración de sesión MaintenanceShell. Sin embargo, como el comando utiliza el parámetro NoServiceRestart, el servicio WinRM no se reinicia y el cambio no surte efecto plenamente.

El segundo comando utiliza el cmdlet Get-PSSessionConfiguration para obtener la sesión MaintenanceShell. Dado que la sesión se ha quitado de la tabla de recursos de WS-Management, Get-PSSession no puede devolverla.

El tercer comando utiliza el cmdlet New-PSSession para crear una sesión en el equipo local que utiliza la configuración MaintenanceShell. El comando se ejecuta correctamente.

El cuarto comando utiliza el cmdlet Restart-Service para reiniciar el servicio WinRM. 

El quinto comando utiliza de nuevo el cmdlet New-PSSession para crear una sesión que utiliza la configuración MaintenanceShell. Esta vez, se produce un error en la sesión porque la configuración MaintenanceShell se ha eliminado.






Vea también




Tabla de contenido