Interpretowanie danych wyjściowych poleceń Menedżera serwera

Uwaga
Narzędzie Servermanagercmd.exe jest niezalecane i nie gwarantuje się, że będzie obsługiwane w przyszłych wydaniach systemu Windows. Zaleca się używanie poleceń cmdlet środowiska Windows PowerShell dostępnych dla programu Menedżer serwera.

Polecenie programu Menedżer serwera, ServerManagerCmd.exe, generuje informacje wyjściowe o wykonanych przez siebie operacjach i wyświetla wyróżnione dane wyjściowe na ekranie. Program Menedżer serwera zapisuje także pełniejsze dane wyjściowe w tekstowym pliku dziennika. Program Menedżer serwera można także skonfigurować tak, aby zapisywał wyniki operacji wiersza polecenia w pliku wyników opartym na języku XML.

W tej sekcji wymieniono i opisano kody oraz komunikaty, które można znaleźć w plikach wyjściowych polecenia programu Menedżer serwera.

Wyniki operacji wiersza polecenia Menedżera serwera

Domyślnie program Menedżer serwera zapisuje dane wyjściowe polecenia w pliku tekstowym dziennika logname, który znajduje się w lokalizacji %windir%\logs\ServerManager.log.

	Uwaga
	W tym dzienniku są przechowywane dane wyjściowe dotyczące operacji polecenia programu Menedżer serwera. Są one jednak bardzo szczegółowe i prezentowane w formacie nieprzyjaznym dla użytkownika. Ten plik dziennika jest przydatny, jeśli trzeba skontaktować się z pomocą techniczną firmy Microsoft w sprawie dotyczącej operacji programu Menedżer serwera.

Można zmienić domyślną nazwę i lokalizację pliku dziennika, dodają parametr -logPath do polecenia ServerManagerCmd.exe wiersza polecenia programu Menedżer serwera. Aby uzyskać więcej informacji na temat parametru -logPath i składni polecenia ServerManagerCmd.exe, zobacz Omówienie poleceń Menedżera serwera.

Oprócz tekstowego pliku dziennika domyślnie tworzonego przez program Menedżer serwera, można wydać polecenie, aby program Menedżer serwera przechowywał wyniki swoich operacji w pliku XML o podanej nazwie i lokalizacji. Parametr służący do określania nazwy i lokalizacji pliku wynikowego XML to -resultPath.

Parametry -logPath i -resultPath są używane w wierszu polecenia niezależnie od tego, czy plik odpowiedzi jest używany z poleceniem Menedżer serwera w celu określenia listy ról lub funkcji do usunięcia, czy też pojedynczy element jest instalowany lub usuwany bezpośrednio w wierszu polecenia. Aby uzyskać więcej informacji na temat pliku odpowiedzi wiersza polecenia programu Menedżer serwera, zobacz Tworzenie pliku odpowiedzi dla poleceń Menedżera serwera.

Przykłady

W poniższych przykładach przedstawiono sposób określania nazwy i ścieżki do pliku wyników XML w poleceniu programu Menedżer serwera.

Przykład określania pliku wyników w poleceniu z plikiem odpowiedzi

ServerManagerCmd.exe -inputPath C:\CmdLine\Remove_roles.xml -resultPath C:\CmdLine\010107.xml

W powyższym przykładzie administrator utworzył plik odpowiedzi o nazwie Remove_roles.xml zawierający polecenia do usuwania kliku ról z serwera. Administrator określił nazwę i lokalizację pliku wyników: C:\CmdLine\010107.xml.

Przykład określania pliku wyników w poleceniu bez pliku odpowiedzi

ServerManagerCmd.exe -install npas -allSubFeatures -r C:\CmdLine\Results\010107.xml -restart

W powyższym przykładzie administrator nakazał programowi Menedżer serwera zainstalowanie usług zasad sieciowych i dostępu sieciowego. Należy pamiętać, że w nazwie polecenia dla roli (npas) nie jest uwzględniana wielkość liter.

