Add-PSSnapin

  • Referencia
Modul:
Microsoft.PowerShell.Core

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 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 első használatkor automatikusan megtörténik, és az 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 Registered paraméterrel a regisztrált beépülő modulok mindegyikét képviselő objektumok lekéréséhez. A folyamatkezelő (|) átadja az eredményt a munkamenethez hozzáadónakAdd-PSSnapin. 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ának .NET-keretrendszer.

A negyedik parancs az InstallUtil eszközzel regisztrálja a beépülő modult. A parancs megadja a ManagementCmdlets.dll elé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 PSSnapin tulajdonságával is megkeresheti azt a beépülő modult vagy modult, amelyből a parancsmag származik. A nyolcadik parancs pontfeliratot használ a Set-Alias parancsmag PSSnapin tulajdonságának értékének megkereséséhez.

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).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.dll nevű 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 következőt Get-PSSnapin -Registered: .

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 következő aliasokat Add-PSSnapintartalmazza:

  • 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. 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.

További információ a beépülő modulokról: about_PSSnapins és Windows PowerShell beépülő modul létrehozása.

Add-PSSnapin A beépülő modult csak az aktuális munkamenethez adja hozzá. 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 következőt Get-PSSnapin -Registered: .

A beépülő modul hozzáadása előtt ellenőrizze a beépülő modul verzióját annak ellenőrzéséhez, Add-PSSnapin hogy kompatibilis-e a Windows PowerShell aktuális verziójával. Ha a beépülő modul nem felel meg a verzióellenőrzésnek, a Windows PowerShell hibát jelez.