Remove-PSSnapin

  • Referenz
Modul:
Microsoft.PowerShell.Core

Entfernt Windows PowerShell-Snap-Ins aus der aktuellen Sitzung.

Syntax

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

Beschreibung

Das Remove-PSSnapin Cmdlet entfernt ein Windows PowerShell-Snap-In aus der aktuellen Sitzung. Sie können es verwenden, um Snap-Ins zu entfernen, die Sie Windows PowerShell hinzugefügt haben. Sie können dieses Cmdlet nicht verwenden, um die Mit Windows PowerShell installierten Snap-Ins zu entfernen.

Nachdem Sie ein Snap-In aus der aktuellen Sitzung entfernt haben, wird das Snap-In weiterhin geladen, aber die Cmdlets und Anbieter im Snap-In sind in der Sitzung nicht mehr verfügbar.

Beispiele

Beispiel 1: Entfernen eines Snap-Ins

Remove-PSSnapin -Name Microsoft.Exchange

Mit diesem Befehl wird das Microsoft.Exchange-Snap-In aus der aktuellen Sitzung entfernt. Wenn der Befehl abgeschlossen ist, sind die von dem Snap-In unterstützten Cmdlets und Anbieter in der Sitzung nicht mehr verfügbar.

Beispiel 2: Entfernen von Snap-Ins mithilfe von Namen mit der Pipeline

Get-PSSnapIn smp* | Remove-PSSnapIn

Mit diesem Befehl werden die Windows PowerShell-Snap-Ins entfernt, die Namen enthalten, die mit Smp aus der aktuellen Sitzung beginnen.

Der Befehl verwendet das Get-PSSnapin Cmdlet, um Objekte abzurufen, die die Snap-Ins darstellen. Der Pipelineoperator (|) sendet die Ergebnisse an das Remove-PSSnapin Cmdlet, das sie aus der Sitzung entfernt. Die von diesem Snap-In unterstützten Anbieter und Cmdlets sind in der Sitzung nicht mehr verfügbar.

Wenn Sie Objekte an pipen Remove-PSSnapin, werden die Namen der Objekte dem Parameter Name zugeordnet, der Objekte aus der Pipeline akzeptiert, die über eine Name-Eigenschaft verfügen.

Beispiel 3: Entfernen von Snap-Ins mithilfe von Namen

Remove-PSSnapin -Name *event*

Mit diesem Befehl werden alle Windows PowerShell-Snap-Ins entfernt, die Namen enthalten, die ein Ereignis enthalten.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt die Namen der Windows PowerShell-Snap-Ins an, die aus der aktuellen Sitzung entfernt werden sollen. Wildcardzeichen (*) sind zulässig.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Snap-In darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSSnapInInfo

Sie können ein Snap-In-Objekt an dieses Cmdlet weiterleiten.

Ausgaben

None, System.Management.Automation.PSSnapInInfo

Dieses Cmdlet generiert ein System.Management.Automation.PSSnapInInfo-Objekt , das das Snap-In darstellt, wenn Sie den PassThru-Parameter angeben. Standardmäßig Remove-PSSnapin werden keine Ausgaben generiert.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Remove-PSSnapin:

  • rsnp

Remove-PSSnapin überprüft die Version von Windows PowerShell nicht, bevor Sie ein Snap-In aus der Sitzung entfernen. Wenn ein Snap-In nicht entfernt werden kann, wird eine Warnung angezeigt und der Befehl führt zu einem Fehler.

Remove-PSSnapin betrifft nur die aktuelle Sitzung. 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. Geben Sie anweisungen ein Get-Help about_Profiles.