about_PSSnapins
Kurze Beschreibung
Beschreibt Windows PowerShell-Snap-Ins und zeigt, wie sie verwendet und verwaltet werden.
Lange Beschreibung
Ein Windows PowerShell-Snap-In ist eine Microsoft .NET Framework-Assembly, die Windows PowerShell-Anbieter und Cmdlets enthalten kann. Windows PowerShell enthält eine Reihe grundlegender Snap-Ins, Sie können jedoch die Leistungsfähigkeit und den Wert von Windows PowerShell erweitern, indem Sie Snap-Ins hinzufügen, die Anbieter und Cmdlets enthalten, die Sie erstellen oder von anderen abrufen.
Wenn Sie ein Snap-In hinzufügen, sind die darin enthaltenen Cmdlets und Anbieter sofort für die Verwendung in der aktuellen Sitzung verfügbar, die Änderung wirkt sich jedoch nur auf die aktuelle Sitzung aus.
Um das Snap-In allen zukünftigen Sitzungen hinzuzufügen, speichern Sie es in Ihrem Windows PowerShell-Profil. Sie können das Cmdlet auch verwenden, um die Export-Console Snap-In-Namen in einer Konsolendatei zu speichern und diese gespeicherte Konfiguration dann in zukünftigen Sitzungen zu verwenden.
Ab Windows PowerShell 3.0 werden die Cmdlets, die mit PowerShell ausgeliefert werden, in Modulen verpackt. Die Ausnahme ist Microsoft.PowerShell.Core, bei dem es sich um das einzige verbleibende Snap-In handelt. Das Microsoft.PowerShell.Core-Snap-In wird standardmäßig in jeder Sitzung geladen. Die übrigen Module werden automatisch bei der erstverwendigen Verwendung geladen. Weitere Informationen finden Sie unter about_Modules.
Suchen eines Snap-Ins
Um eine Liste der Windows PowerShell-Snap-Ins auf Ihrem Computer abzurufen, geben Sie Folgendes ein:
Get-PSSnapin
Um das Snap-In für jeden Windows PowerShell-Anbieter abzurufen, geben Sie Folgendes ein:
Get-PSProvider | Format-List name, pssnapin
Um alle registrierten Snap-Ins auf Ihrem System abzurufen oder zu überprüfen, ob ein Snap-In registriert ist, geben Sie Folgendes ein:
Get-PSSnapin -registered
Um eine Liste der Cmdlets in einem Windows PowerShell-Snap-In abzurufen, geben Sie Folgendes ein:
Get-Command -Module <snap-in_name>
Installieren eines Snap-Ins
Die integrierten Snap-Ins werden im System registriert und der Standardsitzung beim Starten von Windows PowerShell hinzugefügt. Sie müssen jedoch Snap-Ins registrieren, die Sie erstellen oder von anderen abrufen, und dann die Snap-Ins zu Ihrer Sitzung hinzufügen.
Hinzufügen eines Snap-Ins zur aktuellen Sitzung
Verwenden Sie das Add-PsSnapin Cmdlet, um der aktuellen Sitzung ein registriertes Snap-In hinzuzufügen. Geben Sie beispielsweise Folgendes ein, um das Microsoft SQL Server-Snap-In zur Sitzung hinzuzufügen:
Add-PSSnapin sql
Nach Abschluss des Befehls sind die Anbieter und Cmdlets im Snap-In in der Sitzung verfügbar. Sie sind jedoch nur in der aktuellen Sitzung verfügbar, es sei denn, Sie speichern sie.
Speichern von Snap-Ins
Um ein Snap-In in zukünftigen Windows PowerShell-Sitzungen zu verwenden, fügen Sie den Add-PsSnapin Befehl zu Ihrem Windows PowerShell-Profil hinzu. Oder exportieren Sie die Snap-In-Namen in eine Konsolendatei.
Wenn Sie den Add-PSSnapin Befehl zu Ihrem Profil hinzufügen, ist er in allen zukünftigen Windows PowerShell-Sitzungen verfügbar. Wenn Sie die Namen der Snap-Ins in Ihrer Sitzung exportieren, können Sie die Exportdatei nur verwenden, wenn Sie die Snap-Ins benötigen.
Um den Add-PsSnapin Befehl zu Ihrem Windows PowerShell-Profil hinzuzufügen, öffnen Sie Ihr Profil, fügen Sie den Befehl ein, oder geben Sie ihn ein, und speichern Sie das Profil. Weitere Informationen finden Sie unter about_Profiles.
Verwenden Sie das Export-Console Cmdlet, um die Snap-Ins aus einer Sitzung in der Konsolendatei (.psc1) zu speichern. Geben Sie beispielsweise Folgendes ein, um die Snap-Ins in der aktuellen Sitzungskonfiguration in der NewConsole.psc1 Datei im aktuellen Verzeichnis zu speichern:
Export-Console NewConsole
Weitere Informationen finden Sie unter "Export-Console".
Öffnen von Windows PowerShell mithilfe einer Konsolendatei
Um eine Konsolendatei zu verwenden, die das Snap-In enthält, starten Sie Windows PowerShell (powershell.exe) über die Eingabeaufforderung in cmd.exe oder in einer anderen Windows PowerShell-Sitzung. Verwenden Sie den Parameter "PsConsoleFile ", um die Konsolendatei anzugeben, die das Snap-In enthält. Beispielsweise startet der folgende Befehl Windows PowerShell mit der NewConsole.psc1 Konsolendatei:
PowerShell.exe -psconsolefile NewConsole.psc1
Die Anbieter und Cmdlets im Snap-In sind jetzt für die Verwendung in der Sitzung verfügbar.
Entfernen eines Snap-Ins
Verwenden Sie das Remove-PsSnapin Cmdlet, um ein Windows PowerShell-Snap-In aus der aktuellen Sitzung zu entfernen. Um beispielsweise das SQL Server-Snap-In aus der aktuellen Sitzung zu entfernen, geben Sie Folgendes ein:
Remove-PSSnapin sql
Mit diesem Cmdlet wird das Snap-In aus der Sitzung entfernt. Das Snap-In wird weiterhin geladen, aber die von ihr unterstützten Anbieter und Cmdlets sind nicht mehr verfügbar.
Protokollieren von Snap-In-Ereignissen
Ab Windows PowerShell 3.0 können Sie Ausführungsereignisse für die Cmdlets in Windows PowerShell-Modulen und Snap-Ins aufzeichnen, indem Sie die LogPipelineExecutionDetails-Eigenschaft von Modulen und Snap-Ins auf $truefestlegen.
Weitere Informationen finden Sie unter about_EventLogs.
