A Kiszolgálókezelő parancskimeneteinek értelmezése

Megjegyzés
A Servermanagercmd.exe elavult, és a Windows későbbi kiadásai által való támogatása nem szavatolt. Javasolt a Windows PowerShell-parancsmagok használata, amelyek az Kiszolgálókezelő alkalmazás esetében állnak rendelkezésre.

A ServerManagerCmd.exe Kiszolgálókezelő parancssori eszköze a műveletekről kimenetet generál, és a képernyőn megjeleníti ennek kiemelt részeit. A Kiszolgálókezelő emellett egy szöveges naplófájlba ennél jóval részletesebben is rögzíti az eseményeket. A Kiszolgálókezelő szolgáltatást úgy is be lehet állítani, hogy a parancssori műveletek eredményeit egy XML-alapú eredményfájlba írja.

Ez a szakasz ismerteti a Kiszolgálókezelő parancskimeneti fájljaiban lévő kódokat és üzeneteket.

A Kiszolgálókezelő parancssori műveleteinek eredményei

Alapértelmezés szerint a Kiszolgálókezelő a logname.txt szöveges naplófájlba írja a parancsok kimenetét, amely a %windir%\logs\ServerManager.log útvonalon érhető el.

	Megjegyzés
	Habár ez a naplófájl tartalmazza a Kiszolgálókezelő parancs műveleteinek kimenetét, ez nagyon részletes és nem felhasználóbarát formátumú. Ez a naplófájl akkor hasznos, ha a Kiszolgálókezelő műveleteivel kapcsolatban a Microsoft támogatási szolgáltatásának segítségét kell kérni.

A naplófájl alapértelmezés szerinti neve és helye a -logPath paraméternek a ServerManagerCmd.exe parancs utáni Kiszolgálókezelő parancssorba írásával módosítható. A -logPath paraméterrel és a ServerManagerCmd.exe parancs szintaxisával kapcsolatos további információ A Kiszolgálókezelő parancsai – áttekintés című témakörben található.

A Kiszolgálókezelő által alapértelmezés szerint létrehozott szöveges naplófájl mellett megadhatja, hogy a Kiszolgálókezelő a műveletek eredményeit egy felhasználó által megadható névvel és elérési úttal rendelkező XML-fájlban is tárolja. Az XML formátumú eredményfájl neve és elérési útja a -resultPath paraméterrel adható meg.

A -logPath és a -resultPath paramétert a parancssorban kell használni függetlenül attól, hogy a Kiszolgálókezelő paranccsal válaszfájlt használ az eltávolítani kívánt szerepkörök vagy szolgáltatások listájának megadására, vagy közvetlenül a parancssorból telepít, illetve távolít el egy-egy elemet. A Kiszolgálókezelő parancssori válaszfájljairól további információt a Válaszfájl létrehozása a Kiszolgálókezelő parancsaihoz című szakaszban találhat.

Példák

A következő példák azt mutatják, hogyan adhatja meg a Kiszolgálókezelő parancsban egy XML formátumú eredményfájl nevét és elérési útját.

Példa az eredményfájl válaszfájllal való parancssori megadására

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

Ebben a példában a rendszergazda létrehozott egy Remove_roles.xml nevű válaszfájlt, amely szerepkörök kiszolgálóról történő eltávolítására szolgáló parancsokat tartalmaz. A rendszergazda megadta az eredményfájl nevét és elérési útját is: C:\CmdLine\010107.xml.

Példa az eredményfájl válaszfájl nélkül való parancssori megadására

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

Ebben a példában a rendszergazda arra utasította a Kiszolgálókezelő alkalmazást, hogy telepítse a Hálózati házirend- és elérési szolgáltatásokat. A szerepkör parancsnevében - npas - a rendszer megkülönbözteti a kis- és nagybetűket.

