Over PSSnapins

Artikel
06/21/2023

KORTE BESCHRIJVING

Beschrijft Windows PowerShell modules en laat zien hoe u deze kunt gebruiken en beheren.

LANGE BESCHRIJVING

Een Windows PowerShell module is een Microsoft .NET Framework assembly die Windows PowerShell providers en/of cmdlets bevat. Windows PowerShell bevat een set basismodules, maar u kunt de kracht en waarde van Windows PowerShell uitbreiden door modules toe te voegen die providers en cmdlets bevatten die u maakt of van anderen opneemt.

Wanneer u een module toevoegt, zijn de cmdlets en providers die deze bevat onmiddellijk beschikbaar voor gebruik in de huidige sessie, maar de wijziging is alleen van invloed op de huidige sessie.

Als u de module wilt toevoegen aan alle toekomstige sessies, slaat u deze op in uw Windows PowerShell-profiel. U kunt ook de cmdlet Export-Console gebruiken om de namen van de module op te slaan in een consolebestand en deze vervolgens in toekomstige sessies te gebruiken. U kunt zelfs meerdere consolebestanden opslaan, elk met een andere set modules.

OPMERKING: Windows PowerShell-modules (PSSnapins) zijn beschikbaar voor gebruik in Windows PowerShell 3.0 en Windows PowerShell 2.0. Ze zijn mogelijk gewijzigd of niet beschikbaar in volgende versies. Gebruik modules om Windows PowerShell cmdlets en providers te verpakken. Zie Een Windows PowerShell module schrijven voor meer informatie over het maken van modules en het converteren van modules naar modules.

MODULES ZOEKEN

Als u een lijst met de Windows PowerShell modules op uw computer wilt ophalen, typt u:

Get-PSSnapin

Als u de module voor elke Windows PowerShell provider wilt ophalen, typt u:

Get-PSProvider | Format-List name, pssnapin

Als u een lijst met de cmdlets in een Windows PowerShell module wilt ophalen, typt u:

Get-Command -Module <snap-in_name>

EEN MODULE INSTALLEREN

De ingebouwde modules worden geregistreerd in het systeem en toegevoegd aan de standaardsessie wanneer u Windows PowerShell start. U moet echter modules registreren die u maakt of verkrijgt van anderen en vervolgens de modules toevoegen aan uw sessie.

EEN MODULE REGISTREREN

Een Windows PowerShell-module is een programma dat is geschreven in een .NET Framework taal en dat is gecompileerd in een .dll-bestand. Als u de providers en cmdlets in een module wilt gebruiken, moet u eerst de module registreren (toevoegen aan het register).

De meeste modules bevatten een installatieprogramma (een .exe- of .msi-bestand) waarmee het .dll-bestand voor u wordt geregistreerd. Als u echter een module als een .dll-bestand ontvangt, kunt u deze op uw systeem registreren. Zie How to Register Cmdlets, Providers, and Host Applications (Cmdlets, providers en hosttoepassingen registreren ) in de MSDN-bibliotheek voor meer informatie.

Als u alle geregistreerde modules op uw systeem wilt ophalen of wilt controleren of een module is geregistreerd, typt u:

Get-PSSnapin -registered

DE MODULE TOEVOEGEN AAN DE HUIDIGE SESSIE

Als u een geregistreerde module wilt toevoegen aan de huidige sessie, gebruikt u de cmdlet Add-PSSnapin. Als u bijvoorbeeld de Module Microsoft SQL Server wilt toevoegen aan de sessie, typt u:

Add-PSSnapin sql

Nadat de opdracht is voltooid, zijn de providers en cmdlets in de module beschikbaar in de sessie. Ze zijn echter alleen beschikbaar in de huidige sessie, tenzij u ze opslaat.

DE MODULES OPSLAAN

Als u een module in toekomstige Windows PowerShell sessies wilt gebruiken, voegt u de opdracht Add-PSSnapin toe aan uw Windows PowerShell-profiel. Of exporteer de namen van de module naar een consolebestand.

Als u de opdracht Add-PSSnapin toevoegt aan uw profiel, is deze beschikbaar in alle toekomstige Windows PowerShell sessies. Als u de namen van de modules in uw sessie exporteert, kunt u het exportbestand alleen gebruiken wanneer u de modules nodig hebt.

