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