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 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 cmdlet Import-Module 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, waardoor ze aan de sessie worden toegevoegd. 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 geen 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 gebruikt de Add-PSSnapin cmdlet om de module ManagementFeatures toe te voegen aan de sessie. Hiermee geeft u de naam op van de module ManagementFeatures, niet de bestandsnaam.

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

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 maakt gebruik van punt notatie om de waarde van de eigenschap PSSnapin van de cmdlet Set-Alias 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 Get-PSSnapin -Registeredu .

Type:String[]
Position:0
Default value:None
Required:True
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
Required:False
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

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

Windows PowerShell bevat de volgende aliassen voor Add-PSSnapin:

  • asnp

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 cmdlet New-PSSession, oudere sessies met kernmodules.

Zie CreateDefault2 Method voor meer 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 microsoft .NET Framework-installatieprogramma. Zie Cmdlets, providers en hosttoepassingen registreren voor meer informatie.

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

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.