Get-PSSnapin
Lekéri a Windows PowerShell beépülő modulokat a számítógépen.
Syntax
Get-PSSnapin
[[-Name] <String[]>]
[-Registered]
[<CommonParameters>]
Description
A Get-PSSnapin
parancsmag lekéri az aktuális munkamenethez hozzáadott vagy a rendszeren regisztrált Windows PowerShell beépülő modulokat. Ez a parancsmag az észlelés sorrendjében sorolja fel a beépülő modulokat.
Get-PSSnapin
csak regisztrált beépülő modulokat kap. Windows PowerShell beépülő modul regisztrálásához használja a Microsoft .NET-keretrendszer 2.0-s verzióját tartalmazó InstallUtil eszközt. További információ: Parancsmagok, szolgáltatók és gazdagépalkalmazások regisztrálása.
A Windows PowerShell 3.0-tól kezdve a Windows PowerShellben található alapvető parancsok modulokba vannak csomagolva. Kivételt képez a Microsoft.PowerShell.Core, amely egy beépülő modul (PSSnapin).
Alapértelmezés szerint csak a Microsoft.PowerShell.Core beépülő modul lesz hozzáadva a munkamenethez. A modulok importálása az első használatkor automatikusan megtörténik, és a Import-Module
parancsmaggal importálhatja őket.
Példák
1. példa: Az aktuálisan betöltött beépülő modulok lekérése
PS C:\> Get-PSSnapIn
Ez a parancs lekéri a munkamenetbe jelenleg betöltött Windows PowerShell beépülő modulokat. Ide tartoznak a Windows PowerShell-lel telepített beépülő modulok és a munkamenethez hozzáadott beépülő modulok.
2. példa: Regisztrált beépülő modulok lekérése
PS C:\> get-PSSnapIn -Registered
Ez a parancs lekéri a számítógépen regisztrált Windows PowerShell beépülő modulokat, beleértve azokat is, amelyek már hozzá lettek adva a munkamenethez. A kimenet nem tartalmaz olyan beépülő modulokat, amelyek a Windows PowerShell vagy a Windows PowerShell beépülő modul dinamikus csatolású kódtáraival (DLL-ekkel) vannak telepítve, amelyek még nincsenek regisztrálva a rendszeren.
3. példa: Sztringnek megfelelő aktuális beépülő modulok lekérése
PS C:\> Get-PSSnapIn -Name smp*
Ez a parancs lekéri a Windows PowerShell beépülő modulokat az aktuális munkamenetben, amelyek neve smp-vel kezdődik.
Paraméterek
-Name
A beépülő modulok neveinek tömbje. Ez a parancsmag csak a megadott Windows PowerShell beépülő modulokat kapja meg. A helyettesítő karakterek használata engedélyezett.
Típus: | String[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Registered
Azt jelzi, hogy ez a parancsmag akkor is megkapja a rendszeren regisztrált Windows PowerShell beépülő modulokat, ha még nem lettek hozzáadva a munkamenethez.
A Windows PowerShell-lel telepített beépülő modulok nem jelennek meg ebben a listában.
E paraméter Get-PSSnapin
nélkül lekéri a munkamenethez hozzáadott Windows PowerShell beépülő modulokat.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
None
Ehhez a parancsmaghoz nem csövezhet be bemenetet.
Kimenetek
Get-PSSnapin
visszaad egy objektumot minden egyes beépülő modulhoz, amelyet lekér.
Jegyzetek
A Windows PowerShell a következő aliasokat Get-PSSnapin
tartalmazza:
gsnp
A Windows PowerShell 3.0-tól kezdve a Windows PowerShell-lel telepített alapvető parancsok modulokba vannak csomagolva. A Windows PowerShell 2.0-ban és a Windows PowerShell későbbi verzióiban régebbi stílusú munkameneteket létrehozó gazdagépprogramokban az alapvető parancsok beépülő modulokba (PSSnapin) vannak csomagolva. Kivételt képez a Microsoft.PowerShell.Core, amely mindig beépülő modul. A távoli munkamenetek, például a New-PSSession
parancsmag által indítottak is régebbi stílusú munkamenetek, amelyek alapvető beépülő modulokat tartalmaznak.
Az alapmodulokkal újabb stílusú munkameneteket létrehozó CreateDefault2 metódusról további információt a CreateDefault2 metódus című témakörben talál.