Güncellenebilir Yardım Nasıl Çalışır?

Bu konu, Güncelleştirilebilir Yardım'ın her modül için HelpInfo XML dosyasını ve CAB dosyalarını nasıl işlediğini ve kullanıcılar için güncellenmiş yardımı nasıl yüklediğini açıklamaktadır.

Güncelleme-Yardım Süreci

Aşağıdaki listede, bir kullanıcı belirli bir kullanıcı arayüzü kültüründeki bir modülün yardım dosyalarını güncellemek için bir komut çalıştırdığında Update-Help cmdlet'inin eylemleri açıklanmaktadır.

  1. Update-Help, uzak HelpInfo XML dosyasını modül bildirimindeki HelpInfoURI anahtarının değeriyle belirtilen konumdan alır ve dosyayı şemaya göre doğrular. (Şemayı görüntülemek için HelpInfo XML Şeması'na bakın.) Daha sonra Update-Help, kullanıcının bilgisayarındaki modül dizininde modül için yerel bir HelpInfo XML dosyası arar.

  2. Update-Help, modülün uzak ve yerel HelpInfo XML dosyalarındaki belirtilen kullanıcı arayüzü kültürüne ait yardım dosyalarının sürüm numarasını karşılaştırır. Uzak dosyadaki sürüm numarası yerel dosyadaki sürüm numarasından büyükse veya modül için yerel HelpInfo XML dosyası yoksa Güncelleme-Yardım yeni yardım dosyalarını indirmeye hazırlanır.

  3. Update-Help, uzak HelpInfo XML dosyasındaki HelpContentUri öğesi tarafından belirtilen konumdan modüle ilişkin CAB dosyasını seçer. CAB dosyasını tanımlamak için modül adını, modül GUID'sini ve kullanıcı arayüzü kültürünü kullanır.

  4. Güncelleme-Yardım, CAB dosyasını indirir, paketini açar, yardım içeriği dosyalarını doğrular ve yardım içeriği dosyalarını kullanıcının bilgisayarındaki modül dizininin dile özgü alt dizinine kaydeder.

  5. Update-Help uzak HelpInfo XML dosyasını kopyalayarak yerel bir HelpInfo XML dosyası oluşturur. Yerel HelpInfo XML dosyasını, yalnızca yüklediği CAB dosyasına ilişkin öğeleri içerecek şekilde düzenler. Daha sonra yerel HelpInfo XML dosyasını modül dizinine kaydeder ve güncellemeyi sonlandırır.

Kaydet-Yardım Süreci

Aşağıdaki liste, bir kullanıcı bir dosya paylaşımındaki yardım dosyalarını güncellemek için komutları çalıştırdığında ve ardından bu dosyaları kullanıcının bilgisayarındaki yardım dosyalarını güncellemek için kullandığında Kaydet-Yardım ve Güncelle-Yardım cmdlet'lerinin eylemlerini açıklar.

Save-Help cmdlet'i, bir modülün yardım dosyalarını DestinationPath parametresi tarafından belirtilen bir dosya paylaşımına kaydetme komutuna yanıt olarak aşağıdaki eylemleri gerçekleştirir.

  1. Save-Help, uzak HelpInfo XML dosyasını modül bildirimindeki HelpInfoURI anahtarının değeriyle belirtilen konumdan alır ve dosyayı şemaya göre doğrular. (Şemayı görüntülemek için HelpInfo XML Şeması'na bakın.) Daha sonra Save-Help, DestinationPath parametresi tarafından belirtilen dizinde yerel bir HelpInfo XML dosyası arar. >Kaydet-Yardım komutu.

  2. Save-Help, modülün uzak ve yerel HelpInfo XML dosyalarındaki belirtilen kullanıcı arayüzü kültürüne ait yardım dosyalarının sürüm numarasını karşılaştırır. Uzak dosyadaki sürüm numarası, yerel dosyadaki sürüm numarasından büyükse veya DestinationPath dizininde modül için yerel HelpInfo XML dosyası yoksa, Save-Help yeni yardım dosyalarını indirmeye hazırlanıyor.

  3. Save-Help, uzak HelpInfo XML dosyasındaki HelpContentUri öğesi tarafından belirtilen konumdan modüle ilişkin CAB dosyasını seçer. CAB dosyasını tanımlamak için modül adını, modül GUID'sini ve kullanıcı arayüzü kültürünü kullanır.

  4. Save-Help, CAB dosyasını indirir ve onu DestinationPath dizinine kaydeder. (Dile özgü herhangi bir alt dizin oluşturmaz.)

  5. Save-Help uzak HelpInfo XML dosyasını kopyalayarak yerel bir HelpInfo XML dosyası oluşturur. Yerel HelpInfo XML dosyasını, yalnızca kaydettiği CAB dosyasına ilişkin öğeleri içerecek şekilde düzenler. Daha sonra yerel HelpInfo XML dosyasını DestinationPath dizinine kaydeder ve güncellemeyi tamamlar.

    Update-Help cmdlet'i, kullanıcının bilgisayarındaki yardım dosyalarını SourcePath parametresi tarafından belirtilen bir dosya paylaşımındaki dosyalardan güncelleme komutuna yanıt olarak aşağıdaki eylemleri gerçekleştirir .

  6. Update-Help uzak HelpInfo XML dosyasını SourcePath dizininden alır. Daha sonra kullanıcının bilgisayarındaki modül dizininde yerel bir HelpInfo XML dosyası arar.

  7. Update-Help, modülün uzak ve yerel HelpInfo XML dosyalarındaki belirtilen kullanıcı arayüzü kültürüne ait yardım dosyalarının sürüm numarasını karşılaştırır. Uzak dosyadaki sürüm numarası yerel dosyadaki sürüm numarasından büyükse veya yerel HelpInfo XML dosyası yoksa Güncelleme-Yardım yeni yardım dosyalarını yüklemeye hazırlanır.

  8. Update-Help, SourcePath dizininden modül için CAB dosyasını seçer. CAB dosyasını tanımlamak için modül adını, modül GUID'sini ve kullanıcı arayüzü kültürünü kullanır.

  9. Güncelleme-Yardım, CAB dosyasını açar, yardım içeriği dosyalarını doğrular ve yardım içeriği dosyalarını kullanıcının bilgisayarındaki modül dizininin dile özgü alt dizinine kaydeder.

  10. Update-Help, uzak HelpInfo XML dosyasını kopyalayarak yerel bir HelpInfo XML dosyası oluşturur. Yerel HelpInfo XML dosyasını, yalnızca yüklediği CAB dosyasına ilişkin öğeleri içerecek şekilde düzenler. Daha sonra yerel HelpInfo XML dosyasını modül dizinine kaydeder ve güncellemeyi sonlandırır.

İlgili makaleler