Condividi tramite

Remove-PSSnapin

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Rimuove gli snap-in di Windows PowerShell dalla sessione corrente.

Sintassi

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

Descrizione

Il cmdlet Remove-PSSnapin rimuove uno snap-in di Windows PowerShell dalla sessione corrente. È possibile usarlo per rimuovere gli snap-in aggiunti a Windows PowerShell Non è possibile usare questo cmdlet per rimuovere gli snap-in installati con Windows PowerShell.

Dopo aver rimosso uno snap-in dalla sessione corrente, lo snap-in viene ancora caricato, ma i cmdlet e i provider nello snap-in non sono più disponibili nella sessione.

Esempio

Esempio 1: Rimuovere uno snap-in

Remove-PSSnapin -Name Microsoft.Exchange

Questo comando rimuove lo snap-in Microsoft.Exchange dalla sessione corrente. Al termine del comando, i cmdlet e i provider supportati dallo snap-in non sono disponibili nella sessione.

Esempio 2: Rimuovere snap-in usando nomi con la pipeline

Get-PSSnapin smp* | Remove-PSSnapin

Questo comando rimuove gli snap-in di Windows PowerShell con nomi che iniziano con smp dalla sessione corrente.

Il comando usa il cmdlet Get-PSSnapin per ottenere oggetti che rappresentano gli snap-in. L'operatore pipeline (|) invia i risultati al cmdlet Remove-PSSnapin, che li rimuove dalla sessione. I provider e i cmdlet supportati da questo snap-in non sono più disponibili nella sessione.

Quando si invia tramite pipe gli oggetti a Remove-PSSnapin, i nomi degli oggetti vengono associati al parametro Name, che accetta oggetti dalla pipeline con una proprietà name .

Esempio 3: Rimuovere snap-in usando nomi

Remove-PSSnapin -Name *event*

Questo comando rimuove tutti gli snap-in di Windows PowerShell con nomi che includono l'evento.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica i nomi degli snap-in di Windows PowerShell da rimuovere dalla sessione corrente. Sono consentiti caratteri jolly (*).

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Restituisce un oggetto che rappresenta lo snap-in. Per impostazione predefinita, questo cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSSnapInInfo

È possibile inviare tramite pipe un oggetto snap-in a questo cmdlet.

Output

None, System.Management.Automation.PSSnapInInfo

Questo cmdlet genera un oggetto System.Management.Automation.PSSnapInInfo che rappresenta lo snap-in, se si specifica il parametro PassThru. Per impostazione predefinita, Remove-PSSnapin non genera alcun output.

Note

Windows PowerShell include gli alias seguenti per Remove-PSSnapin:

  • rsnp

Remove-PSSnapin non controlla la versione di Windows PowerShell prima di rimuovere uno snap-in dalla sessione. Se non è possibile rimuovere uno snap-in, viene visualizzato un avviso e il comando non riesce.

Remove-PSSnapin influisce solo sulla sessione corrente. Se è stato aggiunto un comando Add-PSSnapin al profilo di Windows PowerShell, è necessario eliminare il comando per rimuovere lo snap-in dalle sessioni future. Per istruzioni, digitare Get-Help about_Profiles.