Ebben a példában a rendszergazda a Hálózati házirend- és elérési szolgáltatásoknak a -allSubFeatures paraméterrel meghatározott összes szolgáltatását telepíti. A rendszergazda a -resultPath paraméter rövidített, -r alakját használja az eredményfájl nevének és elérési útjának megadásához. Végül a rendszergazda a -restart paraméterrel arra utasítja a Kiszolgálókezelő alkalmazást, hogy szükség esetén indítsa újra a számítógépet, ha a Hálózati házirend- és elérési szolgáltatások szerepkör telepítése befejeződött.

A kimeneti üzenetek leírása

Ez a szakasz ismerteti a Kiszolgálókezelő szolgáltatás által XML-alapú eredményfájlban visszaadott kimenetet és eredményeket.

Kimeneti üzenetek

A táblázatban azon üzenetek felsorolása és leírása látható, melyeket a Kiszolgálókezelő parancs ír a konzolablakba és az eredményfájlokba.

Üzenet	Kilépési kód	Karakterlánc	Megjegyzések
Sikeres művelet, újraindítás nem szükséges	0	Siker: A telepítés sikerült. Siker: Az eltávolítás sikerült.	Az üzenetek kismértékben különbözhetnek egymástól attól függően, hogy a felhasználó szerepköröket vagy szolgáltatásokat adott-e meg a parancsban.
Sikeres művelet, a számítógépet újra kell indítani.	3010	Siker: A telepítés sikeresen befejeződött. A számítógépet újra kell indítani. Siker: Az eltávolítás sikeresen befejeződött. A számítógépet újra kell indítani.	Ez a kód jelenik meg, ha újraindításra van szükség. Lehetséges, hogy a számítógép újraindítása után a szerepkörök és szolgáltatások beállításának befejezéséhez a Kiszolgálókezelő parancsot futtatni kell a Windows Server 2008 R2 felhasználói felületén.
Érvénytelen argumentum	4	Érvénytelen argumentum: érvénytelen argumentum: {argumentum} Érvénytelen argumentum: hiányzik a válaszfájl elérési útja Érvénytelen argumentum: hiányzik a naplófájl elérési útja Érvénytelen argumentum: érvénytelen szolgáltatás: '{név}'. A szolgáltatás neve nem található. Érvénytelen argumentum: érvénytelen szerepkör: '{név}'. A szerepkör neve nem található. Érvénytelen argumentum: A következő nevet már megadták a bemeneti elérési útnál: {név} Érvénytelen argumentum: A következő beállítást már megadták a bemeneti elérési útnál: {beállítás} Érvénytelen argumentum: érvénytelen szolgáltatás. A(z) '{név}' egy szerepkör. Érvénytelen argumentum: érvénytelen szolgáltatás. A(z) '{név}' egy szerepkör-szolgáltatás. Érvénytelen argumentum: érvénytelen szerepkör. A(z) '{név}' egy szolgáltatás. Érvénytelen argumentum: érvénytelen szerepkör. A(z) '{név}' egy szerepkör-szolgáltatás. Érvénytelen argumentum: érvénytelen szerepkör-szolgáltatás. A(z) '{név}' egy szolgáltatás. Érvénytelen argumentum: érvénytelen szerepkör-szolgáltatás. A(z) '{név}' egy szerepkör.	Ezek az üzenetek akkor jelennek meg, ha a felhasználó nem létező argumentumot ad meg, vagy kihagyja egy adott argumentum kötelező részét a Kiszolgálókezelő parancssorban. A figyelmet igénylő argumentumtól függően más és más üzenet jelenik meg. Az {argumentum} jelöli a felhasználó által megadott helytelen argumentumot. A {név} jelöli a helytelenül megadott szerepkör, szerepkör-szolgáltatás vagy szolgáltatás nevét. A {beállítás} jelöli azon helytelenül vagy duplikálva megadott hivatkozás nevét, mely egy szerepkör, szerepkör-szolgáltatás vagy szolgáltatás beállítására vonatkozik.
Hiba a bementi fájl megnyitásakor vagy olvasásakor	110	Olvasási hiba: nem létező válaszfájl: {0} Olvasási hiba: nem sikerült a válaszfájl beolvasása: {0} Olvasási hiba: nem sikerült a válaszfájl betöltése: {0}. {1}	Ez az üzenet akkor jelenik meg, ha a Kiszolgálókezelő parancssori felülete nem tudja olvasni vagy betölteni a felhasználó által megadott válaszfájlt. Attól függően, hogy a válaszfájlt milyen okból nem lehetett betölteni más és más üzenet jelenik meg ugyanazzal a hibakóddal (110). A {0} jelöli a felhasználó által megadott nevet és elérési utat. Az {1} jelöli a Kiszolgálókezelő által talált kivételt. Ilyen hibaüzenet esetén a hiba elhárításához ellenőrizze, hogy az XML-válaszfájl nevét és elérési útját helyesen adta-e meg, a válaszfájl megfelel-e a Kiszolgálókezelő válaszfájlsémájának, és helyes elemszerkezetet használ-e. A Kiszolgálókezelő parancs válaszfájljának helyes beállításáról és megjelenéséről további információt a Válaszfájl létrehozása a Kiszolgálókezelő parancsaihoz című szakaszban találhat.
Nem megfelelő engedélyek vagy hitelesítő adatok	5	Hiba: A Kiszolgálókezelőt csak a helyi számítógép beépített rendszergazdai csoportjának valamelyik tagja futtathatja. Szerepkörök és szolgáltatások telepítése és eltávolítása csak emelt szintű engedélyekkel lehetséges.	Ez a hiba akkor fordul elő, ha a megadott felhasználói hitelesítő adatokhoz a kiszolgálón nincs helyi felügyeleti jog hozzárendelve, vagy ha egy felhasználó nem emelt szintű jogokkal nyitotta meg a parancssorablakot. A probléma elhárításához kattintson a jobb gombbal a parancssori parancsra vagy a Start menü Parancssor elemére, majd kattintson a Futtatás rendszergazdaként parancsra.
Nem szükséges módosítás	1003	Nincs változás: nem léptek életbe változások, mert a válaszfájlban megadott szerepkörök és szolgáltatások már telepítve vannak, vagy már eltávolították őket a helyi számítógépről.	Ez az üzenet akkor jelenik meg, ha a válaszfájlban megadott telepítendő szerepkörök, szerepkör-szolgáltatások vagy szolgáltatások már telepítve vannak a számítógépen, vagy ha a válaszfájl az eltávolításukat kéri, de a Kiszolgálókezelő megállapította, hogy nem léteznek a számítógépen, vagy már el lettek távolítva. Más szóval az üzenet akkor jelenik meg, ha a parancsban megadott műveletek nem hoznak eredményt.
A Kiszolgálókezelő varázsló egy példánya már fut a számítógépen.	1004	Hiba: Egy másik felhasználó futtat egy varázslót a Kiszolgálókezelő felhasználói felületen.	Ha a Kiszolgálókezelő varázslók (Szerepkör hozzáadása, Szolgáltatás hozzáadása, Szerepkör-szolgáltatás hozzáadása, Szerepkörök eltávolítása, Szolgáltatások eltávolítása, Szerepkör-szolgáltatások eltávolítása) közül egy már fut, akkor a Kiszolgálókezelő parancssorát nem lehet futtatni a szerepkörök, szerepkör-szolgáltatások vagy szolgáltatások telepítéséhez. A Kiszolgálókezelő azáltal, hogy egyszerre csak egy eszköz futtatását engedélyezi, megakadályozza az egymással ütköző felhasználói módosításokat a kiszolgálón telepített szoftvercsomagokon. Egy időben vagy a parancssori eszközök, vagy a Kiszolgálókezelő varázsló futhat, de nem futhatnak egyszerre.
Hiba történt a telepített szerepkörök vagy szolgáltatások listájának összeállítása vagy a felhasználó által megadott elemek telepítése, illetve eltávolítása közben.	1000	Hiba: Egy vagy több szerepkör, szerepkör-szolgáltatás vagy szolgáltatás telepítése nem sikerült. Részletekért tekintse meg a Kiszolgálókezelő naplóját, majd próbálkozzon újra. Hiba: Egy vagy több szerepek, szerepszolgáltatások vagy funkciók eltávolítása nem sikerült. Részletekért tekintse meg a Kiszolgálókezelő naplóját, majd próbálkozzon újra.	Az üzenetek kismértékben különbözhetnek egymástól attól függően, hogy a felhasználó szerepköröket vagy szolgáltatásokat adott-e meg a parancsban.
Megegyezik az 1000-es számú hibával, kivéve hogy ennél a hibánál a végrehajtott esetleges módosítások visszavonásához a számítógépet újra kell indítani.	1001	Hiba: A szerepek, szerepszolgáltatások vagy funkciók közül egy vagy több telepítése nem sikerült, és a számítógépet újra kell indítani a számítógépen végrehajtott esetleges módosítások visszavonásához. Részletekért tekintse meg a Kiszolgálókezelő naplóját, majd próbálkozzon újra. Hiba: A szerepek, szerepszolgáltatások vagy funkciók közül egy vagy több eltávolítása nem sikerült, és a számítógépet újra kell indítani a számítógépen végrehajtott esetleges módosítások visszavonásához. Részletekért tekintse meg a Kiszolgálókezelő naplóját, majd próbálkozzon újra. Hiba: A szerep, szerepfunkció vagy funkció telepítése nem sikerült, mert a számítógépet újra kell indítani egy másik telepítési vagy eltávolítási művelet végrehajtásához. A számítógép újraindítása után próbálkozzon ismét a szerep, szerepfunkció vagy funkció telepítésével. Hiba: A szerep, szerepfunkció vagy funkció eltávolítása nem sikerült, mert a számítógépet újra kell indítani egy másik telepítési vagy eltávolítási művelet végrehajtásához. A számítógép újraindítása után próbálkozzon ismét a szerep, szerepfunkció vagy funkció eltávolításával.	Az üzenetek kicsit különbözhetnek egymástól attól függően, hogy a felhasználó szerepköröket vagy szolgáltatásokat adott-e meg a parancsban.
Általános hiba	1002	Hiba: Általános hiba. {0}	Ez egy általános hiba, amelyhez nincs hibaelhárítási információ. Ha ez a hibaüzenet jelenik meg, ellenőrizze, hogy szintaktikailag helyesen írta-e be a parancsot, és a Rendszergazdák csoport tagjaként jelentkezett-e be a helyi számítógépre, majd próbálkozzon újra a parancs végrehajtásával. Az {0} jelöli a Kiszolgálókezelő által talált kivételt.

