Jaki działa pomoc aktualizowalna

W tym temacie wyjaśniono, jak aktualizowaalna pomoc przetwarza plik XML HelpInfo i pliki CAB dla każdego modułu, a także instaluje zaktualizowaną pomoc dla użytkowników.

Proces Update-Help danych

Na poniższej liście opisano akcje polecenia cmdlet Update-Help, gdy użytkownik uruchamia polecenie aktualizujące pliki pomocy dla modułu w określonej kulturze interfejsu użytkownika.

1. Update-Help pobiera zdalny plik XML HelpInfo z lokalizacji określonej przez wartość klucza HelpInfoURI w manifeście modułu i weryfikuje plik względem schematu. (Aby wyświetlić schemat, zobacz HelpInfo XML Schema (Schemat XML HelpInfo). Następnie Update-Help wyszukuje lokalny plik XML HelpInfo dla modułu w katalogu modułu na komputerze użytkownika.

2. Update-Help porównuje numer wersji plików pomocy dla określonej kultury interfejsu użytkownika w zdalnych i lokalnych plikach XML HelpInfo dla modułu. Jeśli numer wersji w pliku zdalnym jest większy niż numer wersji w pliku lokalnym lub jeśli nie ma lokalnego pliku XML HelpInfo dla modułu, program przygotowuje się do pobrania nowych Update-Help plików pomocy.

3. Update-Help Wybiera plik CAB dla modułu z lokalizacji określonej przez HelpContentUri element w zdalnym pliku XML HelpInfo. Używa nazwy modułu, identyfikatora GUID modułu i kultury interfejsu użytkownika do identyfikowania pliku CAB.

4. Update-Help Pobiera plik CAB, rozpakowuje go, weryfikuje pliki zawartości pomocy i zapisuje pliki zawartości pomocy w podkatalogu specyficznym dla języka katalogu modułu na komputerze użytkownika.

5. Update-Help Tworzy lokalny plik XML HelpInfo przez skopiowanie zdalnego pliku XML HelpInfo. Edytuje lokalny plik XML HelpInfo, tak aby zawierał elementy tylko dla zainstalowanego pliku CAB. Następnie zapisuje lokalny plik XML HelpInfo w katalogu modułu i kończy aktualizację.

Proces Save-Help danych

Na poniższej liście opisano akcje poleceń cmdlet Save-Help i Update-Help, gdy użytkownik uruchamia polecenia aktualizujące pliki pomocy w udziałach plików, a następnie używają tych plików do aktualizowania plików pomocy na komputerze użytkownika.

Polecenie cmdlet wykonuje następujące akcje w odpowiedzi na polecenie w celu zapisania plików pomocy dla modułu w udziałach plików określonych przez Save-Help parametr DestinationPath.

1. Save-Help pobiera zdalny plik XML HelpInfo z lokalizacji określonej przez wartość klucza HelpInfoURI w manifeście modułu i weryfikuje plik względem schematu. (Aby wyświetlić schemat, zobacz HelpInfo XML Schema (Schemat XML HelpInfo). Następnie Save-Help wyszukuje lokalny plik XML HelpInfo w katalogu określonym przez parametr DestinationPath w Save-Help poleceniu .

2. Save-Help porównuje numer wersji plików pomocy dla określonej kultury interfejsu użytkownika w zdalnych i lokalnych plikach XML HelpInfo dla modułu. Jeśli numer wersji w pliku zdalnym jest większy niż numer wersji w pliku lokalnym lub jeśli nie ma lokalnego pliku XML HelpInfo dla modułu w katalogu DestinationPath, program przygotowuje się do pobrania nowych plików Save-Help pomocy.

3. Save-Help Wybiera plik CAB dla modułu z lokalizacji określonej przez HelpContentUri element w zdalnym pliku XML HelpInfo. Używa nazwy modułu, identyfikatora GUID modułu i kultury interfejsu użytkownika do identyfikowania pliku CAB.

4. Save-HelpPobiera plik CAB i zapisuje go w katalogu DestinationPath. (Nie tworzy żadnych podkatalogów specyficznych dla języka).

5. Save-Help Tworzy lokalny plik XML HelpInfo przez skopiowanie zdalnego pliku XML HelpInfo. Edytuje lokalny plik XML HelpInfo, tak aby zawierał tylko elementy zapisanego pliku CAB. Następnie zapisuje lokalny plik XML HelpInfo w katalogu DestinationPath i kończy aktualizację.

   Polecenie cmdlet wykonuje następujące akcje w odpowiedzi na polecenie w celu zaktualizowania plików pomocy na komputerze użytkownika z plików w udziałach plików określonych przez parametr Update-Help SourcePath.

6. Update-HelpPobiera zdalny plik XML HelpInfo z katalogu SourcePath. Następnie szuka lokalnego pliku XML HelpInfo w katalogu modułu na komputerze użytkownika.

7. Update-Help porównuje numer wersji plików pomocy dla określonej kultury interfejsu użytkownika w zdalnych i lokalnych plikach XML HelpInfo dla modułu. Jeśli numer wersji w pliku zdalnym jest większy niż numer wersji w pliku lokalnym lub jeśli nie ma lokalnego pliku XML HelpInfo, program przygotowuje się do zainstalowania Update-Help nowych plików pomocy.

8. Update-HelpWybiera plik CAB dla modułu z katalogu SourcePath. Używa nazwy modułu, identyfikatora GUID modułu i kultury interfejsu użytkownika do identyfikowania pliku CAB.

9. Update-Help Rozpakowuje plik CAB, weryfikuje pliki zawartości pomocy i zapisuje pliki zawartości pomocy w podkatalogu specyficznym dla języka katalogu modułu na komputerze użytkownika.

10. Update-Help Tworzy lokalny plik XML HelpInfo przez skopiowanie zdalnego pliku XML HelpInfo. Edytuje lokalny plik XML HelpInfo, tak aby zawierał elementy tylko dla zainstalowanego pliku CAB. Następnie zapisuje lokalny plik XML HelpInfo w katalogu modułu i kończy aktualizację.