Udostępnij przez


Wilogutl.exe

Wilogutl.exe ułatwia analizę plików dziennika z instalacji Instalatora Windows i wyświetla sugerowane rozwiązania błędów znalezionych w pliku dziennika.

Błędy niekrytyczne nie są wyświetlane. Wilogutl.exe można uruchamiać w trybie cichym lub za pomocą interfejsu użytkownika. Narzędzie generuje raporty jako pliki tekstowe zarówno w trybie interfejsu użytkownika, jak i w trybie cichym. Działa najlepiej z pełnymi plikami dziennika Instalatora Windows, ale także działa z dziennikami nieużytnymi. Aby uzyskać więcej informacji, zobacz Logging.

To narzędzie jest dostępne tylko w Składniki zestawu Windows SDK dla deweloperów Instalatora Windows.

Składnia

wilogutl.exe[ opcje<>][<pliku źródłowego>][ opcje<>][<katalogu plików raportów>]

Do uruchomienia w trybie cichym można użyć następujących wierszy polecenia.

wilogutl /q /lc:\mymsilog.log/oc\outputdir\

wilogutl /q /lc:\mymsilog.log

Opcje Command-Line

Wilogutl.exe używa następujących opcji wiersza polecenia bez uwzględniania wielkości liter. Ogranicznik kreski może być używany zamiast ukośnika.

Opcja Opis
żaden Działa w trybie interfejsu użytkownika — bez opcji wiersza polecenia.
/q Określa tryb cichy. Wilogutl.exe generuje pliki raportów i nie wyświetla interfejsu użytkownika.
/l Określa nazwę pliku dziennika do przeanalizowania. Ta opcja jest wymagana w przypadku korzystania z trybu cichego.
/o Określa katalog wyjściowy dla plików raportów. Ta ścieżka wyjściowa jest używana tylko w przypadku działania w trybie cichym. Jeśli opcja nie jest obecna, raporty są umieszczane w katalogu C:\WiLogResults.

 

Po uruchomieniu w trybie interfejsu użytkownika Wilogutl.exe wyświetli następujące okna dialogowe.

Nazwa Opis
Pełny analizator dzienników Instalatora Windows Okno dialogowe Pełne analizatora dzienników Instalatora Windows umożliwia użytkownikom wybranie pliku dziennika na potrzeby analizy:
  • Przycisk Otwórz otwiera plik w Notatniku. Obszar podglądu może służyć do sprawdzania, czy wybrano prawidłowy plik dziennika.
  • Przycisk Analizuj rozpoczyna analizę pliku dziennika i wyświetla okno dialogowe Widok szczegółowego pliku dziennika.
Szczegółowy widok pliku dziennika W oknie dialogowym Szczegółowy widok pliku dziennika są wyświetlane zarejestrowane informacje o błędzie. Użyj przycisków Back i Next, aby przechodzić przez wiele błędów. Aby wyświetlić błędy niekrytyczne, zaznacz pole wyboru Pokaż zignorowane błędy debugowania. Zostanie wyświetlona wersja instalatora na komputerze używanym do uruchomienia zarejestrowanej instalacji. Jeśli zarejestrowana instalacja została uruchomiona z podwyższonym poziomem uprawnień, zaznaczono pole wyboru instalacji z podwyższonym poziomem uprawnień, a informacje znajdują się w polach tekstowych szczegóły uprawnień po stronie klienta i szczegóły uprawnień po stronie serwera pola tekstowe. Okno dialogowe Szczegółowy widok pliku dziennika zawiera następujące przyciski:
  • Stany — pokaż okno dialogowe Funkcje i stany składników.
  • właściwości — pokaż okno dialogowe Właściwości.
  • Zasady — pokaż okno dialogowe Zasady.
  • dziennika z adnotacjami HTML — pokaż dziennik jako plik HTML z adnotacjami.
  • zapisz wyniki — zapisz pliki raportów w określonym katalogu.
  • Pomoc dotycząca komunikatu o błędzie — pokaż pomoc dotyczącą komunikatu o błędzie instalatora.
  • Pomoc — pokaż pomoc dotyczącą analizatora dziennika instalatora Windows.
  • Jak odczytać plik dziennika — pokaż dokument pomocy pliku dziennika.
