Informace o PSSnapins

Článek
06/21/2023

KRÁTKÝ POPIS

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

DLOUHÝ POPIS

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

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

Pokud chcete modul snap-in přidat do všech budoucích relací, uložte ho do Windows PowerShell profilu. Můžete také použít rutinu Export-Console k uložení názvů modulů snap-in do souboru konzoly a jejich následnému použití v budoucích relacích. Můžete dokonce uložit několik souborů konzoly, z nichž každý má jinou sadu modulů snap-in.

POZNÁMKA: Windows PowerShell moduly snap-in (PSSnapins) jsou k dispozici pro použití v Windows PowerShell 3.0 a Windows PowerShell 2.0. V dalších verzích můžou být změněné nebo nedostupné. K zabalení rutin a zprostředkovatelů Windows PowerShell použijte moduly. Informace o vytváření modulů a převodu modulů snap-in na moduly najdete v tématu Psaní modulu Windows PowerShell.

HLEDÁNÍ MODULŮ SNAP-IN

Pokud chcete získat seznam Windows PowerShell modulů snap-in v počítači, zadejte:

Get-PSSnapin

Pokud chcete získat modul snap-in pro každého poskytovatele Windows PowerShell, zadejte:

Get-PSProvider | Format-List name, pssnapin

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

Get-Command -Module <snap-in_name>

INSTALACE MODULU SNAP-IN

Integrované moduly snap-in se registrují v systému a při spuštění Windows PowerShell 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 je přidat do relace.

REGISTRACE MODULU SNAP-IN

Modul snap-in Windows PowerShell je program napsaný v jazyce rozhraní .NET Framework, který je zkompilován do souboru .dll. Pokud chcete v modulu snap-in používat zprostředkovatele a rutiny, musíte nejprve modul snap-in zaregistrovat (přidat ho do registru).

Většina modulů snap-in zahrnuje instalační program (soubor .exe nebo .msi), který za vás zaregistruje soubor .dll. Pokud ale modul snap-in obdržíte jako soubor .dll, můžete ho zaregistrovat ve svém systému. Další informace najdete v tématu Postup registrace rutin, zprostředkovatelů a hostitelských aplikací v knihovně MSDN.

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

Get-PSSnapin -registered

PŘIDÁNÍ MODULU SNAP-IN DO AKTUÁLNÍ RELACE

Pokud chcete přidat zaregistrovaný modul snap-in do aktuální relace, použijte rutinu Add-PSSnapin. Pokud například chcete do relace přidat modul snap-in Microsoft SQL Server, zadejte:

Add-PSSnapin sql

Po dokončení příkazu budou v relaci k dispozici zprostředkovatelé a rutiny v modulu snap-in. Jsou však k dispozici pouze v aktuální relaci, pokud je neuložíte.

UKLÁDÁNÍ MODULŮ SNAP-IN

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

Pokud do profilu přidáte příkaz Add-PSSnapin, bude k dispozici ve všech budoucích Windows PowerShell relacích. 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 příkaz Add-PSSnapin do profilu Windows PowerShell, otevřete profil, vložte nebo zadejte příkaz a pak profil uložte. Další informace najdete v tématu about_Profiles.

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

Export-Console NewConsole

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

OTEVŘENÍ WINDOWS POWERSHELLU SE SOUBOREM KONZOLY

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

PowerShell.exe -psconsolefile NewConsole.psc1

Zprostředkovatelé a rutiny v modulu snapin jsou teď k dispozici pro použití v relaci.

ODEBRÁNÍ MODULU SNAP-IN

Pokud chcete z aktuální relace odebrat modul snap-in Windows PowerShell, použijte rutinu Remove-PSSnapin. Pokud chcete například odebrat modul snap-in SQL Server 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.

PŘEDDEFINOVANÉ PŘÍKAZY

V Windows PowerShell 2.0 a ve starších hostitelských programech v Windows PowerShell 3.0 a novějších se integrované příkazy nainstalované s Windows PowerShell zabalí do modulů snap-in, které se automaticky přidají do každé relace Windows PowerShell.

Počínaje Windows PowerShell 3.0 v novějších hostitelských programech – těch, které spouští relace pomocí metody InitialSessionState.CreateDefault2 – jsou integrované příkazy zabalené v modulech. Výjimkou je Microsoft.PowerShell.Core, který se vždy zobrazí jako modul snap-in. Modul snap-in Core je ve výchozím nastavení součástí každé relace. Předdefinované moduly se automaticky načtou při prvním použití.

POZNÁMKA: Vzdálené relace, včetně relací spouštěných pomocí rutiny New-PSSession, jsou relace staršího stylu, ve kterých jsou integrované příkazy zabaleny do modulů snap-in.

S Windows PowerShell se nainstalují následující moduly snap-in (moduly).

Microsoft.PowerShell.Core – obsahuje zprostředkovatele a rutiny používané ke správě základních funkcí Windows PowerShell. Zahrnuje zprostředkovatele FileSystem, Registry, Alias, Environment, Function a Variable a základní rutiny, jako jsou Get-Help, Get-Command a Get-History.
Microsoft.PowerShell.Host – obsahuje rutiny používané hostitelem Windows PowerShell, například Start-Transcript a Stop-Transcript.
Microsoft.PowerShell.Management – obsahuje rutiny, jako jsou Get-Service a Get-ChildItem, které se používají ke správě funkcí systému Windows.
Microsoft.PowerShell.Security – obsahuje zprostředkovatele certifikátů a rutiny používané ke správě zabezpečení Windows PowerShell, například Get-Acl, Get-AuthenticodeSignature a ConvertTo-SecureString.
Microsoft.PowerShell.Utility – obsahuje rutiny používané k manipulaci s objekty a daty, například Get-Member, Write-Host a Format-List.
Microsoft.WSMan.Management – obsahuje zprostředkovatele WSMan a rutiny, které spravují službu Vzdálená správa systému Windows, například Connect-WSMan a Enable-WSManCredSSP.

PROTOKOLOVÁNÍ UDÁLOSTÍ MODULU SNAP-IN

Počínaje verzí Windows PowerShell 3.0 můžete zaznamenávat události spuštění rutin v modulech Windows PowerShell a modulech snap-in nastavením vlastnosti LogPipelineExecutionDetails modulů a modulů snap-in na hodnotu TRUE. Další informace najdete v tématu about_EventLogs.