Über 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/oder -Cmdlets enthält. 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 auch das Cmdlet Export-Console verwenden, um die Snap-In-Namen in einer Konsolendatei zu speichern und sie dann in zukünftigen Sitzungen zu verwenden. Sie können sogar mehrere Konsolendateien speichern, jede mit einem anderen Satz von Snap-Ins.

Hinweis: Windows PowerShell-Snap-Ins (PSSnapins) sind für die Verwendung in Windows PowerShell 3.0 und Windows PowerShell 2.0 verfügbar. Sie können geändert werden oder in späteren Versionen nicht mehr verfügbar sein. Verwenden Sie zum Packen von Windows PowerShell-Cmdlets und -Anbietern Module. Informationen zum Erstellen von Modulen und zum Konvertieren von Snap-Ins in Module finden Sie unter Schreiben eines Windows PowerShell-Moduls.

FINDEN SIE 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 eine Liste der Cmdlets in einem Windows PowerShell-Snap-In abzurufen, geben Sie Folgendes ein:

Get-Command -Module <snap-in_name>

INSTALLIEREN EINES SNAP-IN

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.

REGISTRIEREN EINES SNAP-IN

Ein Windows PowerShell-Snap-In ist ein Programm, das in einer .NET Framework-Sprache geschrieben und in eine .dll Datei kompiliert wird. Um die Anbieter und Cmdlets in einem Snap-In verwenden zu können, müssen Sie das Snap-In zuerst registrieren (der Registrierung hinzufügen).

Die meisten Snap-Ins enthalten ein Installationsprogramm (eine .exe oder .msi Datei), das die .dll Datei für Sie registriert. Wenn Sie jedoch ein Snap-In als .dll Datei erhalten, können Sie es auf Ihrem System registrieren. Weitere Informationen finden Sie unter Registrieren von Cmdlets, Anbietern und Hostanwendungen in der MSDN Library.

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

HINZUFÜGEN DER SNAP-IN ZUR AKTUELLEN SITZUNG

Um der aktuellen Sitzung ein registriertes Snap-In hinzuzufügen, verwenden Sie das Cmdlet Add-PSSnapin. 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.

DIE SNAP-INS SPAREN

Wenn Sie ein Snap-In in zukünftigen Windows PowerShell-Sitzungen verwenden möchten, fügen Sie Ihrem Windows PowerShell-Profil den Befehl Add-PSSnapin hinzu. Oder exportieren Sie die Snap-In-Namen in eine Konsolendatei.

Wenn Sie Ihrem Profil den Befehl Add-PSSnapin 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 Befehl Add-PSSnapin Ihrem Windows PowerShell-Profil hinzuzufügen, öffnen Sie Ihr Profil, fügen Sie den Befehl ein, oder geben Sie ihn ein, und speichern Sie dann das Profil. Weitere Informationen finden Sie unter about_Profiles.

Verwenden Sie das Cmdlet Export-Console, um die Snap-Ins aus einer Sitzung in der Konsolendatei (PSC1) zu speichern. Geben Sie z. B. Folgendes ein, um die Snap-Ins in der aktuellen Sitzungskonfiguration in der Datei NewConsole.psc1 im aktuellen Verzeichnis zu speichern:

Export-Console NewConsole

Weitere Informationen finden Sie unter Export-Console.

ÖFFNEN VON WINDOWS POWERSHELL MIT 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. Mit dem folgenden Befehl wird z. B. Windows PowerShell mit der Konsolendatei NewConsole.psc1 gestartet:

PowerShell.exe -psconsolefile NewConsole.psc1

Die Anbieter und Cmdlets im Snapin stehen jetzt für die Verwendung in der Sitzung zur Verfügung.

ENTFERNEN EINES SNAP-IN

Um ein Windows PowerShell-Snap-In aus der aktuellen Sitzung zu entfernen, verwenden Sie das Cmdlet Remove-PSSnapin. 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.

BUILT-IN BEFEHLE

In Windows PowerShell 2.0 und in älteren Hostprogrammen in Windows PowerShell 3.0 und höher werden die integrierten Befehle, die mit Windows PowerShell installiert werden, in Snap-Ins verpackt, die jeder Windows PowerShell-Sitzung automatisch hinzugefügt werden.

Ab Windows PowerShell 3.0 werden in Hostprogrammen im neueren Stil, die Sitzungen mit der InitialSessionState.CreateDefault2-Methode starten, die integrierten Befehle in Modulen verpackt. Die Ausnahme ist Microsoft.PowerShell.Core, das immer als Snap-In angezeigt wird. Das Core-Snap-In ist standardmäßig in jeder Sitzung enthalten. Die eingebauten Module werden bei der ersten Verwendung automatisch geladen.

Hinweis: Remotesitzungen, einschließlich Sitzungen, die mit dem Cmdlet New-PSSession gestartet werden, sind Sitzungen im älteren Stil, in denen die integrierten Befehle in Snap-Ins verpackt sind.

Die folgenden Snap-Ins (oder Module) werden mit Windows PowerShell installiert.

Microsoft.PowerShell.Core: Enthält Anbieter und Cmdlets, die zum Verwalten der grundlegenden Features von Windows PowerShell verwendet werden. Es enthält die Anbieter FileSystem, Registry, Alias, Environment, Function und Variable sowie grundlegende Cmdlets wie Get-Help, Get-Command und Get-History.
Microsoft.PowerShell.Host: Enthält Cmdlets, die vom Windows PowerShell-Host verwendet werden, z. B. Start-Transcript und Stop-Transcript.
Microsoft.PowerShell.Management: Enthält Cmdlets wie Get-Service und Get-ChildItem, die zum Verwalten von Windows-basierten Features verwendet werden.
Microsoft.PowerShell.Security: Enthält den Zertifikatanbieter und die Cmdlets, die zum Verwalten der Windows PowerShell-Sicherheit verwendet werden, z. B. Get-Acl, Get-AuthenticodeSignature und ConvertTo-SecureString.
Microsoft.PowerShell.Utility: Enthält Cmdlets, die zum Bearbeiten von Objekten und Daten verwendet werden, z. B. Get-Member, Write-Host und Format-List.
Microsoft.WSMan.Management: Enthält den WSMan-Anbieter und Cmdlets, die den Windows-Remoteverwaltungsdienst verwalten, z. B. Connect-WSMan und Enable-WSManCredSSP.

PROTOKOLLIEREN 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 TRUE festlegen. Weitere Informationen finden Sie unter about_EventLogs.