Get-PSSnapin
Lekéri a Windows PowerShell beépülő modulokat a számítógépen.
Syntax
Default (Alapértelmezett)
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 Framework 2.0-hoz mellékelt InstallUtil eszközt. További információ: Parancsmagok, szolgáltatók és gazdagépalkalmazások regisztrálása az MSDN-kódtárban.
A Windows PowerShell 3.0-tól kezdve a Windows PowerShellben található alapvető parancsok modulokba vannak csomagolva. Kivételt képez 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 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 nélkül Get-PSSnapin lekéri a munkamenethez hozzáadott Windows PowerShell beépülő modulokat.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Ehhez a parancsmaghoz nem csövezhet be bemenetet.
Kimenetek
PSSnapInInfo
Get-PSSnapin minden egyes beépülő modulhoz visszaad egy objektumot.
Jegyzetek
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 vannak csomagolva (PSSnapin). A kivétel 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.
A CreateDefault2 metódusról, amely újabb stílusú munkameneteket hoz létre alapmodulokkal, tekintse meg CreateDefault2 metódus az MSDN-kódtárban.