about_PSSnapins
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.
