Share via

Remove-PSSnapin

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

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

Esse comando remove o snap-in Microsoft.Exchange da sessão atual. Quando o comando for 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

Esse comando remove os snap-ins do Windows PowerShell que têm 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 que esse snap-in suporta 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*

Esse comando remove todos os snap-ins do Windows PowerShell que têm nomes que incluem evento.

Parâmetros

-Confirm

Solicita 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 remover 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, este cmdlet não gera saída.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. 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 esse cmdlet.

Saídas

None, System.Management.Automation.PSSnapInInfo

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

Observações

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 pode ser removido, um aviso é exibido e o comando falha.

Remove-PSSnapin afeta apenas a sessão atual. Se você tiver adicionado 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.