Delen via

Add-PSSnapin

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee voegt u een of meer Windows PowerShell-modules toe aan de huidige sessie.

Syntaxis

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

Description

De cmdlet Add-PSSnapin voegt geregistreerde Windows PowerShell-modules toe aan de huidige sessie. Nadat de modules zijn toegevoegd, kunt u de cmdlets en providers gebruiken die door de modules in de huidige sessie worden ondersteund.

Als u de module wilt toevoegen aan alle toekomstige Windows PowerShell-sessies, voegt u een add-PSSnapin opdracht toe aan uw Windows PowerShell-profiel. Zie about_Profiles voor meer informatie.

Vanaf Windows PowerShell 3.0 worden de belangrijkste opdrachten die zijn opgenomen in Windows PowerShell, verpakt in modules. De uitzondering is Microsoft.PowerShell.Core, een module (PSSnapin). Standaard wordt alleen de module Microsoft.PowerShell.Core toegevoegd aan de sessie. Modules worden automatisch geïmporteerd bij eerste gebruik en u kunt de Import-Module cmdlet gebruiken om ze te importeren.

Voorbeelden

Voorbeeld 1: Modules toevoegen

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

Met deze opdracht worden de modules Microsoft Exchange en Active Directory toegevoegd aan de huidige sessie.

Voorbeeld 2: alle geregistreerde modules toevoegen

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

Met deze opdracht worden alle geregistreerde Windows PowerShell-modules toegevoegd aan de sessie. De cmdlet Get-PSSnapin wordt gebruikt met de parameter Registered om objecten op te halen die elk van de geregistreerde modules vertegenwoordigen. De pijplijnoperator (|) geeft het resultaat door aan Add-PSSnapin-, waarmee deze aan de sessie worden toegevoegd. De parameter PassThru retourneert objecten die elk van de toegevoegde modules vertegenwoordigen.

Voorbeeld 3: Een module registreren en toevoegen

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 dit voorbeeld ziet u hoe u een module op uw systeem registreert en deze vervolgens toevoegt aan uw sessie. Het maakt gebruik van ManagementFeatures, een fictieve module die is geïmplementeerd in een bestand met de naam ManagementCmdlets.dll.

Parameters

-Name

Hiermee geeft u de naam van de module. Dit is de naam, niet de AssemblyName of ModuleName. Jokertekens zijn toegestaan.

Als u de namen van de geregistreerde modules op uw systeem wilt vinden, typt u Get-PSSnapin -Registered.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Geeft aan dat deze cmdlet een object retourneert dat elke toegevoegde module vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None or System.Management.Automation.PSSnapInInfo

Met deze cmdlet wordt een PSSnapInInfo-object geretourneerd dat de module vertegenwoordigt als u de parameter PassThru opgeeft. Anders genereert deze cmdlet geen uitvoer.

Notities

  • Vanaf Windows PowerShell 3.0 worden de belangrijkste opdrachten die zijn geïnstalleerd met Windows PowerShell verpakt in modules. In Windows PowerShell 2.0 en in hostprogramma's die oudere sessies maken in latere versies van Windows PowerShell, worden de kernopdrachten verpakt in modules (PSSnapins). De uitzondering is Microsoft.PowerShell.Core, wat altijd een module is. Ook zijn externe sessies, zoals sessies die zijn gestart door de New-PSSession-cmdlet, oudere sessies met kernmodules.

    Zie CreateDefault2 Method in de MSDN-bibliotheek voor meer informatie over de methode CreateDefault2 waarmee nieuwere sessies met kernmodules worden gemaakt.

  • Zie about_PSSnapins en Een Windows PowerShell-module maken in de MSDN-bibliotheek voor meer informatie over modules.

  • Add-PSSnapin- voegt de module alleen toe aan de huidige sessie. Als u de module wilt toevoegen aan alle Windows PowerShell-sessies, voegt u deze toe aan uw Windows PowerShell-profiel. Zie about_Profiles voor meer informatie.

  • U kunt elke module toevoegen die is geregistreerd met behulp van het microsoft .NET Framework-installatieprogramma. Zie Cmdlets, providers en hosttoepassingen registreren in de MSDN-bibliotheek voor meer informatie.

  • Als u een lijst met modules wilt ophalen die zijn geregistreerd op uw computer, typt u Get-PSSnapin -Registered.

  • Voordat u een module toevoegt, controleert add-PSSnapin de versie van de module om te controleren of deze compatibel is met de huidige versie van Windows PowerShell. Als de module mislukt, meldt Windows PowerShell een fout.