Stany funkcji i składników W oknie dialogowym Feature and Component States są wyświetlane stany funkcji i składników:
  • Kolumna Feature zawiera nazwę funkcji w pakiecie instalacyjnym.
  • Kolumna Component zawiera nazwę składnika w pakiecie instalacyjnym.
  • Kolumna Zainstalowana zawiera stan funkcji lub składnika na końcu instalacji.
  • Kolumna Request pokazuje wybór użytkownika podczas instalacji dla stanu funkcji lub składnika.
  • W kolumnie Akcja jest wyświetlana akcja podjęta przez instalatora dla funkcji lub składnika.
Aby uzyskać więcej informacji, zobacz MsiGetComponentState i MsiGetFeatureState.
Właściwości W oknie dialogowym Właściwości jest wyświetlany Instalator Windows Właściwości i ich wartości na końcu instalacji. Właściwości można sortować według nazwy lub według wartości:
  • Karta Client zawiera właściwości i wartości podczas części instalacji po stronie klienta.
  • Karta Server zawiera właściwości i wartości podczas części serwera instalacji.
  • Karta zagnieżdżona zawiera właściwości i wartości wszystkich równoczesnych instalacji.
Manifest W oknie dialogowym Zasady są wyświetlane zasady systemu ustawione po instalacji:
  • Wartość 0 (zero) ustawiona dla zasad oznacza, że zasady nie są włączone.
  • Wartość 1 (jedna) oznacza, że zasady są włączone.
  • Wartość ? (znak zapytania) oznacza, że wartość zasad nie jest rejestrowana w dzienniku.
Jeśli potrzebujesz wartości zasad, która nie znajduje się w dzienniku, spróbuj użyć Regedit.exe, aby sprawdzić klucze rejestru na komputerze, który kończy się niepowodzeniem instalacji.

 

Pliki raportów

Podczas przeprowadzania analizy trybu cichego lub kliknięcia przycisku Zapisz wyniki w oknie dialogowym Szczegółowy widok pliku dziennika narzędzie Analizator ustawień Instalatora Windows generuje trzy pliki tekstowe i plik dziennika z adnotacjami HTML.

Poniższa tabela identyfikuje nazwy i zawartość w plikach raportu.

Nazwa Opis
logfilename_summary.txt Podsumowuje plik dziennika. Wyświetla informacje wyświetlane w oknie dialogowym Widok pliku dziennika szczegółowego i pierwszy błąd.
logfilename_errors.txt Określa liczbę błędów, błędów i zalecanych rozwiązań. Ten plik zawiera listę błędów krytycznych i niekrytycznych.
logfilename_policies.txt Identyfikuje nazwy zasad i wartości ustawione na końcu instalacji, jak w oknie dialogowym Zasady.
details_logfilename.htm Dziennik z adnotacjami HTML z legendą kodowania kolorami.

 

Zwracane wartości

Jeśli dla operacji trybu cichego są przekazywane nieprawidłowe argumenty wiersza polecenia, Wilogutl.exe nic nie robi, a proces zwraca jedną z wartości w poniższej tabeli.

Wartość Znaczenie
1 Określono nieprawidłowy katalog wyjściowy.
2 Określono nieprawidłową nazwę pliku dziennika.
3 Przekazano /q, ale brakuje wymaganego przełącznika /l dla nazwy pliku dziennika.
4 Przekazano /l, ale brakuje wymaganego przełącznika /q dla trybu cichego.

 

wydane wersje, narzędzia i pakiety redystrybucyjne

Narzędzia programistyczne Instalatora Windows