Als u de opdracht Add-PSSnapin wilt toevoegen aan uw Windows PowerShell profiel, opent u uw profiel, plakt of typt u de opdracht en slaat u het profiel op. Zie about_Profiles voor meer informatie.

Als u de modules van een sessie wilt opslaan in het consolebestand (.psc1), gebruikt u de cmdlet Export-Console. Als u bijvoorbeeld de modules in de huidige sessieconfiguratie wilt opslaan in het bestand NewConsole.psc1 in de huidige map, typt u:

Export-Console NewConsole

Zie Export-Console voor meer informatie.

WINDOWS POWERSHELL OPENEN MET EEN CONSOLEBESTAND

Als u een consolebestand wilt gebruiken dat de module bevat, start u Windows PowerShell (PowerShell.exe) vanaf de opdrachtprompt in Cmd.exe of in een andere Windows PowerShell sessie. Gebruik de parameter PsConsoleFile om het consolebestand op te geven dat de module bevat. Met de volgende opdracht wordt bijvoorbeeld Windows PowerShell gestart met het consolebestand NewConsole.psc1:

PowerShell.exe -psconsolefile NewConsole.psc1

De providers en cmdlets in de modulein zijn nu beschikbaar voor gebruik in de sessie.

EEN MODULE VERWIJDEREN

Als u een Windows PowerShell module uit de huidige sessie wilt verwijderen, gebruikt u de cmdlet Remove-PSSnapin. Als u bijvoorbeeld de module SQL Server uit de huidige sessie wilt verwijderen, typt u:

Remove-PSSnapin sql

Met deze cmdlet verwijdert u de module uit de sessie. De module is nog steeds geladen, maar de providers en cmdlets die worden ondersteund, zijn niet meer beschikbaar.

INGEBOUWDE OPDRACHTEN

In Windows PowerShell 2.0 en in oudere hostprogramma's in Windows PowerShell 3.0 en hoger worden de ingebouwde opdrachten die met Windows PowerShell zijn geïnstalleerd, verpakt in modules die automatisch aan elke Windows PowerShell sessie worden toegevoegd.

Vanaf Windows PowerShell 3.0 worden de ingebouwde opdrachten in modules verpakt in hostprogramma's met een nieuwere stijl, die sessies starten met behulp van de methode InitialSessionState.CreateDefault2. De uitzondering is Microsoft.PowerShell.Core, die altijd wordt weergegeven als een module. De module Core is standaard opgenomen in elke sessie. De ingebouwde modules worden automatisch geladen bij het eerste gebruik.

OPMERKING: Externe sessies, inclusief sessies die worden gestart met behulp van de cmdlet New-PSSession, zijn sessies in oudere stijl waarin de ingebouwde opdrachten zijn verpakt in modules.

De volgende modules (of modules) worden geïnstalleerd met Windows PowerShell.

Microsoft.PowerShell.Core: bevat providers en cmdlets die worden gebruikt voor het beheren van de basisfuncties van Windows PowerShell. Het bevat de providers Bestandssysteem, Register, Alias, Omgeving, Functie en Variabele en basis-cmdlets zoals Get-Help, Get-Command en Get-History.
Microsoft.PowerShell.Host: bevat cmdlets die worden gebruikt door de Windows PowerShell host, zoals Start-Transcript en Stop-Transcript.
Microsoft.PowerShell.Management: bevat cmdlets zoals Get-Service en Get-ChildItem die worden gebruikt voor het beheren van Windows-functies.
Microsoft.PowerShell.Security - Bevat de certificaatprovider en cmdlets die worden gebruikt voor het beheren van Windows PowerShell beveiliging, zoals Get-Acl, Get-AuthenticodeSignature en ConvertTo-SecureString.
Microsoft.PowerShell.Utility - Bevat cmdlets die worden gebruikt voor het bewerken van objecten en gegevens, zoals Get-Member, Write-Host en Format-List.
Microsoft.WSMan.Management: bevat de WSMan-provider en cmdlets die de Windows Remote Management-service beheren, zoals Connect-WSMan en Enable-WSManCredSSP.

MODULEGEBEURTENISSEN VOOR LOGBOEKREGISTRATIE

Vanaf Windows PowerShell 3.0 kunt u uitvoeringsgebeurtenissen voor de cmdlets in Windows PowerShell modules en modules vastleggen door de eigenschap LogPipelineExecutionDetails van modules en modules in te stellen op TRUE. Zie about_EventLogs voor meer informatie.