about_PSSnapins
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 -cmdlets kan bevatten. 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 van anderen maakt of ophalen.
Wanneer u een module toevoegt, zijn de cmdlets en providers die deze bevat direct 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 de Export-Console cmdlet ook gebruiken om de modulenamen op te slaan in een consolebestand en deze opgeslagen configuratie vervolgens te gebruiken in toekomstige sessies.
Vanaf Windows PowerShell 3.0 worden de cmdlets die met PowerShell worden geleverd, verpakt in modules. De uitzondering is Microsoft.PowerShell.Core. Dit is de enige resterende module. De module Microsoft.PowerShell.Core wordt standaard in elke sessie geladen. De resterende modules worden automatisch geladen bij eerste gebruik. Zie about_Modules voor meer informatie.
Een module 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 alle geregistreerde modules op uw systeem wilt ophalen of wilt controleren of een module is geregistreerd, typt u:
Get-PSSnapin -registered
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 aan uw sessie toevoegen.
Een module toevoegen aan de huidige sessie
Gebruik de Add-PsSnapin cmdlet om een geregistreerde module toe te voegen aan de huidige sessie. Als u bijvoorbeeld de Microsoft SQL Server-module 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.
Een module opslaan
Als u een module in toekomstige Windows PowerShell-sessies wilt gebruiken, voegt u de Add-PsSnapin opdracht toe aan uw Windows PowerShell-profiel. Of exporteer de modulenamen naar een consolebestand.
Als u de Add-PSSnapin opdracht aan uw profiel toevoegt, 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 Add-PsSnapin opdracht 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.
Gebruik de Export-Console cmdlet om de modules op te slaan vanuit een sessie in het consolebestand (.psc1). Als u bijvoorbeeld de modules in de huidige sessieconfiguratie wilt opslaan in het NewConsole.psc1 bestand in de huidige map, typt u:
Export-Console NewConsole
Zie Export-Console voor meer informatie.
Windows PowerShell openen met behulp van 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 Windows PowerShell bijvoorbeeld gestart met het NewConsole.psc1 consolebestand:
PowerShell.exe -psconsolefile NewConsole.psc1
De providers en cmdlets in de module 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 Remove-PsSnapin cmdlet. Als u bijvoorbeeld de SQL Server-module uit de huidige sessie wilt verwijderen, typt u:
Remove-PSSnapin sql
Met deze cmdlet wordt de module uit de sessie verwijderd. De module wordt nog steeds geladen, maar de providers en cmdlets die worden ondersteund, zijn niet meer beschikbaar.
Modulegebeurtenissen in logboeken
Vanaf Windows PowerShell 3.0 kunt u uitvoeringsgebeurtenissen vastleggen voor de cmdlets in Windows PowerShell-modules en -modules door de eigenschap LogPipelineExecutionDetails van modules en modules in te stellen op $true.
Zie about_EventLogs voor meer informatie.
