Share via

Remove-PSSnapin

  • Referência
Módulo:
Microsoft.PowerShell.Core

Remove snap-ins do Windows PowerShell da sessão atual.

Syntax

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

Description

O Remove-PSSnapin cmdlet remove um snap-in do Windows PowerShell da sessão atual. Você pode usá-lo para remover snap-ins adicionados ao Windows PowerShell Não é possível usar esse cmdlet para remover os snap-ins instalados com o Windows PowerShell.

Depois de remover um snap-in da sessão atual, o snap-in ainda é carregado, mas os cmdlets e provedores no snap-in não estão mais disponíveis na sessão.

Exemplos

Exemplo 1: Remover um snap-in

Remove-PSSnapin -Name Microsoft.Exchange

Este comando remove o snap-in Microsoft.Exchange da sessão atual. Quando o comando estiver concluído, os cmdlets e provedores suportados pelo snap-in não estarão disponíveis na sessão.

Exemplo 2: Remover snap-ins usando nomes com o pipeline

Get-PSSnapIn smp* | Remove-PSSnapIn

Este comando remove os snap-ins do Windows PowerShell com nomes que começam com smp da sessão atual.

O comando usa o Get-PSSnapin cmdlet para obter objetos que representam os snap-ins. O operador de pipeline (|) envia os resultados para o Remove-PSSnapin cmdlet, que os remove da sessão. Os provedores e cmdlets suportados por esse snap-in não estão mais disponíveis na sessão.

Quando você canaliza objetos para Remove-PSSnapin, os nomes dos objetos são associados ao parâmetro Name , que aceita objetos do pipeline que têm uma propriedade Name .

Exemplo 3: Remover snap-ins usando nomes

Remove-PSSnapin -Name *event*

Este comando remove todos os snap-ins do Windows PowerShell com nomes que incluem eventos.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-Name

Especifica os nomes dos snap-ins do Windows PowerShell a serem removidos da sessão atual. Caracteres curinga (*) são permitidos.

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

-PassThru

Retorna um objeto que representa o snap-in. Por padrão, esse cmdlet não gera nenhuma saída.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Entradas

PSSnapInInfo

Você pode canalizar um objeto de snap-in para este cmdlet.

Saídas

None, System.Management.Automation.PSSnapInInfo

Este cmdlet gera um objeto System.Management.Automation.PSSnapInInfo que representa o snap-in, se você especificar o parâmetro PassThru . Por padrão, Remove-PSSnapin não gera nenhuma saída.

Notas

O Windows PowerShell inclui os seguintes aliases para Remove-PSSnapin:

  • rsnp

Remove-PSSnapin não verifica a versão do Windows PowerShell antes de remover um snap-in da sessão. Se um snap-in não puder ser removido, um aviso será exibido e o comando falhará.

Remove-PSSnapin afeta apenas a sessão atual. Se você adicionou um Add-PSSnapin comando ao seu perfil do Windows PowerShell, exclua o comando para remover o snap-in de sessões futuras. Para obter instruções, digite Get-Help about_Profiles.