Remove-PSSnapin
Quita los complementos de Windows PowerShell de la sesión actual.
Sintaxis
Default (valor predeterminado)
Remove-PSSnapin
[-Name] <String[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Remove-PSSnapin quita un complemento de Windows PowerShell de la sesión actual. Puede usarlo para quitar complementos que ha agregado a Windows PowerShell No puede usar este cmdlet para quitar los complementos instalados con Windows PowerShell.
Después de quitar un complemento de la sesión actual, el complemento todavía se carga, pero los cmdlets y proveedores del complemento ya no están disponibles en la sesión.
Ejemplos
Ejemplo 1: Quitar un complemento
Remove-PSSnapin -Name Microsoft.Exchange
Este comando quita el complemento Microsoft.Exchange de la sesión actual. Una vez completado el comando, los cmdlets y proveedores admitidos por el complemento no están disponibles en la sesión.
Ejemplo 2: Quitar complementos mediante nombres con la canalización
Get-PSSnapin smp* | Remove-PSSnapin
Este comando quita los complementos de Windows PowerShell que tienen nombres que comienzan por smp de la sesión actual.
El comando usa el cmdlet Get-PSSnapin para obtener 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 admite este complemento ya no están disponibles en la sesión.
Al canalizar objetos a Remove-PSSnapin, los nombres de los objetos están asociados al parámetro Name, que acepta objetos de la canalización que tienen una propiedad Name.
Ejemplo 3: Quitar complementos mediante nombres
Remove-PSSnapin -Name *event*
Este comando quita todos los complementos de Windows PowerShell que tienen nombres que incluyen eventos.
Parámetros
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Especifica los nombres de los complementos de Windows PowerShell que se van a quitar de la sesión actual.
Se permiten caracteres comodín (*).
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-PassThru
Devuelve un objeto que representa el complemento. De forma predeterminada, este cmdlet no genera ninguna salida.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
PSSnapInInfo
Puede canalizar un objeto de complemento a este cmdlet.
Salidas
None, System.Management.Automation.PSSnapInInfo
Este cmdlet genera un objeto System.Management.Automation.PSSnapInInfo que representa el complemento, si especifica el parámetro PassThru. De forma predeterminada, Remove-PSSnapin no genera ninguna salida.
Notas
Windows PowerShell incluye los siguientes alias para Remove-PSSnapin:
rsnp
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, aparece una advertencia y se produce un error en el comando.
Remove-PSSnapin afecta solo 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 futuras sesiones. Para obtener instrucciones, escriba Get-Help about_Profiles.
