Add-PSSnapin

Referentie

Module:: Microsoft.PowerShell.Core

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

Syntax

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

Description

De Add-PSSnapin cmdlet 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 kernopdrachten 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 aan de sessie toegevoegd. Hierbij wordt de cmdlet Get-PSSnapin met de parameter Geregistreerd gebruikt om objecten op te halen die elk van de geregistreerde modules vertegenwoordigen. De pijplijnoperator (|) geeft het resultaat door aan Add-PSSnapin, waardoor deze worden toegevoegd aan de sessie. De Parameter PassThru retourneert objecten die elk van de toegevoegde modules vertegenwoordigen.

Voorbeeld 3: Een module registreren en toevoegen

Met de eerste opdracht worden modules opgehaald die zijn toegevoegd aan de huidige sessie met de modules die zijn geïnstalleerd met Windows PowerShell. In dit voorbeeld wordt ManagementFeatures niet geretourneerd. Dit geeft aan dat deze niet is toegevoegd aan de sessie.

De tweede opdracht krijgt modules die zijn geregistreerd op uw systeem, inclusief modules die al aan de sessie zijn toegevoegd. Het bevat niet de modules die zijn geïnstalleerd met Windows PowerShell. In dit geval retourneert de opdracht geen modules. Dit geeft aan dat de module ManagementFeatures niet is geregistreerd op het systeem.

Met de derde opdracht maakt u een alias, installutil, voor het pad van het hulpprogramma InstallUtil in .NET Framework.

De vierde opdracht maakt gebruik van het hulpprogramma InstallUtil om de module te registreren. Met de opdracht geeft u het pad van ManagementCmdlets.dll, de bestandsnaam of modulenaam van de module op.

De vijfde opdracht is hetzelfde als de tweede opdracht. Deze keer gebruikt u deze om te controleren of de module ManagementCmdlets is geregistreerd.

De zesde opdracht maakt gebruik van de Add-PSSnapin cmdlet om de module ManagementFeatures toe te voegen aan de sessie. Hiermee wordt de naam van de module ManagementFeatures opgegeven, niet de bestandsnaam.

Om te controleren of de module is toegevoegd aan de sessie, gebruikt de zevende opdracht de moduleparameter van de Get-Command cmdlet. Hier worden de items weergegeven die door een module of module aan de sessie zijn toegevoegd.

U kunt ook de PSSnapin-eigenschap van het object gebruiken dat door de Get-Command cmdlet wordt geretourneerd om de module of module te vinden waarin een cmdlet afkomstig is. De achtste opdracht gebruikt puntnotatie om de waarde van de PSSnapin-eigenschap van de Set-Alias cmdlet te vinden.

PS C:\> Get-PSSnapin
PS C:\> Get-PSSnapin -Registered
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll
PS C:\> Get-PSSnapin -Registered
PS C:\> add-pssnapin ManagementFeatures
PS C:\> Get-Command -Module ManagementFeatures
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 zoeken, typt u Get-PSSnapin -Registered.

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	True

-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
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None or System.Management.Automation.PSSnapInInfo

Deze cmdlet retourneert een PSSnapInInfo-object dat de module vertegenwoordigt als u de Parameter PassThru opgeeft. Anders genereert deze cmdlet geen uitvoer.

Notities

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

Zie De Methode CreateDefault2 voor informatie over de methode CreateDefault2 waarmee nieuwere sessies met kernmodules worden gemaakt.
Zie about_PSSnapins en Een Windows PowerShell module maken 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 installatieprogramma van Microsoft .NET Framework. Zie Cmdlets, providers en hosttoepassingen registreren 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, Add-PSSnapin controleert u 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.