Compartir a través de

Remove-PSSnapin

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Quita los complementos de Windows PowerShell de la sesión actual.

Sintaxis

Remove-PSSnapin
      [-Name] <String[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El Remove-PSSnapin cmdlet 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. Cuando el comando finalice, los cmdlets y proveedores que dicho complemento admite no estará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 Get-PSSnapin cmdlet para obtener objetos que representan los complementos. El operador de canalización (|) envía los resultados al Remove-PSSnapin cmdlet , que los quita de la sesión. Los proveedores y cmdlets que este complemento admite dejarán de estar 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 solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 (*).

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto que representa el complemento. De forma predeterminada, este cmdlet no genera ningún resultado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

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 un complemento no se puede quitar, aparece una advertencia y se produce un error en el comando.

Remove-PSSnapin afecta solo a la sesión actual. Si ha agregado un Add-PSSnapin comando al perfil de Windows PowerShell, debe eliminar el comando para quitar el complemento de futuras sesiones. Para obtener instrucciones, escriba Get-Help about_Profiles.