Add-PSSnapin

  • Başvuru
Modül:
Microsoft.PowerShell.Core

Geçerli oturuma bir veya daha fazla Windows PowerShell ek bileşeni ekler.

Syntax

Add-PSSnapin
   [-Name] <String[]>
   [-PassThru]
   [<CommonParameters>]

Description

cmdlet'i Add-PSSnapin geçerli oturuma kayıtlı Windows PowerShell ek bileşenleri ekler. Ek bileşenler eklendikten sonra, ek bileşenlerinin geçerli oturumda desteklediği cmdlet'leri ve sağlayıcıları kullanabilirsiniz.

Ek bileşeni gelecekteki tüm Windows PowerShell oturumlarına eklemek için Windows PowerShell profilinize bir Add-PSSnapin komut ekleyin. Daha fazla bilgi için bkz . about_Profiles.

Windows PowerShell 3.0'da başlayarak, Windows PowerShell'de bulunan temel komutlar modüllerde paketlenir. Özel durum, ek bileşen (PSSnapin) olan Microsoft.PowerShell.Core'dur. Varsayılan olarak oturuma yalnızca Microsoft.PowerShell.Core ek bileşeni eklenir. Modüller ilk kullanımda otomatik olarak içeri aktarılır ve içeri aktarmak için Import-Module cmdlet'ini kullanabilirsiniz.

Örnekler

Örnek 1: Ek bileşen ekleme

PS C:\> Add-PSSnapIn -Name Microsoft.Exchange, Microsoft.Windows.AD

Bu komut, Microsoft Exchange ve Active Directory ek bileşenlerini geçerli oturuma ekler.

Örnek 2: Tüm kayıtlı ek bileşenleri ekleme

PS C:\> Get-PSSnapin -Registered | Add-PSSnapin -Passthru

Bu komut tüm kayıtlı Windows PowerShell ek bileşenlerini oturuma ekler. Kayıtlı ek bileşenleri temsil eden nesneleri almak için Kayıtlı parametresiyle Get-PSSnapin cmdlet'ini kullanır. İşlem hattı işleci (|), sonucu oturumuna Add-PSSnapinekleyen öğesine geçirir. PassThru parametresi, eklenen ek bileşenleri temsil eden nesneleri döndürür.

Örnek 3: Ek bileşeni kaydetme ve ekleme

İlk komut, Windows PowerShell ile yüklenen ek bileşenleri içeren geçerli oturuma eklenmiş ek bileşenleri alır. Bu örnekte, ManagementFeatures döndürülmedi. Bu, oturuma eklenmediğini gösterir.

İkinci komut, oturuma zaten eklenmiş olanları içeren sisteminizde kayıtlı ek bileşenleri alır. Windows PowerShell ile yüklenen ek bileşenleri içermez. Bu durumda, komut herhangi bir ek bileşen döndürmez. Bu, ManagementFeatures ek bileşeninin sistemde kayıtlı olmadığını gösterir.

Üçüncü komut, .NET Framework'teki InstallUtil aracının yolu için installutil adlı bir diğer ad oluşturur.

Dördüncü komut, ek bileşeni kaydetmek için InstallUtil aracını kullanır. komutu ManagementCmdlets.dll yolunu, ek bileşenin dosya adını veya modül adını belirtir.

Beşinci komut, ikinci komutla aynıdır. Bu kez, YönetimCmdlet'leri ek bileşeninin kayıtlı olduğunu doğrulamak için bunu kullanırsınız.

Altıncı komut, yönetim özellikleri ek bileşenini oturuma eklemek için cmdlet'ini kullanır Add-PSSnapin . Dosya adını değil, yönetim özellikleri ek bileşeninin adını belirtir.

Ek bileşenin oturuma eklendiğini doğrulamak için yedinci komut Get-Command cmdlet'inin Module parametresini kullanır. Bir ek bileşen veya modül tarafından oturuma eklenen öğeleri görüntüler.

Ayrıca, cmdlet'in döndürdüğü nesnenin Get-Command PSSnapin özelliğini kullanarak bir cmdlet'in kaynaklandığı ek bileşeni veya modülü bulabilirsiniz. Sekizinci komut, Set-Alias cmdlet'inin PSSnapin özelliğinin değerini bulmak için noktalı gösterimi kullanır.

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

Bu örnekte, sisteminize ek bileşeni kaydetme ve ardından bunu oturumunuza ekleme işlemi gösterilmektedir. ManagementCmdlets.dll adlı bir dosyada uygulanan kurgusal ek bileşen olan ManagementFeatures'ı kullanır.

Parametreler

-Name

Ek bileşenin adını belirtir. Bu, AssemblyName veya ModuleName değil Ad'dır. Joker karakterlere izin verilir.

Sisteminizdeki kayıtlı ek bileşenlerinin adlarını bulmak için yazın Get-PSSnapin -Registered.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

Bu cmdlet'in eklenen her ek bileşeni temsil eden bir nesne döndürdüğünü gösterir. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None or System.Management.Automation.PSSnapInInfo

Bu cmdlet, PassThru parametresini belirtirseniz ek bileşeni temsil eden bir PSSnapInInfo nesnesi döndürür. Aksi takdirde, bu cmdlet herhangi bir çıkış oluşturmaz.

Notlar

Windows PowerShell için aşağıdaki diğer adları Add-PSSnapiniçerir:

  • asnp

Windows PowerShell 3.0'da başlayarak, Windows PowerShell ile yüklenen temel komutlar modüller halinde paketlenir. Windows PowerShell 2.0'da ve Windows PowerShell'in sonraki sürümlerinde eski stilde oturumlar oluşturan konak programlarında, temel komutlar ek bileşenlerde (PSSnapins) paketlenir. Özel durum, her zaman ek bileşen olan Microsoft.PowerShell.Core'dur. Ayrıca, New-PSSession cmdlet'i tarafından başlatılanlar gibi uzak oturumlar, çekirdek ek bileşenleri içeren eski stildeki oturumlardır.

Çekirdek modüllerle daha yeni stil oturumları oluşturan CreateDefault2 yöntemi hakkında bilgi için bkz. CreateDefault2 Yöntemi.

Ek bileşenler hakkında daha fazla bilgi için bkz . about_PSSnapins ve Windows PowerShell Ek Bileşeni Oluşturma.

Add-PSSnapin ek bileşeni yalnızca geçerli oturuma ekler. Ek bileşeni tüm Windows PowerShell oturumlarına eklemek için Windows PowerShell profilinize ekleyin. Daha fazla bilgi için bkz . about_Profiles.

Microsoft .NET Framework yükleme yardımcı programını kullanarak kaydedilmiş herhangi bir ek bileşen ekleyebilirsiniz. Daha fazla bilgi için bkz . Cmdlet'leri, Sağlayıcıları ve Konak Uygulamalarını Kaydetme.

Bilgisayarınızda kayıtlı ek bileşenler listesini almak için yazın Get-PSSnapin -Registered.

Ek bileşen eklemeden önce, Add-PSSnapin ek bileşenin windows PowerShell'in geçerli sürümüyle uyumlu olduğunu doğrulamak için sürümünü denetler. Ek bileşen sürüm denetiminde başarısız olursa, Windows PowerShell bir hata bildirir.