OBS | |
Servermanagercmd.exe är inaktuell, och vi kan inte garantera att det stöds i framtida versioner av Windows. Du bör därför använda de Windows PowerShell-cmdlets som är tillgängliga för Serverhanteraren. |
Serverhanteraren-kommandot ServerManagerCmd.exe genererar utdata om sina operationer och visar utdrag ur dessa utdata på skärmen. Serverhanteraren skriver också mycket mer mångordig utdata till en loggfil i textformat. Du kan också konfigurera Serverhanteraren för att skriva resultaten av kommandoradsoperationer till en XML-baserad resultatfil.
Det här avsnittet identifierar och beskriver de koder och meddelanden som finns i Serverhanteraren-kommandoutdatafiler.
Resultat av Serverhanterarens kommandoradsoperationer
Som standard skriver Serverhanteraren kommandoutdata till en textloggfil, logname.txt, som finns på %windir%\logs\ServerManager.log.
OBS | |
Trots att denna loggfil lagrar utdata om Serverhanteraren-kommandots operationer är dessa utdata mycket mångordiga och inte i något användarvänligt format. Denna loggfil är användbar om du behöver kontakta Microsofts Produktsupport om Serverhanteraren-operationer. |
Du kan ändra loggfilens standardnamn och plats genom att lägga till parametern -logPath i kommandoradsverktyget för Serverhanteraren, ServerManagerCmd.exe. Mer information om parametern -logPath och syntaxen för ServerManagerCmd.exe finns i Översikt över Serverhanteraren-kommandon.
Förutom textloggfilen som Serverhanteraren skapar som standard kan du kommendera Serverhanteraren att lagra resultatet av sina operationer i en XML-fil som du namnger och anger en plats för. Parametern för att ange namn och plats för en XML-resultatfil är -resultPath.
Parametrarna -logPath och -resultPath används vid kommandoraden, oavsett om du använder en svarsfil med Serverhanteraren-kommandot för att ange en lista över roller eller funktioner för borttagning, eller om du installerar eller tar bort ett enskilt objekt direkt vid kommandoraden. Mer information om svarsfilen för Serverhanteraren-kommandon finns i Skapa en svarsfil för Serverhanteraren-kommandon.
Exempel
I följande exempel visas hur du anger namn och sökväg till en XML-resultatfil i Serverhanteraren-kommandot.
Exempel på resultatfilspecifikation i ett kommando med en svarsfil
ServerManagerCmd.exe -inputPath C:\CmdLine\Remove_roles.xml -resultPath C:\CmdLine\010107.xml
I föregående exempel har en administratör skapat en svarsfil vid namn Remove_roles.xml
, som innehåller kommandon för borttagning av flera roller från en server. Administratören har angivit namn och plats för resultatfilen, C:\CmdLine\010107.xml
.
Exempel på resultatfilspecifikation i ett kommando utan svarsfil
ServerManagerCmd.exe -install npas -allSubFeatures -r C:\CmdLine\Results\010107.xml -restart
I exemplet ovan har en administratör angett att Serverhanteraren ska installera Nätverksprincip- och åtkomsttjänster. Observera att kommandonamnet för rollen, npas, inte är skiftlägeskänsligt.
I det här exemplet installeras alla rolltjänster för Nätverksprincip- och åtkomsttjänster, enligt begäran med parametern -allSubFeatures. Administratören använder kortformen för parametern -resultPath, -r, för att ange ett filnamn och en sökväg för resultatfilen. Slutligen använder administratören parametern -restart för att ange att Serverhanteraren ska starta om datorn när installationen av rollen Nätverksprincip- och åtkomsttjänster har slutförts, om detta behövs.
Beskrivningar av utdatameddelanden
I detta avsnitt beskrivs utdata och resultat som returneras av Serverhanteraren i en XML-baserad resultatfil.
Utdatameddelanden
I följande tabell identifieras och beskrivs meddelanden som Serverhanteraren-kommandot skriver till konsolfönstret och till resultatfiler.
Meddelande | Slutkod | Textsträng | Kommentarer |
---|---|---|---|
Klart, ingen omstart behövs |
0 |
Klart: Installationen lyckades. Klart: Borttagningen lyckades. |
Två olika meddelanden kan variera något, beroende på om användaren angav roller eller funktioner i kommandot. |
Klart, omstart krävs |
3010 |
Klart: Installationen lyckades. En omstart krävs. Klart: Borttagningen lyckades. En omstart krävs. |
Denna kod returneras när en omstart krävs. Efter omstart av datorn kan du behöva köra Serverhanteraren i Windows Server 2008 R2-användargränssnittet för att slutföra nödvändig konfiguration av roller eller funktioner. |
Ogiltigt argument |
4 |
Ogiltigt argument: Ogiltigt argument {argument} Ogiltigt argument: Saknar sökväg till svarsfilen Ogiltigt argument: Saknar sökväg till loggfilen Ogiltigt argument: Funktion ej giltig: '{namn}'. Namnet på funktionen hittades inte. Ogiltigt argument: Ogiltig roll: '{namn}'. Namnet på rollen hittades inte. Ogiltigt argument: Följande namn har redan angivits i indatasökvägen: {namn} Ogiltigt argument: Följande inställning har redan angivits i indatasökvägen: {inställning} Ogiltigt argument: Ogiltig funktion. '{namn}' är en roll. Ogiltigt argument: Ogiltig funktion. '{namn}' är en rolltjänst. Ogiltigt argument: Ogiltig roll. '{namn}' är en funktion. Ogiltigt argument: Ogiltig roll Namnet '{namn}' är en rolltjänst. Ogiltigt argument: Ogiltig rolltjänst. '{namn}' är en funktion. Ogiltigt argument: Ogiltig rolltjänst. '{namn}' är en roll. |
Inträffar när en användare anger ett argument som inte finns eller utelämnar en obligatorisk del av ett angivet argument på Serverhanteraren-kommandoraden. Olika meddelanden visas beroende på vilket argument det gäller. {argument} representerar det felaktiga argument som användaren angivit. {namn} representerar det felaktigt angivna namnet på rollen, rolltjänsten eller funktionen. {inställning} representerar namnet på en felaktigt angiven eller dubbel hänvisning till en inställning för en roll, rolltjänst eller funktion. |
Fel vid öppning eller läsning av indatafil |
110 |
Inläsningsfel: Svarsfilen finns inte: {0} Inläsningsfel: Det gick inte att läsa svarsfilen: {0} Inläsningsfel: Det gick inte att läsa in svarsfilen: {0}. {1} |
Inträffar om Serverhanteraren-kommandoradsgränssnittet inte kan läsa eller hitta svarsfilen som en användare anger. Olika meddelanden visas för samma felkod (110) beroende på det specifika skälet till varför svarsfilen inte kunde laddas in. {0} representerar sökvägen och namnet som användaren angivit. {1} representerar undantaget som Serverhanteraren identifierat. Rekommenderad felsökning om detta meddelande uppstår är att verifiera att du har angivit rätt namn och sökväg till XML-svarsfilen, och verifiera att svarsfilen valideras till Serverhanteraren-svarsfilschemat och använder rätt elementstruktur. Mer information om rätt konfiguration och utseende på en Serverhanteraren-kommandosvarsfil finns i Skapa en svarsfil för Serverhanteraren-kommandon. |
Otillräckliga behörigheter eller autentiseringsuppgifter |
5 |
Fel: Serverhanteraren kan bara köras av en medlem av den inbyggda gruppen Administratörer på den lokala datorn. Du bör endast installera och ta bort roller och funktioner med ökade behörigheter. |
Detta fel uppstår om de angivna användarautentiseringsuppgifterna inte har lokala administrativa behörigheter på servern, eller om en användare inte har öppnat kommandotolken med ökade behörigheter. Detta gör du genom att högerklicka på kommandotolkens körbara fil, eller högerklicka på Kommandotolken på Start-menyn, och sedan klicka på Kör som administratör. |
Ingen ändring behövs |
1003 |
Ingen ändring: Inga ändringar gjordes, eftersom de roller och funktioner som angetts i svarsfilen redan hade installerats eller tagits bort från den lokala datorn. |
Detta uppstår om rollerna, rolltjänsterna eller funktionerna som anges i svarsfilen för installation redan är installerade på datorn, eller om svarsfilen begär borttagning av dem och Serverhanteraren inte hittar dem på datorn eller om de redan är borttagna. Med andra ord uppstår det här meddelandet om de åtgärder som anges i kommandot resulterar i en null-operation. |
En instans av en Serverhanteraren-guide körs redan på den här datorn |
1004 |
Fel: En annan användare kör en guide i Serverhanteraren-gränssnittet. |
Om en av Serverhanteraren-guiderna (Lägg till roller, Lägg till funktioner, Lägg till rolltjänster, Ta bort roller, Ta bort funktioner, Ta bort rolltjänster) redan körs kommer försök att köra Serverhanteraren-kommandotolken för att installera eller ta bort roller, rolltjänster eller funktioner att misslyckas. Serverhanteraren förhindrar att användare gör ändringar av programpaket installerade på en server, som är i konflikt med varandra genom att bara tillåta körning av ett verktyg i taget. Kommandoradsverktygen eller en Serverhanteraren-guide kan köras separat, men båda kan inte köras samtidigt. |
Ett fel uppstod vid insamling av listan över installerade roller eller funktioner, eller vid installation eller borttagning av elementen som användaren angivit. |
1000 |
Fel: Installationen av en eller flera roller, rolltjänster eller funktioner misslyckades. Kontrollera om det finns mer information i Serverhanteraren-loggen och försök igen. Fel: Borttagning av en eller flera roller, rolltjänster eller funktioner misslyckades. Kontrollera om det finns mer information i Serverhanteraren-loggen och försök igen. |
Två olika meddelanden kan variera något, beroende på om användaren angav roller eller funktioner i kommandot. |
Samma som fel 1000, förutom att det här felet kräver en omstart för att ångra alla ändringar som gjorts på datorn. |
1001 |
Fel: Installationen av en eller flera roller, rolltjänster eller funktioner misslyckades, och en omstart krävs för att ångra alla ändringar som gjorts på datorn. Kontrollera om det finns mer information i Serverhanteraren-loggen och försök igen. Fel: Borttagning av en eller flera roller, rolltjänster eller funktioner misslyckades, och en omstart krävs för att ångra alla ändringar som gjorts på datorn. Kontrollera om det finns mer information i Serverhanteraren-loggen och försök igen. Fel: Installationen av roll, rolltjänst eller funktion misslyckades eftersom datorn måste startas om innan en ny installation eller borttagning kan slutföras. Efter omstart av datorn kan du försöka installera roll, rolltjänst eller funktion igen. Fel: Borttagning av roll, rolltjänst eller funktion misslyckades eftersom datorn måste startas om innan en ny installation eller borttagning kan slutföras. Efter omstart av datorn kan du försöka ta bort roll, rolltjänst eller funktion igen. |
Olika meddelanden kan variera något, beroende på om användaren angav roller eller funktioner i kommandot. |
Allmänt fel |
1002 |
Fel: Allmänt fel. {0} |
Detta är ett allmänt fel för vilket ingen felsökningsinformation är tillgänglig. Om du får det här felet rekommenderar vi att du verifierar syntaxen för ditt kommando, verifierar att du är inloggad på den lokala datorn som medlem av gruppen Administratörer, och försöker igen. {0} representerar undantaget som Serverhanteraren identifierat. |
XML-resultatfil
Följande är ett exempel på XML-resultatfilen som skapats av Serverhanteraren när parametern -resultPath eller -r parameter lagts till Serverhanteraren-kommandot, och en sökväg och ett namn angivits i parametern.
< 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>
I följande tabell identifieras och beskrivs element i resultatfilen.
Element eller attribut | Beskrivning |
---|---|
ServerManagerCommandLineResult |
Rubrikelement. Behållare för hela filen. |
Åtgärd |
Identifierar om de visade resultaten gäller en installations- eller borttagningsoperation. |
Tid |
Visar datum och tidpunkt för när operationen slutfördes. |
Språk |
Visar språkkoden (i exemplet är detta Engelska-USA) för de lokaliserade meddelandena i resultaten. |
Lyckade |
Visar värdet "true" om åtgärden lyckades för alla roller, rolltjänster och funktioner angivna i kommandot, och "false" om åtgärden misslyckades för en eller flera roller, rolltjänster eller funktioner. |
RequiresReboot |
Visar värdet "true" om du måste starta om datorn på grund av en lyckad installations- eller borttagningsoperation, och "false" om ingen omstart krävs. |
Xmlns |
Detta attribut gäller Serverhanteraren-kommandoradens XML-schemadefinition. |
Meddelande |
Alla informations-, varnings- och felmeddelanden finns i XML-filens brödtext. Ett allmänt meddelande om hela operationen finns på toppnivån. Om ett meddelande gäller en specifik roll, rolltjänst eller funktion finns meddelandet dock inom det specifika elementet för det objektet. Meddelanden är lokaliserade till det språk som anges av attributet Language.
|
Roll, rolltjänst eller funktion |
Roll-, rolltjänst- eller funktionselement kan finnas flera gånger i resultatfilen, beroende på de objekt för vilka Serverhanteraren-kommandosvarsfilen begär installation eller borttagning.
|