Remove-PSSnapin

  • Referencia
Módulo:
Microsoft.PowerShell.Core

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

Syntax

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 (*).

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.