Windows PowerShell SDK’sını Yükleme

Şunlar için geçerlidir: Windows PowerShell 2.0, Windows PowerShell 3.0

Aşağıdaki konu başlığında PowerShell SDK'sının Windows'un farklı sürümlerine nasıl yükleneceği açıklanmaktadır.

Windows 8 ve Windows Server 2012 için Windows PowerShell 3.0 SDK'sını yükleme

Windows PowerShell 3.0, Windows 8 ve Windows Server 2012 ile otomatik olarak yüklenir. Ayrıca, Windows 8 SDK'sının bir parçası olarak Windows PowerShell 3.0 için başvuru derlemelerini indirip yükleyebilirsiniz. Bu derlemeler, Windows PowerShell 3.0 için cmdlet'ler, sağlayıcılar ve konak programları yazmanızı sağlar. Windows 8 için Windows SDK'sını yüklediğinizde, Windows PowerShell derlemeleri \Program Files (x86)\Reference Assemblies\Microsoft\WindowsPowerShell\3.0'deki başvuru derleme klasörüne otomatik olarak yüklenir. Daha fazla bilgi için windows 8 SDK indirme sitesine bakın. Windows PowerShell kod örnekleri powershell-sdk-samples deposunda da kullanılabilir.

Referans derlemeleri

Başvuru derlemeleri varsayılan olarak şu konuma yüklenir: C:\Program Files\Reference Assemblies\Microsoft\WindowsPowerShell\V1.0.

Uyarı

Windows PowerShell 2.0 derlemelerinde derlenen kod, Windows PowerShell 1.0 yüklemelerine yüklenemez. Ancak, Windows PowerShell 1.0 derlemelerinde derlenen kod, Windows PowerShell 2.0 yüklemelerine yüklenebilir.

Örnekler

Kod örnekleri varsayılan olarak şu konuma yüklenir: C:\Program Files\Microsoft SDKs\Windows\v7.0\Samples\sysmgmt\WindowsPowerShell\. Aşağıdaki bölümlerde her bir örneğin ne yaptığı hakkında kısa bir açıklama sağlanır.

Cmdlet örnekleri

• GetProcessSample01 - Yerel bilgisayardaki tüm işlemleri alan basit bir cmdlet'in nasıl yazıldığını gösterir.
• GetProcessSample02 - Cmdlet'ine parametre eklemeyi gösterir. Cmdlet bir veya daha fazla işlem adı alır ve eşleşen işlemleri döndürür.
• GetProcessSample03 - İşlem hattından girişi kabul eden parametrelerin nasıl ekleneceğini gösterir.
• GetProcessSample04 - Sonlandırılmayan hataların nasıl işleneceğini gösterir.
• GetProcessSample05 - Belirtilen işlemlerin listesinin nasıl görüntüleneceğini gösterir.
• SelectObject - Yalnızca belirli nesneleri seçmek için filtre yazmayı gösterir.
• SelectString - Belirtilen desenler için dosyaların nasıl aranacaklarını gösterir.
• StopProcessSample01 - PassThru parametresinin nasıl uygulanacağını ve ShouldProcess ve ShouldContinue yöntemlerine yapılan çağrılarla kullanıcı geri bildiriminin nasıl istendiği gösterilir. Kullanıcılar, cmdlet'i bir nesne döndürmeye zorlamak istediklerinde PassThru parametresini belirtir.
• StopProcessSample02 - Belirli bir işlemin nasıl durdurulacağını gösterir.
• StopProcessSample03 - Parametreler için diğer adları bildirmeyi ve joker karakterleri desteklemeyi gösterir.
• StopProcessSample04 - Parametre kümelerinin nasıl bildirileceğini, cmdlet'in giriş olarak aldığı nesneyi ve kullanılacak varsayılan parametre kümesinin nasıl belirtileceğini gösterir.

Uzaktan iletişim örnekleri

• RemoteRunspace01 - Uzak bağlantı kurmak için kullanılan bir uzak çalışma alanının nasıl oluşturulacağını gösterir.
• RemoteRunspacePool01 - Bu havuzu kullanarak uzak bir runspace havuzunun nasıl oluşturulup birden çok komutun eşzamanlı olarak nasıl çalıştırılacaklarını gösterir.
• Serialization01 - Var olan bir .NET sınıfına nasıl bakıldığını ve bu sınıfın seçili genel özelliklerindeki bilgilerin serileştirme/seri durumdan çıkarma arasında nasıl korunduğunu gösterir.
• Serialization02 - Mevcut bir .NET sınıfına nasıl bakıldığını ve bilgiler sınıfın genel özelliklerinde mevcut olmadığında serileştirme/seri durumdan çıkarma sırasında bu sınıfın örneğindeki bilgilerin korunduğundan nasıl emin olunduğunu gösterir.
• Serialization03 - Var olan bir .NET sınıfına nasıl bakıldığını ve bu sınıfın ve türetilmiş sınıfların örneklerinin canlı .NET nesnelerinde seri durumdan çıkarıldığından (yeniden dolduruldığından) emin olunmasını gösterir.

