Add-PSSnapin

Modül:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Varsayılan) 

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

Description

Add-PSSnapin cmdlet'i 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 komutu 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. 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 bunları 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 Registered parametresiyle Get-PSSnapin cmdlet'ini kullanır. İşlem hattı işleci (|) sonucu Add-PSSnapingeçirir ve bu da bunları oturuma ekler. 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.dllyolunu, 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 Add-PSSnapin cmdlet'ini kullanır. 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'in 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 özelliğini kullanarak bir cmdlet'in kaynaklandığı ek bileşeni veya modülü bulabilirsiniz. Sekizinci komut, Set-Alias cmdlet'in 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.dlladlı bir dosyada uygulanan kurgusal bir 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 Get-PSSnapin -Registeredyazın.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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, Add-PSSnapiniçin aşağıdaki diğer adları iç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 . Ayrıca, New-PSSession cmdlet'i tarafından başlatılanlar gibi uzak oturumlar, çekirdek ek bileşenleri içeren eski stildeki oturumlardır.

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

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 Get-PSSnapin -Registeredyazın.

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.