Rimuove gli snap-in di Windows PowerShell dalla sessione corrente.
Sintassi
Remove-PSSnapin [-Name] <string[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Remove-PSSnapin rimuove uno snap-in di Windows PowerShell dalla sessione corrente. È possibile utilizzare questo comando per rimuovere gli snap-in aggiunti a Windows PowerShell, ma non quelli installati con Windows PowerShell.
In seguito alla rimozione dalla sessione corrente, lo snap-in verrà comunque caricato, ma i cmdlet e i provider presenti in esso non saranno più disponibili nella sessione.
Parametri
-Name <string[]>
Specifica i nomi degli snap-in di Windows PowerShell da rimuovere dalla sessione corrente. Il nome del parametro ("Name") è facoltativo e i caratteri jolly (*) sono consentiti nel valore.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
true |
-PassThru
Restituisce un oggetto che rappresenta lo snap-in. Per impostazione predefinita, il cmdlet non genera alcun output.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.Management.Automation.PSSnapInInfo È possibile reindirizzare un oggetto snap-in a Remove-PSSnapin. |
|
Output |
Nessuno o System.Management.Automation.PSSnapInInfo Per impostazione predefinita, Remove-PsSnapin non genera alcun output. Tuttavia, se si utilizza il parametro PassThru, viene generato un oggetto System.Management.Automation.PSSnapInInfo che rappresenta lo snap-in. |
Note
È inoltre possibile fare riferimento a Remove-PSSnapin tramite il relativo alias predefinito "rsnp". Per ulteriori informazioni, vedere about_Aliases.
Remove-PSSnapin non verifica la versione di Windows PowerShell prima di rimuovere uno snap-in dalla sessione. Se uno snap-in non può essere rimosso, viene visualizzato un avviso e il comando ha esito negativo.
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, vedere about_Profiles.
Esempio 1
C:\PS>remove-pssnapin -name Microsoft.Exchange Descrizione ----------- Con questo comando viene rimosso lo snap-in Microsoft.Exchange dalla sessione corrente. Al completamento del comando, i cmdlet e i provider supportati dallo snap-in non saranno più disponibili nella sessione.
Esempio 2
C:\PS>get-PSSnapIn smp* | remove-PSSnapIn Descrizione ----------- Questo comando rimuove dalla sessione corrente gli snap-in di Windows PowerShell i cui nomi iniziano con "smp". Nel comando viene utilizzato il cmdlet Get-PSSnapin per ottenere gli 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 dallo snap-in non saranno più disponibili nella sessione. Quando si reindirizzano oggetti a Remove-PSSnapin, i nomi degli oggetti vengono associati al parametro Name, che accetta dalla pipeline gli oggetti che dispongono di una proprietà Name.
Esempio 3
C:\PS>remove-pssnapin -name *event* Descrizione ----------- Questo comando rimuove tutti gli snap-in di Windows PowerShell i cui nomi includono "event". Questo comando specifica il nome del parametro "Name", ma è possibile omettere tale nome in quanto facoltativo.
Vedere anche