Add-PSSnapin
Egy vagy több Windows PowerShell-beépülő modult ad hozzá az aktuális munkamenethez.
Syntax
Add-PSSnapin
[-Name] <String[]>
[-PassThru]
[<CommonParameters>]Description
A Add-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 Add-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.ADEz 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 -PassThruEz 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
Az első parancs az aktuális munkamenethez hozzáadott beépülő modulokat kapja, amelyek tartalmazzák a Windows PowerShell-lel telepített beépülő modulokat. Ebben a példában a ManagementFeatures nem lesz visszaadva. Ez azt jelzi, hogy nem lett hozzáadva a munkamenethez.
A második parancs olyan beépülő modulokat kap, amelyek regisztrálva lettek a rendszeren, beleértve azokat is, amelyeket már hozzáadtak a munkamenethez. Nem tartalmazza a Windows PowerShell-lel telepített beépülő modulokat. Ebben az esetben a parancs nem ad vissza beépülő modulokat. Ez azt jelzi, hogy a ManagementFeatures beépülő modul nincs regisztrálva a rendszeren.
A harmadik parancs létrehoz egy aliast( installutil) az InstallUtil eszköz elérési útjára a .NET-keretrendszerben.
A negyedik parancs az InstallUtil eszközzel regisztrálja a beépülő modult. A parancs megadja ManagementCmdlets.dllelérési útját, a beépülő modul fájlnevét vagy modulnevét.
Az ötödik parancs megegyezik a második paranccsal. Ezúttal azt használja, hogy ellenőrizze, hogy a ManagementCmdlets beépülő modul regisztrálva van-e.
A hatodik parancs a Add-PSSnapin parancsmaggal adja hozzá a ManagementFeatures beépülő modult a munkamenethez. A beépülő modul nevét, a ManagementFeaturest adja meg, nem a fájlnevet.
Annak ellenőrzéséhez, hogy a beépülő modul hozzá lett-e adva a munkamenethez, a hetedik parancs a Get-Command parancsmag Modul paraméterét használja. Megjeleníti azokat az elemeket, amelyeket egy beépülő modul vagy modul adott hozzá a munkamenethez.
A parancsmag által visszaadott objektum Get-Command tulajdonságával is megkeresheti azt a beépülő modult vagy modult, amelyből a parancsmag származik. A nyolcadik parancs pontjellel keresi meg a Set-Alias parancsmag PSSnapin tulajdonságának értékét.
PS C:\> Get-PSSnapin
PS C:\> Get-PSSnapin -Registered
PS C:\> Set-Alias installutil $Env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll
PS C:\> Get-PSSnapin -Registered
PS C:\> Add-PSSnapin ManagementFeatures
PS C:\> Get-Command -Module ManagementFeatures
PS C:\> (Get-Command Set-Alias).PSSnapinEz 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.
| Típus: | String[] |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | True |
-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.
| 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 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 a Add-PSSnapinkövetkező aliasait tartalmazza:
asnp
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.
További információ a CreateDefault2 metódusról, amely újabb stílusú munkameneteket hoz létre alapmodulokkal, lásd CreateDefault2 metódus.
További információ a beépülő modulokról: about_PSSnapins és Windows PowerShell beépülő modul létrehozása.
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édprogrammal regisztrált beépülő modulokat hozzáadhatja. További információ: Parancsmagok, szolgáltatók és gazdagépalkalmazások regisztrálása.
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 Add-PSSnapin ellenőrzi a beépülő modul verzióját annak ellenőrzéséhez, 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.
