about_PSSnapins

  • Cikk

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 $trueLogPipelineExecutionDetails tulajdonságának beállításával. További információ: about_EventLogs.

Lásd még