Über PSSnapins

Artikel
05/09/2024

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 erhalten.

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, aber die Änderung betrifft nur die aktuelle Sitzung.

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 dann in zukünftigen Sitzungen zu verwenden. Sie können sogar mehrere Konsolendateien mit jeweils unterschiedlichen Snap-Ins speichern.

HINWEIS: Windows PowerShell-Snap-Ins (PSSnapins) stehen in Windows PowerShell 3.0 und Windows PowerShell 2.0 zur Verfügung. Sie sind in nachfolgenden Versionen möglicherweise geändert oder nicht verfügbar. 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.

SUCHEN VON 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-INS

Die integrierten Snap-Ins werden im System registriert und der Standardsitzung hinzugefügt, wenn Sie Windows PowerShell starten. 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-INS

Ein Windows PowerShell-Snap-In ist ein In einer .NET Framework Sprache geschriebenes Programm, das in eine .dll-Datei kompiliert wird. Um die Anbieter und Cmdlets in einem Snap-In verwenden zu können, müssen Sie zuerst das Snap-In registrieren (es 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.

Geben Sie Folgendes ein, um alle registrierten Snap-Ins auf Ihrem System abzurufen oder zu überprüfen, ob ein Snap-In registriert ist:

Get-PSSnapin -registered

HINZUFÜGEN DES SNAP-INS ZUR AKTUELLEN SITZUNG

Verwenden Sie das Cmdlet Add-PSSnapin, um der aktuellen Sitzung ein registriertes Snap-In hinzuzufügen. Um beispielsweise das Microsoft SQL Server-Snap-In zur Sitzung hinzuzufügen, geben Sie Folgendes ein:

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 DER SNAP-INS

Um ein Snap-In in zukünftigen Windows PowerShell-Sitzungen zu verwenden, fügen Sie dem Windows PowerShell profil den Befehl Add-PSSnapin hinzu. Oder exportieren Sie die Snap-In-Namen in eine Konsolendatei.

Wenn Sie dem 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 oder geben Sie den Befehl ein, und speichern Sie 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. Um beispielsweise die Snap-Ins in der aktuellen Sitzungskonfiguration in der Datei NewConsole.psc1 im aktuellen Verzeichnis zu speichern, geben Sie Folgendes ein:

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 PsConsoleFile-Parameter, um die Konsolendatei anzugeben, die das Snap-In enthält. Der folgende Befehl startet beispielsweise Windows PowerShell mit der Konsolendatei NewConsole.psc1:

PowerShell.exe -psconsolefile NewConsole.psc1

Die Anbieter und Cmdlets im Snapin sind jetzt für die Verwendung in der Sitzung verfügbar.

ENTFERNEN EINES SNAP-INS

Verwenden Sie das Cmdlet Remove-PSSnapin, 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

Dieses Cmdlet entfernt das Snap-In aus der Sitzung. Das Snap-In wird weiterhin geladen, aber die unterstützten Anbieter und Cmdlets sind nicht mehr verfügbar.

INTEGRIERTE BEFEHLE

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

Ab Windows PowerShell 3.0 werden die integrierten Befehle in Hostprogrammen der neueren Art , d. h. denen, die Sitzungen mit der InitialSessionState.CreateDefault2-Methode starten, in Module verpackt. Die Ausnahme ist Microsoft.PowerShell.Core, die immer als Snap-In angezeigt wird. Das Core-Snap-In ist standardmäßig in jeder Sitzung enthalten. Die integrierten 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. Sie umfasst 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 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 die Cmdlets, die den Windows-Remoteverwaltungsdienst verwalten, z. B. Connect-WSMan und Enable-WSManCredSSP.

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