Add-PSSnapin

Add-PSSnapin
    [-Name] <String[]>
    [-PassThru]
    [<CommonParameters>]

Das Cmdlet Add-PSSnapin fügt der aktuellen Sitzung registrierte Windows PowerShell-Snap-Ins hinzu. Nachdem die Snap-Ins hinzugefügt wurden, können Sie die Cmdlets und Anbieter verwenden, die die Snap-Ins in der aktuellen Sitzung unterstützen.

Wenn Sie das Snap-In allen zukünftigen Windows PowerShell-Sitzungen hinzufügen möchten, fügen Sie Ihrem Windows PowerShell-Profil den Befehl Add-PSSnapin hinzu. Weitere Informationen finden Sie unter about_Profiles.

Ab Windows PowerShell 3.0 werden die Kernbefehle, die in Windows PowerShell enthalten sind, in Module verpackt. Die Ausnahme ist Microsoft.PowerShell.Core, bei dem es sich um ein Snap-In (PSSnapin) handelt. Standardmäßig wird nur das Microsoft.PowerShell.Core Snap-In der Sitzung hinzugefügt. Module werden bei der ersten Verwendung automatisch importiert, und Sie können das cmdlet Import-Module verwenden, um sie zu importieren.

PS C:\> Add-PSSnapIn -Name Microsoft.Exchange, Microsoft.Windows.AD

Mit diesem Befehl werden die Microsoft Exchange- und Active Directory-Snap-Ins zur aktuellen Sitzung hinzugefügt.

PS C:\> Get-PSSnapin -Registered | Add-PSSnapin -Passthru

Mit diesem Befehl werden der Sitzung alle registrierten Windows PowerShell-Snap-Ins hinzugefügt. Dabei wird das Cmdlet Get-PSSnapin mit dem Parameter Registered verwendet, um Objekte abzurufen, die die einzelnen registrierten Snap-Ins darstellen. Der Pipelineoperator (|) übergibt das Ergebnis an Add-PSSnapin, wodurch sie der Sitzung hinzugefügt werden. Der PassThru Parameter gibt Objekte zurück, die jedes der hinzugefügten Snap-Ins darstellen.

The first command gets snap-ins that have been added to the current session that include the snap-ins that are installed with Windows PowerShell. In this example, ManagementFeatures is not returned. This indicates that it has not been added to the session.
PS C:\> Get-PSSnapin

The second command gets snap-ins that have been registered on your system, which includes those that have already been added to the session. It does not include the snap-ins that are installed with Windows PowerShell. In this case, the command does not return any snap-ins. This indicates that the ManagementFeatures snapin has not been registered on the system.
PS C:\> Get-PSSnapin -Registered

The third command creates an alias, installutil, for the path of the InstallUtil tool in .NET Framework.
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe

The fourth command uses the InstallUtil tool to register the snap-in. The command specifies the path of ManagementCmdlets.dll, the file name or module name of the snap-in.
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll

The fifth command is the same as the second command. This time, you use it to verify that the ManagementCmdlets snap-in is registered.
PS C:\> Get-PSSnapin -Registered

The sixth command uses the **Add-PSSnapin** cmdlet to add the ManagementFeatures snap-in to the session. It specifies the name of the snap-in, ManagementFeatures, not the file name.
PS C:\> add-pssnapin ManagementFeatures

To verify that the snap-in is added to the session, the seventh command uses the *Module* parameter of the Get-Command cmdlet. It displays the items that were added to the session by a snap-in or module.
PS C:\> Get-Command -Module ManagementFeatures

You can also use the **PSSnapin** property of the object that the **Get-Command** cmdlet returns to find the snap-in or module in which a cmdlet originated. The eighth command uses dot notation to find the value of the PSSnapin property of the Set-Alias cmdlet.
PS C:\> (Get-Command Set-Alias).pssnapin

In diesem Beispiel wird das Registrieren eines Snap-Ins auf Ihrem System und anschließendes Hinzufügen zu Ihrer Sitzung veranschaulicht. Es verwendet ManagementFeatures, ein fiktives Snap-In, das in einer Datei implementiert wird, die ManagementCmdlets.dllheißt.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Objekte können nicht an dieses Cmdlet weitergeleitet werden.

Dieses Cmdlet gibt ein PSSnapInInfo -Objekt zurück, das das Snap-In darstellt, wenn Sie den PassThru Parameter angeben. Andernfalls generiert dieses Cmdlet keine Ausgabe.

• Ab Windows PowerShell 3.0 werden die mit Windows PowerShell installierten Kernbefehle in Module verpackt. In Windows PowerShell 2.0 und in Hostprogrammen, die ältere Sitzungen in späteren Versionen von Windows PowerShell erstellen, werden die Kernbefehle in Snap-Ins (PSSnapins) verpackt. Die Ausnahme ist Microsoft.PowerShell.Core, die immer ein Snap-In ist. Außerdem sind Remotesitzungen, z. B. die vom Cmdlet New-PSSession gestarteten Sitzungen, ältere Sitzungen, die Kern-Snap-Ins enthalten.

  Informationen zur CreateDefault2-Methode , mit der Sitzungen im neueren Stil mit Kernmodulen erstellt werden, finden Sie unter CreateDefault2-Methode in der MSDN Library.

• Weitere Informationen zu Snap-Ins finden Sie unter about_PSSnapins und Erstellen eines Windows PowerShell-Snap-Ins in der MSDN Library.

• Add-PSSnapin fügt das Snap-In nur der aktuellen Sitzung hinzu. Um das Snap-In allen Windows PowerShell-Sitzungen hinzuzufügen, fügen Sie es Ihrem Windows PowerShell-Profil hinzu. Weitere Informationen finden Sie unter about_Profiles.

• Sie können jedes Snap-In hinzufügen, das mit dem Microsoft .NET Framework-Installationsprogramm registriert wurde. Weitere Informationen finden Sie unter Registrieren von Cmdlets, Anbietern und Hostanwendungen in der MSDN Library.

• Geben Sie Get-PSSnapin -Registeredein, um eine Liste von Snap-Ins abzurufen, die auf Ihrem Computer registriert sind.

• Vor dem Hinzufügen eines Snap-Ins überprüft Add-PSSnapin die Version des Snap-Ins, um sicherzustellen, dass es mit der aktuellen Version von Windows PowerShell kompatibel ist. Wenn das Snap-In die Versionsüberprüfung fehlschlägt, meldet Windows PowerShell einen Fehler.