Entfernt Windows PowerShell-Snap-Ins aus der aktuellen Sitzung.
Syntax
Remove-PSSnapin [-Name] <string[]> [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Remove-PSSnapin" wird ein Windows PowerShell-Snap-In aus der aktuellen Sitzung entfernt. Damit können Sie Snap-Ins entfernen, die Sie Windows PowerShell hinzugefügt haben, Sie können jedoch damit keine Snap-Ins entfernen, die mit Windows PowerShell installiert wurden.
Nach dem Entfernen eines Snap-Ins aus der aktuellen Sitzung ist dieses immer noch geladen, die Cmdlets und Anbieter im Snap-In sind jedoch nicht mehr in der Sitzung verfügbar.
Parameter
-Name <string[]>
Gibt die Namen von Windows PowerShell-Snap-Ins an, die aus der aktuellen Sitzung entfernt werden sollen. Der Parametername ("Name") ist optional, und Platzhalterzeichen (*) im Wert sind zulässig.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
keine |
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
true |
-PassThru
Gibt ein Objekt zurück, das das Snap-In darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.Management.Automation.PSSnapInInfo Sie können ein Snap-In-Objekt über die Pipeline an Remove-PSSnapin übergeben. |
|
Ausgaben |
Keiner oder System.Management.Automation.PSSnapInInfo Standardmäßig generiert Remove-PsSnapin keine Ausgabe. Wenn Sie den PassThru-Parameter verwenden, wird jedoch ein System.Management.Automation.PSSnapInInfo-Objekt generiert, das das Snap-In darstellt. |
Hinweise
Sie können auch über den integrierten Alias "rsnp" auf Remove-PSSnapin verweisen. Weitere Informationen finden Sie unter "about_Aliases".
Mit Remove-PSSnapin wird nicht die Windows PowerShell-Version überprüft, bevor ein Snap-In aus der Sitzung entfernt wird. Wenn ein Snap-In nicht entfernt werden kann, wird eine Warnung ausgegeben, und bei der Ausführung des Befehls tritt ein Fehler auf.
Remove-PSSnapin wirkt sich nur auf die aktuelle Sitzung aus. Wenn Sie Ihrem Windows PowerShell-Profil einen Add-PSSnapin-Befehl hinzugefügt haben, sollten Sie den Befehl löschen, um das Snap-In aus zukünftigen Sitzungen zu entfernen. Weitere Anweisungen finden Sie unter "about_Profiles".
Beispiel 1
C:\PS>remove-pssnapin -name Microsoft.Exchange Beschreibung ----------- Mit diesem Befehl wird das Snap-In "Microsoft.Exchange" aus der aktuellen Sitzung entfernt. Wenn der Befehl abgeschlossen wurde, sind die vom Snap-In unterstützten Cmdlets und Anbieter in der Sitzung nicht mehr verfügbar.
Beispiel 2
C:\PS>get-PSSnapIn smp* | remove-PSSnapIn Beschreibung ----------- Mit diesem Befehl werden die Windows PowerShell-Snap-Ins, deren Name mit "smp" beginnt, aus der aktuellen Sitzung entfernt. Der erste Befehl ruft Objekte, die Snap-Ins darstellen, mit dem Cmdlet "Get-PSSnapin" ab. Mit dem Pipelineoperator (|) werden die Ergebnisse an das Cmdlet "Remove-PSSnapin" gesendet, das sie aus der Sitzung entfernt. Die von diesem Snap-In unterstützten Cmdlets und Anbieter sind in der Sitzung nicht mehr verfügbar. Wenn Sie Objekte über die Pipeline an "Remove-PSSnapin" übergeben, werden die Namen der Objekte dem Name-Parameter zugeordnet, der Objekte mit einer Name-Eigenschaft aus der Pipeline akzeptiert.
Beispiel 3
C:\PS>remove-pssnapin -name *event* Beschreibung ----------- Mit diesem Befehl werden alle Windows PowerShell-Snap-Ins entfernt, deren Name "event" enthält. Mit diesem Befehl wird der Parametername "Name" angegeben, der Parametername kann jedoch weggelassen werden, da er optional ist.
Siehe auch