W tym przykładzie wszystkie usługi ról usług zasad sieciowych i dostępu sieciowego są instalowane zgodnie z żądaniem określonym za pomocą parametru -allSubFeatures. Administrator używa krótkiej formy parametru -resultPath, -r, aby określić nazwę i ścieżkę pliku wyników. Na zakończenie administrator używa parametru -restart, aby wydać programowi Menedżer serwera polecenie ponownego uruchomienia komputera po zakończeniu instalacji roli usług zasad sieciowych i dostępu sieciowego (o ile jest to konieczne).

Opisy komunikatów wyjściowych

Ta sekcja zawiera opis danych wyjściowych i wyników zwróconych przez program Menedżer serwera w pliku wyników opartym na języku XML.

Komunikaty wyjściowe

W poniższej tabeli wymieniono i opisano komunikaty, które polecenie programu Menedżer serwera zapisuje w oknie konsoli i w plikach wyników.

Komunikat	Kod zakończenia	Ciąg tekstowy	Uwagi
Sukces, nie trzeba uruchamiać ponownie	0	Sukces: instalacja powiodła się. Sukces: usunięcie powiodło się.	Dwa inne komunikaty, które mogą się nieco różnić, w zależności od tego, czy w poleceniu użytkownik określił role, czy funkcje.
Sukces, wymagane jest ponowne uruchomienie	3010	Sukces: instalacja powiodła się. Wymagane jest ponowne uruchomienie. Sukces: usunięcie powiodło się. Wymagane jest ponowne uruchomienie.	Ten kod jest zwracany, jeśli jest wymagane ponowne uruchomienie. Po ponownym uruchomieniu komputera może zajść potrzeba uruchomienia programu Menedżer serwera w interfejsie użytkownika systemu Windows Server 2008 R2, aby zakończyć wymaganą konfigurację ról lub funkcji.
Nieprawidłowy argument	4	Błąd ArgumentNotValid: nNieprawidłowy argument {argument} Błąd ArgumentNotValid: brak ścieżki pliku odpowiedzi Błąd ArgumentNotValid: brak ścieżki pliku dziennika Błąd ArgumentNotValid: Nieprawidłowa funkcja: {nazwa}. Nie można odnaleźć nazwy funkcji. Błąd ArgumentNotValid: Nieprawidłowa rola: {nazwa}. Nie można odnaleźć nazwy roli. Błąd ArgumentNotValid: W ścieżce wejściowej określono już następującą nazwę: {nazwa} Błąd ArgumentNotValid: W ścieżce wejściowej określono już następujące ustawienie: {ustawienie} Błąd ArgumentNotValid: Nieprawidłowa funkcja. {nazwa} jest rolą. Błąd ArgumentNotValid: Nieprawidłowa funkcja. {nazwa} jest usługą roli. Błąd ArgumentNotValid: Nieprawidłowa rola. {nazwa} jest funkcją. Błąd ArgumentNotValid: Nieprawidłowa rola. Nazwa {nazwa} jest dla usługi roli. Błąd ArgumentNotValid: Nieprawidłowa usługa roli. {nazwa} jest funkcją. Błąd ArgumentNotValid: Nieprawidłowa usługa roli. {nazwa} jest rolą.	Występuje, gdy użytkownik poda argument, który nie istnieje, lub pominie wymaganą cześć określonego argumentu w wierszu polecenia programu Menedżer serwera. W zależności od argumentu, na który należy zwrócić uwagę, są wyświetlane inne komunikaty. Wartość {argument} reprezentuje nieprawidłowy argument określony przez użytkownika. Wartość {nazwa} reprezentuje nieprawidłowo określoną nazwę roli, usługi roli lub funkcji. Wartość {ustawienie} reprezentuje nazwę nieprawidłowo określonego lub zduplikowanego odwołania do ustawienia roli, usługi roli lub funkcji.
Błąd podczas otwierania lub odczytywania pliku wejściowego	110	Błąd odczytu: plik odpowiedzi nie istnieje: {0} Błąd odczytu: nie można odczytać pliku odpowiedzi: {0} Błąd odczytu: nie można załadować pliku odpowiedzi: {0}. {1}	Występuje, jeśli interfejs wiersza polecenia programu Menedżer serwera nie może odczytać ani zlokalizować pliku odpowiedzi podanego przez użytkownika. Z tym samym kodem błędu (110) są wyświetlane inne komunikaty, w zależności od określonej przyczyny, z powodu której nie można załadować pliku odpowiedzi. Wartość {0} reprezentuje ścieżkę i nazwę określone przez użytkownika. Wartość {1} reprezentuje wyjątek znaleziony przez Menedżer serwera. Zalecaną metodą rozwiązywania problemów w przypadku wystąpienia tego komunikatu o błędzie jest sprawdzenie, czy podano prawidłową nazwę i ścieżkę do pliku odpowiedzi XML i czy ten plik jest zgodny ze schematem pliku odpowiedzi programu Menedżer serwera oraz używa poprawnej struktury elementu. Aby uzyskać więcej informacji na temat prawidłowej konfiguracji i wyglądu pliku odpowiedzi polecenia programu Menedżer serwera, zobacz Tworzenie pliku odpowiedzi dla poleceń Menedżera serwera.
Brak wystarczających uprawnień lub poświadczeń	5	Błąd: program Menedżer serwera może uruchomić tylko członek wbudowanej grupy Administratorzy na komputerze lokalnym. Role i funkcje należy instalować i usuwać tylko z podwyższonym poziomem uprawnień.	Ten błąd występuje, jeśli podane poświadczenia użytkownika nie mają lokalnych praw administracyjnych na serwerze, lub jeśli użytkownik nie otworzył okna wiersza polecenia z podwyższonym poziomem uprawnień. W tym celu należy kliknąć prawym przyciskiem myszy plik wykonywalny Wiersz polecenia lub polecenie Wiersz polecenia w menu Start, a następnie kliknąć polecenie Uruchom jako administrator.
Nie jest wymagana żadna zmiana	1003	Brak zmiany: nie wprowadzono zmian, ponieważ role i funkcje określone w pliku odpowiedzi są już zainstalowane lub zostały już usunięte z komputera lokalnego.	Występuje, jeśli role, usługi ról lub funkcje określone do zainstalowania w pliku odpowiedzi są już zainstalowane na komputerze, lub jeśli plik odpowiedzi żąda ich usunięcia, a program Menedżer serwera zawiera informacje, że nie istnieją one na komputerze lub zostały już usunięte. Tak więc ten komunikat jest wyświetlany, jeśli wynikiem akcji określonych w poleceniu jest pusta operacja.
Wystąpienie Kreatora programu Menedżer serwera jest już uruchomione na tym komputerze	1004	Błąd: Inny użytkownik ma uruchomionego Kreatora w interfejsie użytkownika programu Menedżer serwera.	Jeśli jest już uruchomiony jeden z Kreatorów programu Menedżer serwera (Kreator dodawania ról, dodawania funkcji, dodawania usług ról, usuwania ról, usuwania funkcji, usuwania usług ról), próby uruchomienia wiersza polecenia programu Menedżer serwera w celu zainstalowania lub usunięcia ról, usług ról lub funkcji zakończą się niepowodzeniem. Menedżer serwera, uruchamiając tylko jedno narzędzie w danym momencie, zapobiega konfliktom zmian użytkowników w pakietach oprogramowania zainstalowanych na serwerze. Narzędzia wiersza polecenia lub Kreator programu Menedżer serwera mogą być uruchamiane w tym samym czasie, ale nie jednocześnie.
Wystąpił błąd podczas zbierania listy zainstalowanych ról lub funkcji albo podczas instalowania lub usuwania elementów określonych przez użytkownika.	1000	Błąd: Instalacja co najmniej jednej z następujących ról, usług ról lub funkcji nie powiodła się. Sprawdź dodatkowe informacje w dzienniku programu Menedżer serwera i spróbuj ponownie. Błąd: Usuwanie co najmniej jednego z następujących elementów takich jak role, usługi ról lub funkcje nie powiodło się. Sprawdź dodatkowe informacje w dzienniku programu Menedżer serwera i spróbuj ponownie.	Dwa inne komunikaty, które mogą się nieco różnić, w zależności od tego, czy w poleceniu użytkownik określił role, czy funkcje.
Taki sam jak błąd 1000, tylko wymaga ponownego uruchomienia, aby cofnąć zmiany wprowadzone na komputerze.	1001	Błąd: Instalacja co najmniej jednego z elementów takich jak role, usługi ról lub funkcje nie powiodła się i jest wymagane ponowne uruchomienie komputera w celu cofnięcia wszystkich wprowadzonych zmian. Sprawdź dodatkowe informacje w dzienniku programu Menedżer serwera i spróbuj ponownie. Błąd: Usuwanie co najmniej jednego z elementów takich jak role, usługi ról lub funkcje nie powiodło się i jest wymagane ponowne uruchomienie komputera w celu cofnięcia wszystkich wprowadzonych zmian. Sprawdź dodatkowe informacje w dzienniku programu Menedżer serwera i spróbuj ponownie. Błąd: Instalacja elementu takiego jak rola, usługa roli lub funkcja nie powiodła się, ponieważ należy ponownie uruchomić komputer, aby zakończyć kolejną operację instalowania lub usuwania. Po ponownym uruchomieniu komputera spróbuj ponownie zainstalować element taki jak rola, usługa roli lub funkcja. Błąd: Usuwanie elementu takiego jak rola, usługa roli lub funkcja nie powiodło się, ponieważ należy ponownie uruchomić komputer, aby zakończyć kolejną operację instalowania lub usuwania. Po ponownym uruchomieniu komputera spróbuj ponownie usunąć element taki jak rola, usługa roli lub funkcja.	Inne komunikaty, które mogą się nieco różnić, w zależności od tego, czy użytkownik określił role czy funkcje w poleceniu.
Błąd rodzajowy	1002	Błąd: Błąd rodzajowy. {0}	Jest to błąd rodzajowy, dla którego nie są dostępne żadne informacje na temat rozwiązywania problemów. W przypadku odebrania takiego błędu zaleca się, aby użytkownik sprawdził składnię polecenia, sprawdził, czy jest zalogowany na komputerze lokalnym jako członek grupy Administratorzy i ponownie wykonał polecenie. Wartość {0} reprezentuje wyjątek znaleziony przez Menedżer serwera.

