about_PSSnapins

  • Článek

Krátký popis

Popisuje moduly snap-in Windows PowerShellu a ukazuje, jak je používat a spravovat.

Dlouhý popis

Modul snap-in Prostředí Windows PowerShell je sestavení Rozhraní Microsoft .NET Framework, které může obsahovat zprostředkovatele a rutiny Prostředí Windows PowerShell. Windows PowerShell obsahuje sadu základních modulů snap-in, ale výkon a hodnotu Prostředí Windows PowerShell můžete rozšířit přidáním modulů snap-in obsahujících zprostředkovatele a rutiny, které vytvoříte nebo získáte od ostatních.

Když přidáte modul snap-in, jsou rutiny a poskytovatelé, které obsahuje, okamžitě dostupné pro použití v aktuální relaci, ale změna ovlivní pouze aktuální relaci.

Pokud chcete modul snap-in přidat do všech budoucích relací, uložte ho do profilu Windows PowerShellu. Pomocí rutiny Export-Console můžete také uložit názvy modulů snap-in do souboru konzoly a pak použít tuto uloženou konfiguraci v budoucích relacích.

Počínaje Windows PowerShellem 3.0 se rutiny, které jsou dodávány pomocí PowerShellu, zabalí do modulů. Výjimkou je Microsoft.PowerShell.Core, což je jediný zbývající modul snap-in. Modul snap-in Microsoft.PowerShell.Core se ve výchozím nastavení načte v každé relaci. Zbývající moduly se načítají automaticky při prvním použití. Další informace najdete v tématu about_Modules.

Vyhledání modulu snap-in

Pokud chcete získat seznam modulů snap-in windows PowerShellu na počítači, zadejte:

Get-PSSnapin

Pokud chcete získat modul snap-in pro každého zprostředkovatele Windows PowerShellu, zadejte:

Get-PSProvider | Format-List name, pssnapin

Pokud chcete získat všechny zaregistrované moduly snap-in v systému nebo ověřit, že je modul snap-in zaregistrovaný, zadejte:

Get-PSSnapin -registered

Pokud chcete získat seznam rutin v modulu snap-in Prostředí Windows PowerShell, zadejte:

Get-Command -Module <snap-in_name>

Instalace modulu snap-in

Integrované moduly snap-in se zaregistrují v systému a při spuštění Windows PowerShellu se přidají do výchozí relace. Musíte ale zaregistrovat moduly snap-in, které vytvoříte nebo získáte od ostatních, a pak do relace přidat moduly snap-in.

Přidání modulu snap-in do aktuální relace

K přidání registrovaného modulu snap-in do aktuální relace použijte rutinu Add-PsSnapin . Pokud chcete například přidat modul snap-in Microsoft SQL Server do relace, zadejte:

Add-PSSnapin sql

Po dokončení příkazu jsou v relaci k dispozici poskytovatelé a rutiny v modulu snap-in. Jsou ale dostupné jenom v aktuální relaci, pokud je neuložíte.

Uložení modulů snap-in

Pokud chcete použít modul snap-in v budoucích relacích Windows PowerShellu, přidejte Add-PsSnapin tento příkaz do profilu Prostředí Windows PowerShell. Nebo exportujte názvy modulů snap-in do souboru konzoly.

Pokud do svého profilu přidáte Add-PSSnapin příkaz, bude dostupný ve všech budoucích relacích Windows PowerShellu. Pokud exportujete názvy modulů snap-in v relaci, můžete soubor exportu použít jenom v případě, že potřebujete moduly snap-in.

Pokud chcete přidat Add-PsSnapin příkaz do profilu Windows PowerShellu, otevřete profil, vložte ho nebo zadejte a pak profil uložte. Další informace najdete v tématu about_Profiles.

Pokud chcete moduly snap-in uložit z relace v souboru konzoly (.psc1), použijte rutinu Export-Console . Pokud chcete například uložit moduly snap-in v konfiguraci aktuální relace do NewConsole.psc1 souboru v aktuálním adresáři, zadejte:

Export-Console NewConsole

Další informace naleznete v tématu Export-Console.

Otevření Windows PowerShellu pomocí souboru konzoly

Pokud chcete použít soubor konzoly, který obsahuje modul snap-in, spusťte Prostředí Windows PowerShell (powershell.exe) z příkazového řádku nebo cmd.exe v jiné relaci Prostředí Windows PowerShell. Pomocí parametru PsConsoleFile zadejte soubor konzoly, který obsahuje modul snap-in. Například následující příkaz spustí Prostředí Windows PowerShell se souborem konzoly NewConsole.psc1 :

PowerShell.exe -psconsolefile NewConsole.psc1

Poskytovatelé a rutiny v modulu snap-in jsou teď k dispozici pro použití v relaci.

Odebrání modulu snap-in

Pokud chcete odebrat modul snap-in Windows PowerShellu z aktuální relace, použijte tuto rutinu Remove-PsSnapin . Pokud chcete například odebrat modul snap-in SQL Serveru z aktuální relace, zadejte:

Remove-PSSnapin sql

Tato rutina odebere modul snap-in z relace. Modul snap-in je stále načtený, ale poskytovatelé a rutiny, které podporuje, už nejsou k dispozici.

Protokolování událostí modulu snap-in

Počínaje windows PowerShellem 3.0 můžete zaznamenávat události spouštění rutin v modulech a modulech Modulu snap-in windows PowerShellu nastavením vlastnosti LogPipelineExecutionDetails modulů a modulů snap-in k $true. Další informace najdete v tématu about_EventLogs.

Viz také