Güncellenebilir Yardıma Genel Bakış

Bu belge, PowerShell Güncelleştirilebilir Yardım özelliğinin tasarımına ve kullanımına ilişkin temel bir giriş sağlar. Modül yazarları ve kullanıcılara Windows PowerShell yardım konularını sunan diğer kişiler için tasarlanmıştır.

giriiş

PowerShell yardım konuları PowerShell deneyiminin ayrılmaz bir parçasıdır. PowerShell modülleri gibi, yardım konuları da yazarlar ve PowerShell kullanıcıları topluluğunun katkıları tarafından sürekli olarak güncellenir ve geliştirilir.

Windows PowerShell 3.0'da sunulan Güncellenebilir Yardım özelliği, kullanıcıların, yeni modüller indirmeden veya Windows Update'i çalıştırmadan, yerleşik PowerShell komutları için bile komut isteminde yardım konularının en yeni sürümlerine sahip olmalarını sağlar. Güncellenebilir Yardım, yardım konularının en yeni sürümlerini internetten indiren ve bunları kullanıcının yerel bilgisayarındaki doğru alt dizinlere yükleyen cmdlet'ler sağlayarak güncellemeyi basitleştirir. Güvenlik duvarlarının arkasında bulunan kullanıcılar bile dahili dosya paylaşımından güncel yardım almak için yeni cmdlet'leri kullanabilir.

Güncelleştirilebilir Yardım, Windows 8 ve Windows Server 2012'deki tüm Windows PowerShell modülleri tarafından tam olarak desteklenir ve özellikleri tüm Windows PowerShell modülü yazarlarının kullanımına açıktır. Güncellenebilir Yardım yalnızca XML tabanlı yardım dosyalarını destekler. Yoruma dayalı yardımı desteklemez.

Güncellenebilir Yardım aşağıdaki özellikleri içerir.

• Kullanıcıların bir modül için en yeni yardım dosyalarına sahip olup olmadıklarını belirleyen, yoksa internetten en yeni yardım dosyalarını indiren, bunları paketten çıkaran ve kullanıcının bilgisayarındaki doğru modül alt dizinlerine yükleyen Update-Help cmdlet'i. Kullanıcılar yeni yüklenen yardım konularını hemen görüntülemek için Get-Help cmdlet'ini kullanabilirler. PowerShell'i yeniden başlatmaları gerekmez.

• İnternetten en yeni yardım dosyalarını indiren ve bunları bir dosya sistemi dizinine kaydeden Save-Help cmdlet'i. Kullanıcılar, dosya sistemi dizininden yardım dosyalarını almak ve bunları paketinden çıkarıp kullanıcının bilgisayarındaki modül alt dizinlerine yüklemek için Update-Help cmdlet'ini kullanabilir. Save-Help cmdlet'i, internet erişimi sınırlı olan veya hiç olmayan kullanıcılar ve internet erişimini sınırlamayı tercih eden kuruluşlar için tasarlanmıştır.

• Modül Yardımı. Bir modüle ilişkin yardım dosyaları bir birim olarak yönetilir ve sunulur; böylece kullanıcılar, kullandıkları modüllere ilişkin tüm yardım dosyalarını alabilirler. Güncelleştirilebilir yardım yalnızca modüller için desteklenir, Windows PowerShell ek bileşenleri için desteklenmez.

• Sürüm desteği. Güncellenebilir Yardım, standart dört konumlu (N1.N2.N3.N4) sürüm numaralarını kullanır. Güncellenebilir Yardım, kullanıcının bilgisayarındaki (veya Save-Help dizinindeki) yardım dosyalarının sürüm numarası, internet konumundaki yardım dosyalarının sürüm numarasından düşük olduğunda, yardım dosyalarını indirir.

• Çoklu dil desteği. Güncellenebilir Yardım, birden fazla kullanıcı arayüzü kültüründeki modül yardım dosyalarını destekler. Güncellenebilir Yardım dosya adları, "en-US" ve "ja-JP" gibi standart dil kodlarını içerir ve Update-Help ve Save-Help cmdlet'leri yardım dosyalarını yerleştirir modül dizininin dile özgü alt dizinlerine.

• Otomatik olarak oluşturulan yardım. Get-Help cmdlet'i, yardım dosyası olmayan komutlar için temel yardımı görüntüler. Otomatik olarak oluşturulan yardım, komut sözdizimini ve takma adlarını ve çevrimiçi yardım ve Güncellenebilir Yardım'ı kullanma talimatlarını içerir.

• Gelişmiş Çevrimiçi yardım. Çevrimiçi yardıma kolay erişim artık yardım dosyalarına ihtiyaç duymaz. Get-Help cmdlet'inin Çevrimiçi parametresi artık çevrimiçi yardım konusunun URL'sini herhangi bir komutun HelpUri özelliğinin değerinden alıyor, yardım dosyasında çevrimiçi yardım URL'sini bulamazsa. HelpUri özelliğini, cmdlet'lerin, işlevlerin ve CIM komutlarının koduna bir HelpUri özelliği ekleyerek veya .Link yorumunu kullanarak doldurabilirsiniz. iş akışlarında ve komut dosyalarında tabanlı yardım yönergesi.

  Yardım dosyalarımızı güncelleştirilebilir hale getirmek için Windows'taki Windows PowerShell modülleri yardım dosyalarıyla birlikte gelmez. Kullanıcılar, yardım dosyalarını yüklemek ve bunları güncellemek için Güncellenebilir Yardım'ı kullanabilir. Diğer modüllerin yazarları, modüllere yardım dosyaları ekleyebilir veya bunları atlayabilir. Güncellenebilir Yardım desteği isteğe bağlıdır ancak önerilir.