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

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

Update-Help İşlemi

Aşağıdaki listede, kullanıcı belirli bir kullanıcı arabirimi kültüründeki bir modülün yardım dosyalarını güncelleştirmek 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 bildiriminde HelpInfoURI anahtarının değeri tarafından belirtilen konumdan alır ve dosyayı şemaya göre doğrular. (Şemayı görüntülemek için bkz . HelpInfo XML Şeması.) Ardından 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ü için uzak ve yerel HelpInfo XML dosyalarında belirtilen kullanıcı arabirimi kültürü için 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, Update-Help yeni yardım dosyalarını indirmeye hazırlanır.

3. Update-Help uzak HelpInfo XML dosyasında HelpContentUri öğesi tarafından belirtilen konumdan 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 UI kültürünü kullanır.

4. Update-Help CAB dosyasını indirir, açar, yardım içerik dosyalarını doğrular ve yardım içerik 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ı düzenleyerek yalnızca yüklemiş olduğu CAB dosyası için öğeler içermesini sağlar. Ardından yerel HelpInfo XML dosyasını modül dizinine kaydeder ve güncelleştirmeyi sonlandırıyor.

Save-Help İşlemi

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

Cmdlet, Save-Help bir modülün yardım dosyalarını DestinationPath parametresi tarafından belirtilen bir dosya paylaşımına kaydetmek üzere bir komuta yanıt olarak aşağıdaki eylemleri gerçekleştirir.

1. Save-Help uzak HelpInfo XML dosyasını modül bildiriminde HelpInfoURI anahtarının değeri tarafından belirtilen konumdan alır ve dosyayı şemaya göre doğrular. (Şemayı görüntülemek için bkz . HelpInfo XML Şeması.) Ardından Save-Help , komutundaki DestinationPath parametresi Save-Help tarafından belirtilen dizinde yerel bir HelpInfo XML dosyası arar.

2. Save-Help modülü için uzak ve yerel HelpInfo XML dosyalarında belirtilen kullanıcı arabirimi kültürü için 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ır.

3. Save-Help uzak HelpInfo XML dosyasında HelpContentUri öğesi tarafından belirtilen konumdan 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 UI kültürünü kullanır.

4. Save-Help CAB dosyasını indirir ve DestinationPath dizinine kaydeder. (Dile özgü 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ı için öğeler içerebilecek şekilde düzenler. Ardından yerel HelpInfo XML dosyasını DestinationPath dizinine kaydeder ve güncelleştirmeyi tamamlar.

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

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

7. Update-Help modülü için uzak ve yerel HelpInfo XML dosyalarında belirtilen kullanıcı arabirimi kültürü için 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, Update-Help yeni yardım dosyalarını yüklemeye hazırlanır.

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

9. Update-Help CAB dosyasını açar, yardım içerik dosyalarını doğrular ve yardım içerik 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ı düzenleyerek yalnızca yüklemiş olduğu CAB dosyası için öğeler içermesini sağlar. Ardından yerel HelpInfo XML dosyasını modül dizinine kaydeder ve güncelleştirmeyi sonlandırıyor.