Remove-PSSnapin
Remove snap-ins do Windows PowerShell da sessão atual.
Sintaxe
Default (Default)
Remove-PSSnapin
[-Name] <String[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Remove-PSSnapin 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 será carregado, mas os cmdlets e provedores no snap-in não estarã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 com suporte do 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 cmdlet Get-PSSnapin para obter objetos que representam os snap-ins. O operador de pipeline (|) envia os resultados para o cmdlet Remove-PSSnapin, que os remove da sessão. Os provedores e cmdlets compatíveis com esse snap-in não estão mais disponíveis na sessão.
Quando você redireciona 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Especifica os nomes dos snap-ins do Windows PowerShell a serem removidos da sessão atual.
Caracteres curinga (*) são permitidos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-PassThru
Retorna um objeto que representa o snap-in. Por padrão, esse cmdlet não gera nenhuma saída.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
PSSnapInInfo
Você pode canalizar um objeto snap-in para este 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 puder ser removido, um aviso será exibido e o comando falhará.
Remove-PSSnapin afeta apenas a sessão atual. Se você tiver adicionado um comando Add-PSSnapin ao seu perfil do Windows PowerShell, deverá excluir o comando para remover o snap-in de sessões futuras. Para obter instruções, digite Get-Help about_Profiles.