Plik wyników XML

Poniżej przedstawiono przykład pliku wyników XML utworzonego przez Menedżer serwera w przypadku dodania parametru -resultPath lub -r do wiersza polecenia programu Menedżer serwera i podania w nim nazwy i ścieżki.

< ServerManagerConfigurationResult
Action="Install"
Time="2006-11-29T14:26:39"
Language="en-US"
Success="true"
RequiresReboot="false"
xmlns="https://schemas.microsoft.com/sdm/Windows/ServerManager/Configuration/2007/1">
<Message Level="Information">Start Installing...</Message>
<Role DisplayName="DHCP Server"
Id="DHCP"
Success="true"
RequiresReboot="false"
RequestedBy="UserSpecified">
<Message Level="Information">Succeeded: [DHCP Server] </Message>
</Role>
<Message Level="Information">Install succeeded.</Message>
</ServerManagerConfigurationResult>

W poniższej tabeli wymieniono i opisano elementy znajdujące się w pliku wyników.

Element lub atrybut	Opis
ServerManagerCommandLineResult	Element nagłówka, kontener całego pliku.
Akcja	Określa, czy wyświetlane wyniki dotyczą operacji instalowania czy usuwania.
Time	Wyświetla datę i czas ukończenia operacji.
Language	Wyświetla kod języka (w przykładzie jest to język polski) dla zlokalizowanych komunikatów zawartych w wynikach.
Success	Wyświetla wartość „true”, jeśli akcja zakończyła się pomyślnie dla wszystkich elementów takich jak role, usługi ról i funkcje określonych w poleceniu, albo wartość „false”, jeśli akcja zakończyła się niepowodzeniem w przypadku co najmniej jednego elementu takiego jak role, usługi ról lub funkcje.
RequiresReboot	Wyświetla wartość „true”, jeśli należy ponownie uruchomić komputer z powodu pomyślnej operacji instalowania lub usuwania, albo wartość „false”, jeśli nie jest to wymagane.
Xmlns	Ten atrybut odwołuje się do definicji schematu XML wiersza polecenia programu Menedżer serwera.
Message	Wszystkie komunikaty informacyjne, ostrzegawcze i komunikaty o błędach są zawarte w treści pliku XML. Ogólny komunikat dotyczący całej operacji znajduje się na najwyższym poziomie. Jednak jeśli komunikat dotyczy określonego elementu takiego jak rola, usługa roli lub funkcja, ten komunikat jest zawarty w tym konkretnym elemencie. Komunikaty są zlokalizowane w języku określonym przez atrybut Language. Level Opisuje, czy komunikat jest komunikatem informacyjnym, ostrzegawczym, czy komunikatem o błędzie. Code Jeśli ma zastosowanie, wyświetla błąd numeryczny lub kod komunikatu. Kody błędów i komunikatów programu Menedżer serwera zostały opisane w tym temacie w sekcji Tekstowy plik dziennika.
Role, Role Service lub Feature	Elementy Role, Role Service lub Feature mogą wystąpić wiele razy w pliku wyników w zależności od obiektów, których zainstalowania lub usunięcia żąda plik odpowiedzi wiersza polecenia programu Menedżer serwera. DisplayName Zlokalizowana nazwa elementu, takiego jak rola, usługa roli lub funkcja. Id Nazwa polecenia dla elementu, takiego jak rola, usługa roli lub funkcja. Lista nazw poleceń dla elementów takich jak role, usługi ról lub funkcje jest dostępna w temacie Omówienie poleceń Menedżera serwera. RootParent Nazwa obiektu nadrzędnego dla wartości określonej w atrybucie DisplayName. Na przykład obiektem nadrzędnym usługi roli Filtrowanie żądań jest rola Serwer sieci Web. Success Wyświetla wartość true, jeśli akcja określona w atrybucie Action została pomyślnie wykonana na obiekcie określonym w atrybucie DisplayName, albo wartość false, jeśli ta akcja zakończyła się niepowodzeniem. RequiresReboot Wyświetla wartość true, jeśli operacja instalowania lub usuwania obiektu określonego w atrybucie DisplayName wymaga ponownego uruchomienia komputera, albo wartość false, jeśli nie jest to wymagane. Skipped Wyświetla wartość true, jeśli role, usługi ról lub funkcje określone w pliku odpowiedzi do zainstalowania są już zainstalowane na komputerze, lub jeśli plik odpowiedzi żąda ich usunięcia, a program Menedżer serwera zawiera informacje, że nie istnieją one na komputerze lub zostały już usunięte. Tak więc ten atrybut ma wartość „true” tylko wtedy, gdy wynikiem akcji określonych w poleceniu jest pusta operacja. Wyświetla wartość false, jeśli program Menedżer serwera ukończył akcje określone w poleceniu. RequestedBy Wyświetla przyczynę zainstalowania lub usunięcia elementu, takiego jak rola, usługa roli lub funkcja. Istnieją cztery możliwe wartości. Bezpośrednie żądanie użytkownika Wymagane przez zależność następnego elementu takiego jak rola, usługa roli lub funkcja Obiekt kontenera został zainstalowany lub usunięty, a ten obiekt jest wybierany domyślnie Wybrano wszystkie obiekty podrzędne elementów takich jak rola, usługa roli lub funkcja kontenera (na przykład użytkownik dodał parametr -allSubFeatures do polecenia programu Menedżer serwera) Message Zobacz opis elementu Message w poprzednim wierszu. Komunikaty zagnieżdżone w elementach Role, Role Service lub Feature są specyficzne tylko dla tego obiektu.

	Uwaga
	Narzędzie Servermanagercmd.exe jest niezalecane i nie gwarantuje się, że będzie obsługiwane w przyszłych wydaniach systemu Windows. Zaleca się używanie poleceń cmdlet środowiska Windows PowerShell dostępnych dla programu Menedżer serwera.