Cara Kerja Bantuan yang Dapat Diperbarui

Topik ini menjelaskan bagaimana Bantuan yang Dapat Diperbarui memproses file XML HelpInfo dan file CAB untuk setiap modul, dan menginstal bantuan yang diperbarui untuk pengguna.

Proses Update-Help

Daftar berikut menjelaskan tindakan cmdlet Update-Help saat pengguna menjalankan perintah untuk memperbarui file bantuan untuk modul dalam budaya UI tertentu.

1. Update-Help mendapatkan file XML HelpInfo jarak jauh dari lokasi yang ditentukan oleh nilai kunci HelpInfoURI dalam manifes modul dan memvalidasi file terhadap skema. (Untuk melihat skema, lihat Skema XML HelpInfo.) Kemudian Update-Help cari file XML HelpInfo lokal untuk modul di direktori modul di komputer pengguna.

2. Update-Help membandingkan nomor versi file bantuan untuk budaya UI yang ditentukan dalam file XML HelpInfo jarak jauh dan lokal untuk modul. Jika nomor versi pada file jarak jauh lebih besar dari nomor versi pada file lokal, atau jika tidak ada file XML HelpInfo lokal untuk modul, Update-Help bersiap untuk mengunduh file bantuan baru.

3. Update-Help memilih file CAB untuk modul dari lokasi yang ditentukan oleh elemen HelpContentUri dalam file XML HelpInfo jarak jauh. Ini menggunakan nama modul, GUID modul, dan budaya UI untuk mengidentifikasi file CAB.

4. Update-Help mengunduh file CAB, membongkarnya, memvalidasi file konten bantuan, dan menyimpan file konten bantuan dalam subdirektori khusus bahasa direktori modul di komputer pengguna.

5. Update-Help membuat file XML HelpInfo lokal dengan menyalin file XML HelpInfo jarak jauh. Ini mengedit file XML HelpInfo lokal sehingga hanya menyertakan elemen untuk file CAB yang diinstalnya. Kemudian menyimpan file XML HelpInfo lokal di direktori modul dan menyimpulkan pembaruan.

Proses Save-Help

Daftar berikut ini menjelaskan tindakan cmdlet Save-Help dan Update-Help saat pengguna menjalankan perintah untuk memperbarui file bantuan dalam berbagi file, lalu menggunakan file tersebut untuk memperbarui file bantuan di komputer pengguna.

Save-Help Cmdlet melakukan tindakan berikut sebagai respons terhadap perintah untuk menyimpan file bantuan untuk modul dalam berbagi file yang ditentukan oleh parameter DestinationPath.

1. Save-Help mendapatkan file XML HelpInfo jarak jauh dari lokasi yang ditentukan oleh nilai kunci HelpInfoURI dalam manifes modul dan memvalidasi file terhadap skema. (Untuk melihat skema, lihat Skema XML HelpInfo.) Kemudian Save-Help cari file XML HelpInfo lokal di direktori yang ditentukan oleh parameter DestinationPath dalam Save-Help perintah .

2. Save-Help membandingkan nomor versi file bantuan untuk budaya UI yang ditentukan dalam file XML HelpInfo jarak jauh dan lokal untuk modul. Jika nomor versi pada file jarak jauh lebih besar dari nomor versi pada file lokal, atau jika tidak ada file XML HelpInfo lokal untuk modul di direktori DestinationPath , Save-Help bersiap untuk mengunduh file bantuan baru.

3. Save-Help memilih file CAB untuk modul dari lokasi yang ditentukan oleh elemen HelpContentUri dalam file XML HelpInfo jarak jauh. Ini menggunakan nama modul, GUID modul, dan budaya UI untuk mengidentifikasi file CAB.

4. Save-Help mengunduh file CAB dan menyimpannya di direktori DestinationPath . (Ini tidak membuat subdirektori khusus bahasa apa pun.)

5. Save-Help membuat file XML HelpInfo lokal dengan menyalin file XML HelpInfo jarak jauh. Ini mengedit file XML HelpInfo lokal sehingga hanya menyertakan elemen untuk file CAB yang disimpannya. Kemudian menyimpan file XML HelpInfo lokal di direktori DestinationPath dan menyimpulkan pembaruan.

   Update-Help Cmdlet melakukan tindakan berikut sebagai respons terhadap perintah untuk memperbarui file bantuan di komputer pengguna dari file dalam berbagi file yang ditentukan oleh parameter SourcePath.

6. Update-Help mendapatkan file XML HelpInfo jarak jauh dari direktori SourcePath . Kemudian ia mencari file XML HelpInfo lokal di direktori modul di komputer pengguna.

7. Update-Help membandingkan nomor versi file bantuan untuk budaya UI yang ditentukan dalam file XML HelpInfo jarak jauh dan lokal untuk modul. Jika nomor versi pada file jarak jauh lebih besar dari nomor versi pada file lokal, atau jika tidak ada file XML HelpInfo lokal, Update-Help bersiap untuk menginstal file bantuan baru.

8. Update-Help memilih file CAB untuk modul dari direktori SourcePath . Ini menggunakan nama modul, GUID modul, dan budaya UI untuk mengidentifikasi file CAB.

9. Update-Help membongkar file CAB, memvalidasi file konten bantuan, dan menyimpan file konten bantuan dalam subdirektori khusus bahasa direktori modul di komputer pengguna.

10. Update-Help membuat file XML HelpInfo lokal dengan menyalin file XML HelpInfo jarak jauh. Ini mengedit file XML HelpInfo lokal sehingga hanya menyertakan elemen untuk file CAB yang diinstalnya. Kemudian menyimpan file XML HelpInfo lokal di direktori modul dan menyimpulkan pembaruan.