Quita complementos de Windows PowerShell de la sesión actual.
Sintaxis
Remove-PSSnapin [-Name] <string[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Remove-PSSnapin quita un complemento de Windows PowerShell de la sesión actual. Puede usarlo para quitar complementos que haya agregado a Windows PowerShell, pero no para quitar los complementos que se instalan con Windows PowerShell.
Una vez quitado un complemento de la sesión actual, permanece cargado, pero los cmdlets y proveedores del complemento dejan de estar disponibles en la sesión.
Parámetros
-Name <string[]>
Especifica los nombres de complementos de Windows PowerShell que se han de quitar de la sesión actual. El nombre de parámetro ("Name") es opcional y se permiten caracteres comodín (*) en el valor.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
ninguno |
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
true |
-PassThru
Devuelve un objeto que representa el complemento. De forma predeterminada, este cmdlet no genera resultados.
|
¿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 |
System.Management.Automation.PSSnapInInfo Se puede canalizar un objeto de complemento a Remove-PSSnapin. |
|
Salidas |
Ninguno o System.Management.Automation.PSSnapInInfo De forma predeterminada, Remove-PsSnapin no genera resultados. Sin embargo, si se utiliza el parámetro PassThru, genera un objeto System.Management.Automation.PSSnapInInfo que representa el complemento. |
Notas
También se puede hacer referencia a Remove-PSSnapin mediante su alias integrado, "rsnp". Para obtener más información, vea about_Aliases.
Remove-PSSnapin no comprueba la versión de Windows PowerShell antes de quitar un complemento de la sesión. Si no se puede quitar un complemento, aparecerá una advertencia y se producirá un error al ejecutar el comando.
Remove-PSSnapin afecta solamente a la sesión actual. Si ha agregado un comando Add-PSSnapin al perfil de Windows PowerShell, debe eliminar el comando para quitar el complemento de sesiones futuras. Para obtener instrucciones, vea about_Profiles.
Ejemplo 1
C:\PS>remove-pssnapin -name Microsoft.Exchange Descripción ----------- Este comando quita el complemento Microsoft.Exchange de la sesión actual. Cuando el comando se completa, los cmdlets y proveedores que el complemento admitía no estarán disponibles en la sesión.
Ejemplo 2
C:\PS>get-PSSnapIn smp* | remove-PSSnapIn Descripción ----------- Este comando quita de la sesión actual los complementos de Windows PowerShell cuyos nombres empiezan por "smp". El comando usa el cmdlet Get-PSSnapin para obtener los objetos que representan los complementos. El operador de canalización (|) envía los resultados al cmdlet Remove-PSSnapin, que los quita de la sesión. Los proveedores y cmdlets que este complemento admite dejan de estar disponibles en la sesión. Cuando se canalizan objetos a Remove-PSSnapin, los nombres de los objetos se asocian al parámetro Name, que acepta los objetos de la canalización que tengan una propiedad Name.
Ejemplo 3
C:\PS>remove-pssnapin -name *event* Descripción ----------- Este comando quita todos los complementos de Windows PowerShell que tienen nombres que incluyen "event". Este comando especifica el nombre de parámetro "Name", pero el nombre de parámetro se puede omitir porque es opcional.
Vea también