Add-PSSnapin
Egy vagy több Windows PowerShell-beépülő modult ad hozzá az aktuális munkamenethez.
Syntax
Default (Alapértelmezett)
Add-PSSnapin
[-Name] <String[]>
[-PassThru]
[<CommonParameters>]
Description
A PSSnapin parancsmag regisztrált Windows PowerShell beépülő modulokat ad hozzá az aktuális munkamenethez. A beépülő modulok hozzáadása után használhatja azokat a parancsmagokat és szolgáltatókat, amelyeket a beépülő modulok támogatnak az aktuális munkamenetben.
Ha hozzá szeretné adni a beépülő modult az összes jövőbeli Windows PowerShell-munkamenethez, adjon hozzá egy PSSnapin parancsot a Windows PowerShell-profiljához. További információ: about_Profiles.
A Windows PowerShell 3.0-tól kezdődően 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: Beépülő modulok hozzáadása
PS C:\> Add-PSSnapIn -Name Microsoft.Exchange, Microsoft.Windows.AD
Ez a parancs hozzáadja a Microsoft Exchange és az Active Directory beépülő modulokat az aktuális munkamenethez.
2. példa: Az összes regisztrált beépülő modul hozzáadása
PS C:\> Get-PSSnapin -Registered | Add-PSSnapin -Passthru
Ez a parancs hozzáadja az összes regisztrált Windows PowerShell-beépülő modult a munkamenethez. A Get-PSSnapin parancsmagot használja a Regisztrált paraméterrel az egyes regisztrált beépülő modulok objektumainak lekéréséhez. A folyamatkezelő (|) átadja az eredményt Add-PSSnapin, amely hozzáadja őket a munkamenethez. A PassThru paraméter olyan objektumokat ad vissza, amelyek a hozzáadott beépülő modulok mindegyikét képviselik.
3. példa: Beépülő modul regisztrálása és hozzáadása
The first command gets snap-ins that have been added to the current session that include the snap-ins that are installed with Windows PowerShell. In this example, ManagementFeatures is not returned. This indicates that it has not been added to the session.
PS C:\> Get-PSSnapin
The second command gets snap-ins that have been registered on your system, which includes those that have already been added to the session. It does not include the snap-ins that are installed with Windows PowerShell. In this case, the command does not return any snap-ins. This indicates that the ManagementFeatures snapin has not been registered on the system.
PS C:\> Get-PSSnapin -Registered
The third command creates an alias, installutil, for the path of the InstallUtil tool in .NET Framework.
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe
The fourth command uses the InstallUtil tool to register the snap-in. The command specifies the path of ManagementCmdlets.dll, the file name or module name of the snap-in.
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll
The fifth command is the same as the second command. This time, you use it to verify that the ManagementCmdlets snap-in is registered.
PS C:\> Get-PSSnapin -Registered
The sixth command uses the **Add-PSSnapin** cmdlet to add the ManagementFeatures snap-in to the session. It specifies the name of the snap-in, ManagementFeatures, not the file name.
PS C:\> add-pssnapin ManagementFeatures
To verify that the snap-in is added to the session, the seventh command uses the *Module* parameter of the Get-Command cmdlet. It displays the items that were added to the session by a snap-in or module.
PS C:\> Get-Command -Module ManagementFeatures
You can also use the **PSSnapin** property of the object that the **Get-Command** cmdlet returns to find the snap-in or module in which a cmdlet originated. The eighth command uses dot notation to find the value of the PSSnapin property of the Set-Alias cmdlet.
PS C:\> (Get-Command Set-Alias).pssnapin
Ez a példa bemutatja egy beépülő modul regisztrálásának folyamatát a rendszeren, majd hozzáadja azt a munkamenethez. A managementFeaturest használja, amely egy fiktív beépülő modul, amely egy ManagementCmdlets.dllnevű fájlban van implementálva.
Paraméterek
-Name
Megadja a beépülő modul nevét. Ez a név, nem pedig a AssemblyName vagy a ModuleName. Helyettesítő karakterek használata engedélyezett.
A regisztrált beépülő modulok nevének megkereséséhez írja be a Get-PSSnapin -Registered.
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ő: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
Azt jelzi, hogy ez a parancsmag egy olyan objektumot ad vissza, amely az egyes hozzáadott beépülő modulokat jelöli. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
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 lehet objektumokat csövezni.
Kimenetek
None or System.Management.Automation.PSSnapInInfo
Ez a parancsmag egy PSSnapInInfo objektumot ad vissza, amely a beépülő modult jelöli, ha megadja a PassThru paramétert. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
A Windows PowerShell 3.0-tól kezdődően 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 (PSSnapins) vannak csomagolva. 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.
További információ a beépülő modulokról: about_PSSnapins és Windows PowerShell beépülő modul létrehozása az MSDN-kódtárban.
Add-PSSnapin csak az aktuális munkamenethez adja hozzá a beépülő modult. Ha minden Windows PowerShell-munkamenethez hozzá szeretné adni a beépülő modult, adja hozzá a Windows PowerShell-profiljához. További információ: about_Profiles.
A Microsoft .NET-keretrendszer telepítési segédprogramjának használatával bármilyen regisztrált beépülő modult hozzáadhat. További információ: Parancsmagok, szolgáltatók és gazdagépalkalmazások regisztrálása az MSDN-kódtárban.
A számítógépen regisztrált beépülő modulok listájának lekéréséhez írja be a
Get-PSSnapin -Registered.Beépülő modul hozzáadása előtt PSSnapin ellenőrzi a beépülő modul verzióját, hogy ellenőrizze, hogy kompatibilis-e a Windows PowerShell jelenlegi verziójával. Ha a beépülő modul nem felel meg a verzióellenőrzésnek, a Windows PowerShell hibát jelez.