about_PSSnapins
Kısa açıklama
ek bileşenleri Windows PowerShell açıklar ve bunların nasıl kullanılacağını ve yönetileceğini gösterir.
Uzun açıklama
Windows PowerShell ek bileşeni, Windows PowerShell sağlayıcıları ve/veya cmdlet'leri içeren bir Microsoft .NET Framework derlemesidir. Windows PowerShell bir dizi temel ek bileşen içerir, ancak oluşturduğunuz veya başkalarından edindiğiniz sağlayıcılar ve cmdlet'ler içeren ek bileşenler ekleyerek Windows PowerShell gücünü ve değerini genişletebilirsiniz.
Ek bileşen eklediğinizde, içerdiği cmdlet'ler ve sağlayıcılar geçerli oturumda hemen kullanılabilir ancak değişiklik yalnızca geçerli oturumu etkiler.
Ek bileşeni gelecekteki tüm oturumlara eklemek için Windows PowerShell profilinize kaydedin. Ek bileşen adlarını bir konsol dosyasına kaydetmek için Export-Console cmdlet'ini de kullanabilir ve ardından gelecek oturumlarda kullanabilirsiniz. Her biri farklı bir ek bileşen kümesine sahip birden çok konsol dosyasını bile kaydedebilirsiniz.
NOT: Windows PowerShell ek bileşenleri (PSSnapins) Windows PowerShell 3.0 ve Windows PowerShell 2.0'da kullanılabilir. Bunlar sonraki sürümlerde değiştirilmiş veya kullanılamayabilir. Windows PowerShell cmdlet'lerini ve sağlayıcılarını paketlemek için modülleri kullanın. Modül oluşturma ve ek bileşenleri modüllere dönüştürme hakkında bilgi için bkz. Windows PowerShell Modülü Yazma.
EK BILEŞENLERI BULMA
Bilgisayarınızdaki Windows PowerShell ek bileşenlerinin listesini almak için şunu yazın:
Get-PSSnapin
Her Windows PowerShell sağlayıcısının ek bileşenini almak için şunu yazın:
Get-PSProvider | Format-List name, pssnapin
Windows PowerShell ek bileşenindeki cmdlet'lerin listesini almak için şunu yazın:
Get-Command -Module <snap-in_name>
EK BILEŞEN YÜKLEME
Yerleşik ek bileşenler sisteme kaydedilir ve Windows PowerShell başlattığınızda varsayılan oturuma eklenir. Ancak, oluşturduğunuz veya başkalarından aldığınız ek bileşenleri kaydetmeniz ve ardından ek bileşenleri oturumunuza eklemeniz gerekir.
EK BILEŞENI KAYDETME
Windows PowerShell ek bileşeni, .dll bir dosyaya derlenmiş .NET Framework dilde yazılmış bir programdır. Sağlayıcıları ve cmdlet'leri bir ek bileşende kullanmak için önce ek bileşeni kaydetmeniz (kayıt defterine eklemeniz) gerekir.
Çoğu ek bileşen, .dll dosyasını sizin için kaydeden bir yükleme programı (.exe veya .msi dosyası) içerir. Ancak ek bileşeni .dll dosyası olarak alırsanız sisteminize kaydedebilirsiniz. Daha fazla bilgi için bkz. Cmdlet'leri, Sağlayıcıları ve Konak Uygulamalarını Kaydetme.
Sisteminizdeki tüm kayıtlı ek bileşenleri almak veya bir ek bileşenin kaydedildiğini doğrulamak için şunu yazın:
Get-PSSnapin -registered
EK BILEŞENI GEÇERLI OTURUMA EKLEME
Geçerli oturuma kayıtlı bir ek bileşen eklemek için Add-PsSnapin cmdlet'ini kullanın. Örneğin, Oturuma Microsoft SQL Server ek bileşenini eklemek için şunu yazın:
Add-PSSnapin sql
Komut tamamlandıktan sonra, ek bileşendeki sağlayıcılar ve cmdlet'ler oturumda kullanılabilir. Ancak, kaydetmediğiniz sürece yalnızca geçerli oturumda kullanılabilirler.
EK BILEŞENLERI KAYDETME
Gelecekteki Windows PowerShell oturumlarında ek bileşen kullanmak için Windows PowerShell profilinize Add-PsSnapin komutunu ekleyin. Alternatif olarak, ek bileşen adlarını bir konsol dosyasına da aktarabilirsiniz.
profilinize Add-PSSnapin komutu eklerseniz, gelecekteki tüm Windows PowerShell oturumlarında kullanılabilir. Oturumunuzda ek bileşen adlarını dışarı aktarırsanız, dışarı aktarma dosyasını yalnızca ek bileşenlere ihtiyacınız olduğunda kullanabilirsiniz.
Windows PowerShell profilinize Add-PsSnapin komutu eklemek için profilinizi açın, komutu yapıştırın veya yazın ve ardından profili kaydedin. Daha fazla bilgi için bkz. about_Profiles.
Bir oturumdaki ek bileşenleri konsol dosyasında (.psc1) kaydetmek için Export-Console cmdlet'ini kullanın. Örneğin, geçerli oturum yapılandırmasındaki ek bileşenleri geçerli dizindeki NewConsole.psc1 dosyasına kaydetmek için şunu yazın:
Export-Console NewConsole
Daha fazla bilgi için bkz. Export-Console.
WINDOWS POWERSHELL'I KONSOL DOSYASıYLA AÇMA
Ek bileşeni içeren bir konsol dosyası kullanmak için, Cmd.exe veya başka bir Windows PowerShell oturumunda komut isteminden Windows PowerShell (PowerShell.exe) başlatın. Ek bileşeni içeren konsol dosyasını belirtmek için PsConsoleFile parametresini kullanın. Örneğin, aşağıdaki komut NewConsole.psc1 konsol dosyasıyla Windows PowerShell başlatır:
PowerShell.exe -psconsolefile NewConsole.psc1
Ek bileşendeki sağlayıcılar ve cmdlet'ler artık oturumda kullanılabilir.
EK BILEŞENI KALDıRMA
Geçerli oturumdan bir Windows PowerShell ek bileşenini kaldırmak için Remove-PsSnapin cmdlet'ini kullanın. Örneğin, SQL Server ek bileşenini geçerli oturumdan kaldırmak için şunu yazın:
Remove-PSSnapin sql
Bu cmdlet ek bileşeni oturumdan kaldırır. Ek bileşen hala yüklenir, ancak desteklediği sağlayıcılar ve cmdlet'ler artık kullanılamaz.
YERLEŞIK KOMUTLAR
Windows PowerShell 2.0'da ve Windows PowerShell 3.0 ve sonraki sürümlerindeki eski stil konak programlarında, Windows PowerShell ile yüklenen yerleşik komutlar, her Windows PowerShell oturumuna otomatik olarak eklenen ek bileşenler halinde paketlenir.
Windows PowerShell 3.0 sürümünden başlayarak, initialSessionState.CreateDefault2 yöntemini kullanarak oturum başlatan yeni stil konak programlarında yerleşik komutlar modüllerde paketlenir. Özel durum, her zaman ek bileşen olarak görünen Microsoft.PowerShell.Core'dur. Çekirdek ek bileşeni varsayılan olarak her oturuma dahil edilir. Yerleşik modüller ilk kullanımda otomatik olarak yüklenir.
NOT: New-PSSession cmdlet'i kullanılarak başlatılan oturumlar da dahil olmak üzere uzak oturumlar, yerleşik komutların ek bileşenler halinde paketlendiği eski stil oturumlardır.
Aşağıdaki ek bileşenler (veya modüller) Windows PowerShell ile birlikte yüklenir.
Microsoft.PowerShell.Core - Windows PowerShell temel özelliklerini yönetmek için kullanılan sağlayıcıları ve cmdlet'leri içerir. Dosya Sistemi, Kayıt Defteri, Diğer Ad, Ortam, İşlev ve Değişken sağlayıcılarını ve Get-Help, Get-Command ve Get-History gibi temel cmdlet'leri içerir.
Microsoft.PowerShell.Host - Windows PowerShell konağı tarafından kullanılan Start-Transcript ve Stop-Transcript gibi cmdlet'leri içerir.
Microsoft.PowerShell.Management - Windows tabanlı özellikleri yönetmek için kullanılan Get-Service ve Get-ChildItem gibi cmdlet'leri içerir.
Microsoft.PowerShell.Security - Get-Acl, Get-AuthenticodeSignature ve ConvertTo-SecureString gibi Windows PowerShell güvenliğini yönetmek için kullanılan Sertifika sağlayıcısını ve cmdlet'leri içerir.
Microsoft.PowerShell.Utility - Get-Member, Write-Host ve Format-List gibi nesneleri ve verileri işlemek için kullanılan cmdlet'leri içerir.
Microsoft.WSMan.Management - Connect-WSMan ve Enable-WSManCredSSP gibi Windows Uzaktan Yönetim hizmetini yöneten WSMan sağlayıcısını ve cmdlet'lerini içerir.
EK BILEŞEN OLAYLARıNı GÜNLÜĞE KAYDETME
Windows PowerShell 3.0 sürümünden başlayarak, modüllerin ve ek bileşenlerinin LogPipelineExecutionDetails özelliğini TRUE olarak ayarlayarak Windows PowerShell modüllerde ve ek bileşenlerde cmdlet'ler için yürütme olaylarını kaydedebilirsiniz. Daha fazla bilgi için bkz. about_EventLogs.
Ayrıca bkz.
ANAHTAR KELİME -LER
about_Snapins about_Snap_ins about_Snap