Az XML formátumú eredményfájl

A következő példa egy XML formátumú eredményfájl, amelyet a Kiszolgálókezelő hoz létre, amikor a Kiszolgálókezelő parancssorába megadja a -resultPath vagy a -r paramétert, és a paraméterben definiál egy nevet és egy elérési utat.

< 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>

A következő táblázat az eredményfájlban található elemek felsorolását és leírását tartalmazza.

Elem vagy attribútum	Leírás
ServerManagerCommandLineResult	Fejlécelem; a teljes fájl tárolója.
Action	Meghatározza, hogy a megjelenített eredmények telepítési vagy eltávolítási műveletből származnak-e.
Time	Megjeleníti a művelet végrehajtásának dátumát és idejét.
Language	Megjeleníti az eredményekben lévő honosított üzenetek nyelvének kódját (ebben a példában az amerikai angol nyelvét).
Success	Ha a művelet a parancsba foglalt szerepek, szerepszolgáltatások és funkciók esetében maradéktalanul sikerült, a „true”, ha egyes szerepek, szerepszolgáltatások vagy funkciók esetében nem sikerült, a „false” értéket jeleníti meg.
RequiresReboot	Ha a sikeres telepítési vagy eltávolítási művelet miatt újra kell indítani a számítógépet, a „true”, ellenkező esetben a „false” értéket jeleníti meg.
Xmlns	Ez az attribútum a Kiszolgálókezelő parancssorának XML-sémadefiníciójára utal.
Üzenet	Minden tájékoztató-, figyelmeztető- vagy hibaüzenet megtalálható az XML-fájl törzsében. A legfelső szinten egy, az egész műveletre vonatkozó általános üzenet olvasható. Ha azonban egy üzenet egy megadott szerep, szerepfunkció vagy funkció elemre vonatkozik, akkor az üzenetet az adott elemhez tartozó rész tárolja. Az üzenetek a Language attribútumban megadott nyelven jelennek meg. Level Azt jelzi, hogy az üzenet tájékoztató, figyelmeztető vagy hiba jellegű. Code Szükség esetén megjeleníti a hiba vagy üzenet számkódját. A Kiszolgálókezelő hiba- és üzenetkódjainak leírása a jelen témakör Szöveges naplófájl című szakaszában található.
Role, Role Service vagy Feature	A Role, Role Service vagy Feature (szerepkör, szerepkör-szolgáltatás vagy szolgáltatás) elemek többször is előfordulhatnak az eredményfájlban azoktól az objektumoktól függően, amelyek telepítését vagy eltávolítását a Kiszolgálókezelő parancssori válaszfájl kéri. DisplayName A szerep, szerepfunkció vagy funkció honosított neve. Id A szerep, szerepfunkció vagy funkció parancsneve. A szerepek, szerepszolgáltatások vagy funkciók parancsneveinek listája megtalálható A Kiszolgálókezelő parancsai – áttekintés című témakörben. RootParent A DisplayName attribútumban meghatározott érték szülőobjektumának neve. A Kérésszűrés szerepkör-szolgáltatás szülőobjektuma például a Webkiszolgáló. Success Ha az Action attribútumban meghatározott művelet végrehajtása a DisplayName attribútumban megadott objektumon sikerül, a „true”, ellenkező esetben a „false” értéket jeleníti meg. RequiresReboot Ha a DisplayName attribútumban meghatározott objektum telepítéséhez, illetve eltávolításához a számítógépet újra kell indítani, a „true”, ellenkező esetben a „false” értéket jeleníti meg. Skipped A „true” értéket jeleníti meg, ha a válaszfájlban megadott telepítendő szerepek, szerepszolgáltatások vagy funkciók már telepítve vannak a számítógépre, illetve ha a válaszfájl ezek eltávolítását kérte, de a Kiszolgálókezelő megállapította, hogy az elemek nem léteznek a számítógépen, vagy már el lettek távolítva. Más szóval ennek az attribútumnak csak akkor „true” az értéke, ha a parancsban megadott műveletek nem hoznak eredményt. A „false” értéket akkor jeleníti meg az attribútum, ha a Kiszolgálókezelő elvégezte a parancsban meghatározott műveletet. RequestedBy Megjeleníti a szerep, szerepfunkció vagy funkció telepítésének, illetve eltávolításának okát. Négy lehetséges értéke van. Egy felhasználó közvetlenül kérte Egy másik szerep, szerepfunkció vagy funkció elemmel való függőség megköveteli Egy tárolóobjektum lett telepítve vagy eltávolítva, és ez az objektum alapértelmezés szerint ki lett választva Egy szerep, szerepfunkció vagy funkció tárolójának minden gyermekobjektuma ki lett választva (például a felhasználó hozzáadta az -allSubFeatures paramétert a Kiszolgálókezelő parancsához) Message Az elem leírását az előző sor tartalmazza. A Role, a Role Service vagy a Feature elembe ágyazott üzenetek csak arra az adott objektumra vonatkoznak.

	Megjegyzés
	A Servermanagercmd.exe elavult, és a Windows későbbi kiadásai által való támogatása nem szavatolt. Javasolt a Windows PowerShell-parancsmagok használata, amelyek az Kiszolgálókezelő alkalmazás esetében állnak rendelkezésre.