about_PSSnapins
Rövid leírás
Ismerteti a Windows PowerShell beépülő modulokat, és bemutatja azok használatát és kezelését.
Hosszú leírás
A Windows PowerShell beépülő modul egy Microsoft .NET-keretrendszer-szerelvény, amely Windows PowerShell-szolgáltatókat és parancsmagokat tartalmazhat. A Windows PowerShell alapvető beépülő modulok készletét tartalmazza, de a Windows PowerShell teljesítményét és értékét kibővítheti olyan beépülő modulok hozzáadásával, amelyek olyan szolgáltatókat és parancsmagokat tartalmaznak, amelyeket ön hoz létre vagy kap másoktól.
Beépülő modul hozzáadásakor a benne található parancsmagok és szolgáltatók azonnal elérhetők az aktuális munkamenetben való használatra, de a módosítás csak az aktuális munkamenetre van hatással.
Ha minden jövőbeli munkamenethez hozzá szeretné adni a beépülő modult, mentse a Windows PowerShell-profiljába. A parancsmaggal Export-Console
a beépülő modulneveket egy konzolfájlba is mentheti, majd ezt a mentett konfigurációt használhatja a későbbi munkamenetekben.
A Windows PowerShell 3.0-tól kezdve a PowerShell-lel szállított parancsmagok modulokba vannak csomagolva. Kivételt képez a Microsoft.PowerShell.Core, amely az egyetlen fennmaradó beépülő modul. A Microsoft.PowerShell.Core beépülő modul alapértelmezés szerint minden munkamenetbe betöltődik. A többi modul automatikusan betöltődik az első használatkor. További információ: about_Modules.
Beépülő modul keresése
A Windows PowerShell beépülő modulok listájának lekéréséhez írja be a következőt:
Get-PSSnapin
Az egyes Windows PowerShell-szolgáltatók beépülő moduljának lekéréséhez írja be a következőt:
Get-PSProvider | Format-List name, pssnapin
Ha be szeretné szerezni az összes regisztrált beépülő modult a rendszeren, vagy ellenőrizni szeretné, hogy regisztrálva van-e egy beépülő modul, írja be a következőt:
Get-PSSnapin -registered
A Windows PowerShell beépülő modul parancsmagjainak listájának lekéréséhez írja be a következőt:
Get-Command -Module <snap-in_name>
Beépülő modul telepítése
A beépített beépülő modulok regisztrálva vannak a rendszerben, és hozzáadódnak az alapértelmezett munkamenethez a Windows PowerShell indításakor. Regisztrálnia kell azonban azokat a beépülő modulokat, amelyeket másoktól hoz létre vagy szerez be, majd hozzá kell adnia a beépülő modulokat a munkamenethez.
Beépülő modul hozzáadása az aktuális munkamenethez
Ha regisztrált beépülő modult szeretne hozzáadni az aktuális munkamenethez, használja a Add-PsSnapin
parancsmagot. Ha például hozzá szeretné adni a Microsoft SQL Server beépülő modult a munkamenethez, írja be a következőt:
Add-PSSnapin sql
A parancs befejezése után a beépülő modulban lévő szolgáltatók és parancsmagok elérhetők a munkamenetben. Ezek azonban csak az aktuális munkamenetben érhetők el, kivéve, ha menti őket.
Beépülő modulok mentése
A beépülő modul későbbi Windows PowerShell-munkamenetekben való használatához adja hozzá a parancsot a Add-PsSnapin
Windows PowerShell-profiljához. Vagy exportálja a beépülő modulneveket egy konzolfájlba.
Ha hozzáadja a Add-PSSnapin
parancsot a profiljához, az minden jövőbeli Windows PowerShell-munkamenetben elérhető lesz. Ha a munkamenetben exportálja a beépülő modulok nevét, az exportálási fájlt csak akkor használhatja, ha szüksége van a beépülő modulokra.
Ha hozzá szeretné adni a Add-PsSnapin
parancsot a Windows PowerShell-profiljához, nyissa meg a profilját, illessze be vagy írja be a parancsot, majd mentse a profilt. További információ: about_Profiles.
Ha a beépülő modulokat egy munkamenetből szeretné menteni a konzolfájlban (.psc1
), használja a Export-Console
parancsmagot. Ha például az aktuális munkamenet-konfigurációban lévő beépülő modulokat az aktuális könyvtárban lévő fájlba NewConsole.psc1
szeretné menteni, írja be a következőt:
Export-Console NewConsole
További információ: Exportálási konzol.
A Windows PowerShell megnyitása konzolfájllal
A beépülő modult tartalmazó konzolfájl használatához indítsa el a Windows PowerShellt (powershell.exe
) a parancssorból cmd.exe
vagy egy másik Windows PowerShell-munkamenetben. A PsConsoleFile paraméter használatával adja meg a beépülő modult tartalmazó konzolfájlt. A következő parancs például elindítja a Windows PowerShellt a NewConsole.psc1
konzolfájllal:
PowerShell.exe -psconsolefile NewConsole.psc1
A beépülő modulban lévő szolgáltatók és parancsmagok már használhatók a munkamenetben.
Beépülő modul eltávolítása
Ha el szeretne távolítani egy Windows PowerShell beépülő modult az aktuális munkamenetből, használja a Remove-PsSnapin
parancsmagot. Ha például el szeretné távolítani az SQL Server beépülő modult az aktuális munkamenetből, írja be a következőt:
Remove-PSSnapin sql
Ez a parancsmag eltávolítja a beépülő modult a munkamenetből. A beépülő modul továbbra is betöltődik, de az általa támogatott szolgáltatók és parancsmagok már nem érhetők el.
Beépülő modulok naplózása
A Windows PowerShell 3.0-tól kezdve a Windows PowerShell-modulokban és beépülő modulokban lévő parancsmagok végrehajtási eseményeit rögzítheti a modulok és beépülő modulok $true
LogPipelineExecutionDetails tulajdonságának beállításával.
További információ: about_EventLogs.