Sdílet prostřednictvím

Get-PSSnapin

  • Reference
Modul:
Microsoft.PowerShell.Core

Získá moduly snap-in windows PowerShellu v počítači.

Syntaxe

Get-PSSnapin
   [[-Name] <String[]>]
   [-Registered]
   [<CommonParameters>]

Description

Rutina Get-PSSnapin získá moduly snap-in windows PowerShellu přidané do aktuální relace nebo zaregistrované v systému. Tato rutina zobrazí seznam modulů snap-in v pořadí, v jakém jsou zjištěny.

Get-PSSnapin získá jenom registrované moduly snap-in. Pokud chcete zaregistrovat modul snap-in prostředí Windows PowerShell, použijte nástroj InstallUtil, který je součástí rozhraní Microsoft .NET Framework 2.0. Další informace najdete v tématu Postup registrace rutin, poskytovatelů a hostitelských aplikací v knihovně MSDN.

Počínaje Windows PowerShellem 3.0 jsou základní příkazy, které jsou součástí Windows PowerShellu, zabalené v modulech. Výjimkou je Microsoft.PowerShell.Core, což je modul snap-in (PSSnapin). Ve výchozím nastavení se do relace přidá jenom modul snap-in Microsoft.PowerShell.Core. Moduly se při prvním použití importují automaticky a můžete je importovat pomocí rutiny Import-Module.

Příklady

Příklad 1: Získání modulů snap-in, které jsou aktuálně načteny

PS C:\> Get-PSSnapIn

Tento příkaz získá moduly snap-in prostředí Windows PowerShell, které jsou aktuálně načteny v relaci. To zahrnuje moduly snap-in, které jsou nainstalované ve Windows PowerShellu, a moduly, které byly přidány do relace.

Příklad 2: Získání zaregistrovaných modulů snap-in

PS C:\> get-PSSnapIn -Registered

Tento příkaz získá moduly snap-in windows PowerShellu, které byly zaregistrované v počítači, včetně těch, které už byly přidány do relace. Výstup neobsahuje moduly snap-in, které jsou nainstalované pomocí prostředí Windows PowerShell nebo modulu snap-in knihoven DLL (Dynamic Link Library), které ještě nejsou v systému zaregistrované.

Příklad 3: Získání aktuálních modulů snap-in, které odpovídají řetězci

PS C:\> Get-PSSnapIn -Name smp*

Tento příkaz získá moduly snap-in windows PowerShellu v aktuální relaci, které mají názvy začínající smp.

Parametry

-Name

Určuje pole názvů modulů snap-in. Tato rutina získá jenom zadané moduly snap-in Windows PowerShellu. Jsou povoleny zástupné znaky.

Typ:String[]
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Registered

Označuje, že tato rutina získá moduly snap-in prostředí Windows PowerShell, které byly zaregistrované v systému, i když ještě nebyly přidány do relace.

Moduly snap-in, které jsou nainstalované v prostředí Windows PowerShell, se v tomto seznamu nezobrazí.

Bez tohoto parametru Get-PSSnapin získá moduly snap-in Prostředí Windows PowerShell, které byly přidány do relace.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

PSSnapInInfo

Get-PSSnapin vrátí objekt pro každý modul snap-in, který získá.

Poznámky

  • Počínaje Windows PowerShellem 3.0 se základní příkazy nainstalované s Windows PowerShellem zabalí do modulů. V prostředí Windows PowerShell 2.0 a v hostitelských programech, které vytvářejí relace staršího stylu v novějších verzích Windows PowerShellu, se základní příkazy zabalí do modulů snap-in (PSSnapin). Výjimkou je Microsoft.PowerShell.Core, což je vždy modul snap-in. Vzdálené relace, jako jsou relace spuštěné rutinou New-PSSession, jsou také relace ve starším stylu, které zahrnují základní moduly snap-in.

    Informace o CreateDefault2 metoda, která vytváří novější relace se základními moduly, naleznete v tématu CreateDefault2 Metoda v knihovně MSDN.