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.