Güncelleştirilebilir Yardıma Genel Bakış

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

Giriş

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

Windows PowerShell 3.0'da sunulan Güncelleştirilebilir Yardım özelliği, kullanıcıların yeni modülleri 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 olmasını sağlar. Güncelleştirilebilir Yardım, yardım konularının en yeni sürümlerini internetten indiren ve bunları kullanıcının yerel bilgisayarına doğru alt dizinlere yükleyen cmdlet'ler sağlayarak güncelleştirmeyi basitleştirir. Güvenlik duvarlarının arkasındaki kullanıcılar bile yeni cmdlet'leri kullanarak bir iç dosya paylaşımından güncelleştirilmiş yardım alabilir.

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ı tarafından kullanılabilir. Güncelleştirilebilir Yardım yalnızca XML tabanlı yardım dosyalarını destekler. Açıklama tabanlı yardımı desteklemez.

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

• Update-Help cmdlet'i, kullanıcıların bir modül için en yeni yardım dosyalarına sahip olup olmadığını belirler ve değilse en yeni yardım dosyalarını İnternet'ten indirir, açar ve kullanıcının bilgisayarındaki doğru modül alt dizinlerine yükler. Kullanıcılar, yeni yüklenen yardım konularını hemen görüntülemek için Get-Help cmdlet'ini kullanabilir. PowerShell'i yeniden başlatmaları gerekmez.

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

• modül için yardım. Bir modülün yardım dosyaları yönetilir ve birim olarak teslim edilir, böylece kullanıcılar kullandıkları modüller için tüm yardım dosyalarını alabilir. 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üncelleştirilebilir Yardım standart dört konumlu (N1) kullanır. N2. N3. N4) sürüm numaraları. Güncelleştirilebilir Yardım, kullanıcının bilgisayarındaki (veya Save-Help dizinindeki) yardım dosyalarının sürüm numarası İnternet konumundaki yardım dosyalarının sürüm sayısından düşük olduğunda yardım dosyalarını indirir.

• Çok dilli destek. Güncelleştirilebilir Yardım, birden çok kullanıcı arabirimi kültüründeki modül yardım dosyalarını destekler. Güncelleştirilebilir 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ı modül dizininin dile özgü alt dizinlerine yerleştirir.

• otomatik oluşturulan yardım . Get-Help cmdlet'i, yardım dosyaları olmayan komutlar için temel yardım görüntüler. Otomatik oluşturulan yardım, komut söz dizimi ve diğer adları ile çevrimiçi yardım ve Güncelleştirilebilir Yardım kullanma yönergelerini içerir.

• gelişmiş çevrimiçi yardım . Çevrimiçi yardıma kolay erişim için artık yardım dosyaları gerekmez. Get-Help cmdlet'in Online parametresi, bir yardım dosyasında çevrimiçi yardım URL'sini bulamazsa, artık herhangi bir komutun HelpUri özelliği değerinden çevrimiçi yardım konusunun URL'sini alır. cmdlet'ler, işlevler ve CIM komutlarının koduna bir HelpUri özniteliği ekleyerek veya iş akışları ve betiklerde açıklama tabanlı yardım anahtar sözcüğünü kullanarak .LINKHelpUri özelliğini doldurabilirsiniz.

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