Olay örnekleri

• Event01 - ObjectEventRegistrationBase'den türetilerek olay kaydı için bir cmdlet'in nasıl oluşturulacağını gösterir.
• Event02 - Uzak bilgisayarlarda oluşturulan Windows PowerShell olaylarının bildirimlerini nasıl alacağınızı gösterir. Runspace sınıfı aracılığıyla kullanıma sunulan PSEventReceived olayını kullanır.

Uygulama örneklerini barındırma

• Runspace01 - Get-Process cmdlet'ini zaman uyumlu bir şekilde çalıştırmak için PowerShell sınıfının nasıl kullanılacağını gösterir. Get-Process cmdlet'i, yerel bilgisayarda çalışan her işlem için İşlem nesneleri döndürür.
• Runspace02 - Get-Process ve Sort-Object cmdlet'lerini zaman uyumlu bir şekilde çalıştırmak için PowerShell sınıfının nasıl kullanılacağını gösterir. Get-Process cmdlet'i yerel bilgisayarda çalışan her işlem için İşlem nesneleri döndürür ve Sort-Object nesneleri Kimlik özelliklerine göre sıralar. Bu komutların sonuçları DataGridView denetimi kullanılarak görüntülenir.
• Runspace03 - Bir betiği zaman uyumlu bir şekilde çalıştırmak için PowerShell sınıfının nasıl kullanılacağını ve sonlandırılmayan hataların nasıl işleneceğini gösterir. Betik, işlem adlarının listesini alır ve ardından bu işlemleri alır. Betik çalıştırılırken oluşturulan sonlandırıcı olmayan hatalar da dahil olmak üzere betiğin sonuçları bir konsol penceresinde görüntülenir.
• Runspace04 - Komutları çalıştırmak için PowerShell sınıfının nasıl kullanılacağını ve komutları çalıştırırken oluşan sonlandırıcı hataları yakalamayı gösterir. İki komut çalıştırılır ve son komut geçerli olmayan bir parametre bağımsız değişkeni geçirilir. Sonuç olarak hiçbir nesne döndürülmüyor ve sonlandırıcı bir hata oluşuyor.
• Runspace05 - Çalışma alanı açıldığında ek bileşenin cmdlet'inin kullanılabilir olması için InitialSessionState nesnesine ek bileşenin nasıl ekleneceğini gösterir. Ek bileşen, PowerShell nesnesi kullanılarak zaman uyumlu olarak çalıştırılan bir Get-Proc cmdlet'i (GetProcessSample01 Örneği tarafından tanımlanır) sağlar.
• Runspace06 - Runspace açıldığında modülün yüklenmesi için InitialSessionState nesnesine modül eklemeyi gösterir. Modül, Bir PowerShell nesnesi kullanılarak zaman uyumlu olarak çalıştırılan bir Get-Proc cmdlet'i (GetProcessSample02 Örneği tarafından tanımlanır) sağlar.
• Runspace07 - Bir runspace oluşturmayı ve ardından bu runspace'i kullanarak bir PowerShell nesnesi kullanarak iki cmdlet'i zaman uyumlu bir şekilde çalıştırmayı gösterir.
• Runspace08 - PowerShell nesnesinin işlem hattına komutların ve bağımsız değişkenlerin nasıl ekleneceğini ve komutların zaman uyumlu olarak nasıl çalıştırılacaklarını gösterir.
• Runspace09 - PowerShell nesnesinin işlem hattına betik eklemeyi ve betiği zaman uyumsuz olarak çalıştırmayı gösterir. Olaylar betiğin çıkışını işlemek için kullanılır.
• Runspace10 - Varsayılan bir ilk oturum durumunun nasıl oluşturulacağını, InitialSessionState'e cmdlet'in nasıl ekleneceğini, ilk oturum durumunu kullanan bir runspace'in nasıl oluşturulacağını ve komutun PowerShell nesnesi kullanarak nasıl çalıştırıldığını gösterir.
• Runspace11 - Mevcut bir cmdlet'i çağıran ancak kullanılabilir parametre kümesini kısıtlayan bir proxy komutu oluşturmak için ProxyCommand sınıfının nasıl kullanılacağını gösterir. Ardından ara sunucu komutu, kısıtlanmış bir çalışma alanı oluşturmak için kullanılan ilk oturum durumuna eklenir. Bu, kullanıcının cmdlet'in işlevselliğine yalnızca proxy komutu aracılığıyla erişebileceği anlamına gelir.
• PowerShell01 - InitialSessionState nesnesi kullanarak kısıtlanmış bir runspace oluşturmayı gösterir.
• PowerShell02 - Birden çok komutu eşzamanlı olarak çalıştırmak için bir runspace havuzunun nasıl kullanılacağını gösterir.

