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 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

PS C:\> 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

PS C:\> 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 de , que acepta objetos de la canalización que tienen una propiedad name name.

Ejemplo 3: Quitar complementos mediante nombres

PS C:\> 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.

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 ninguna salida.

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 el cmdlet se ejecuta. 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

  • 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 solo afecta 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.