Partilhar via

Remove-PSSnapin

Módulo:
Microsoft.PowerShell.Core Module

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

Sintaxe

Default (Predefinição) 

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 é 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

PS C:\> 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

PS C:\> 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 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 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

PS C:\> Remove-PSSnapin -Name *event*

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

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-PassThru

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 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

  • 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 comando Add-PSSnapin 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.