Get-PSSnapin

  • Reference
Modul:
Microsoft.PowerShell.Core

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

Syntax

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

Description

Rutina Get-PSSnapin získá moduly snap-in prostředí Windows PowerShell, které byly přidány do aktuální relace nebo které byly zaregistrovány 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 naleznete v tématu Postup registrace rutin, poskytovatelů a hostitelských aplikací.

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í naimportují automaticky a pomocí rutiny Import-Module je můžete importovat.

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.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Windows PowerShell obsahuje následující aliasy pro Get-PSSnapin:

  • gsnp

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, například relace spuštěné rutinou New-PSSession , jsou také relace ve starším stylu, které zahrnují základní moduly snap-in.

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