Compartilhar via


Remove-PSSnapin

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

Sintaxe

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

Descrição

O cmdlet Remove-PSSnapin remove um snap-in do Windows PowerShell da sessão atual. Você pode utilizá-lo para remover os snap-ins adicionados ao Windows PowerShell, mas não pode utilizá-lo para remover os snap-ins instalados com o Windows PowerShell.

Depois que um snap-in for removido da sessão atual, ele ainda estará carregado, mas os cmdlets e os provedores do snap-in não estarão mais disponíveis na sessão.

Parâmetros

-Name <string[]>

Especifica os nomes de snap-ins do Windows PowerShell a serem removidos da sessão atual. O nome de parâmetro ("Name") é opcional, e são permitidos caracteres curinga (*) no valor.

Necessário?

true

Posição?

1

Valor padrão

Nenhum

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

true

-PassThru

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

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.PSSnapInInfo

Você pode canalizar um objeto de snap-in para Remove-PSSnapin.

Saídas

Nenhum ou System.Management.Automation.PSSnapInInfo

Por padrão, Remove-PsSnapin não gera nenhuma saída. Entretanto, se você usar o parâmetro PassThru, ele gerará um objeto System.Management.Automation.PSSnapInInfo que representa o snap-in.

Observações

Você também pode fazer referência a Remove-PSSnapin usando seu alias interno, "rsnp". Para obter mais informações, consulte about_Aliases.

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

Remove-PSSnapin afeta somente a sessão atual. Se você tiver adicionado um comando Add-PSSnapin a seu perfil do Windows PowerShell, será necessário excluir o comando para remover o snap-in de sessões futuras. Para obter instruções, consulte about_Profiles.

Exemplo 1

C:\PS>remove-pssnapin -name Microsoft.Exchange

Descrição
-----------
Esse comando remove o snap-in Microsoft.Exchange da sessão atual. Quando o comando for concluído, os cmdlets e provedores aos quais o snap-in oferecia suporte não estarão disponíveis na sessão.





Exemplo 2

C:\PS>get-PSSnapIn smp* | remove-PSSnapIn

Descrição
-----------
Esse comando remove os snap-ins do Windows PowerShell cujos nomes começam com "smp" da sessão atual.

O comando utiliza o cmdlet Get-PSSnapin para obter objetos que representam os snap-ins. O operador de pipeline (|) envia os resultados para o cmdlet Remove-PSSnapin, o qual os remove da sessão. Os provedores e cmdlets para os quais esse snap-in fornece suporte 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 tenham uma propriedade Name.





Exemplo 3

C:\PS>remove-pssnapin -name *event*

Descrição
-----------
Esse comando remove todos os snap-ins do Windows PowerShell cujos nomes incluem "event". O comando especifica o nome de parâmetro "Name", mas o nome de parâmetro pode ser omitido, pois é opcional.





Consulte também

Conceitos

Add-PSSnapin
Get-PSSnapin
about_Profiles