Konak örnekleri

• Host01 - Özel konak kullanan bir konak uygulamasının nasıl uygulandığını gösterir. Bu örnekte özel konağı kullanan bir çalışma alanı oluşturulur ve ardından PowerShell API'si exitçağıran bir betik çalıştırmak için kullanılır. Ardından konak uygulaması betiğin çıktısını arar ve sonuçları yazdırır.
• Host02 - Özel bir konak uygulamasıyla birlikte Windows PowerShell çalışma zamanını kullanan bir konak uygulamasının nasıl yazıldığını gösterir. Konak uygulaması konak kültürünü Almanca olarak ayarlar, Get-Process cmdlet'ini çalıştırır ve pwrsh.exekullanarak sonuçları gördüğünüz gibi görüntüler ve ardından geçerli verileri ve zamanı Almanca olarak yazdırır.
• Host03 - Komut satırından komutları okuyan, komutları yürüten ve ardından sonuçları konsolda görüntüleyen etkileşimli konsol tabanlı bir konak uygulamasının nasıl derlendiğini gösterir.
• Host04 - Komut satırından komutları okuyan, komutları yürüten ve ardından sonuçları konsolda görüntüleyen etkileşimli konsol tabanlı bir konak uygulamasının nasıl derlendiğini gösterir. Bu konak uygulaması, kullanıcının birden çok seçenek belirtmesine olanak sağlayan istemlerin görüntülenmesini de destekler.
• Host05 - Komut satırından komutları okuyan, komutları yürüten ve ardından sonuçları konsolda görüntüleyen etkileşimli konsol tabanlı bir konak uygulamasının nasıl derlendiğini gösterir. Bu konak uygulaması, Enter-PSSession ve Exit-PSSession cmdlet'lerini kullanarak uzak bilgisayarlara yapılan çağrıları da destekler.
• Host06 - Komut satırından komutları okuyan, komutları yürüten ve ardından sonuçları konsolda görüntüleyen etkileşimli konsol tabanlı bir konak uygulamasının nasıl derlendiğini gösterir. Ayrıca bu örnek, kullanıcı tarafından girilen metnin rengini belirtmek için Belirteç Oluşturucu API'lerini kullanır.

Sağlayıcı örnekleri

• AccessDBProviderSample01 - Doğrudan CmdletProvider sınıfından türetilen bir sağlayıcı sınıfının nasıl bildirildiğini gösterir. Yalnızca tamlık için buraya dahildir.

• AccessDBProviderSample02 - New-PSDrive ve Remove-PSDrive cmdlet'lerine yönelik çağrıları desteklemek için NewDrive ve RemoveDrive yöntemlerinin üzerine nasıl yazılacağını gösterir. Bu örnekteki sağlayıcı sınıfı DriveCmdletProvider sınıfından türetilir.

• AccessDBProviderSample03 - Get-Item ve Set-Item cmdlet'lerine yönelik çağrıları desteklemek için GetItem ve SetItem yöntemlerinin üzerine nasıl yazıldığını gösterir. Bu örnekteki sağlayıcı sınıfı ItemCmdletProvider sınıfından türetilir.

• AccessDBProviderSample04 - Copy-Item, Get-ChildItem, New-Itemve Remove-Item cmdlet'lerine yönelik çağrıları desteklemek için kapsayıcı yöntemlerinin üzerine nasıl yazıldığını gösterir. Veri deposu kapsayıcı olan öğeler içerdiğinde bu yöntemlerin uygulanması gerekir. Kapsayıcı, ortak bir üst öğe altındaki bir alt öğe grubudur. Bu örnekteki sağlayıcı sınıfı ItemCmdletProvider sınıfından türetilir.

• AccessDBProviderSample05 - Move-Item ve Join-Path cmdlet'lerine yönelik çağrıları desteklemek için kapsayıcı yöntemlerinin üzerine nasıl yazıldığını gösterir. Bu yöntemler, kullanıcının kapsayıcı içindeki öğeleri taşıması gerektiğinde ve veri deposunda iç içe kapsayıcılar varsa uygulanmalıdır. Bu örnekteki sağlayıcı sınıfı NavigationCmdletProvider sınıfından türetilir.

• AccessDBProviderSample06 - Clear-Content, Get-Contentve Set-Content cmdlet'lerine yapılan çağrıları desteklemek için içerik yöntemlerinin üzerine nasıl yazıldığını gösterir. Bu yöntemler, kullanıcının veri deposundaki öğelerin içeriğini yönetmesi gerektiğinde uygulanmalıdır. Bu örnekteki sağlayıcı sınıfı NavigationCmdletProvider sınıfından türetilir ve IContentCmdletProvider arabirimini uygular.