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å KommandotolkenStart-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.

  • Level   Beskriver om meddelandet är ett informations-, varnings- eller felmeddelande.

  • Code   Visar en numerisk fel- eller meddelandekod, om detta är aktuellt. Fel- och meddelandekoder för Serverhanteraren beskrivs i det här avsnittet, under Textloggfil.

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.

  • DisplayName   Lokaliserat namn för roll, rolltjänst eller funktion.

  • Id   Kommandonamn för roll, rolltjänst eller funktion. En lista över kommandonamn för roller, rolltjänster eller funktioner finns i Översikt över Serverhanteraren-kommandon.

  • RootParent   Namn på det överordnade objektet för det värde som anges i attributet Visningsnamn. Exempelvis är Webbserver det överordnade objektet för rolltjänsten Förfrågningsfiltrering.

  • Success   Visar värdet "true" om den åtgärd som anges i attributet Åtgärd lyckades för det objekt som anges i Visningsnamn, och "false" om åtgärden misslyckades.

  • RequiresReboot   Visar värdet "true" om installation eller borttagning av det objekt som anges i attributet Visningsnamn kräver omstart av datorn, och "false" om ingen omstart krävs.

  • Skipped   Visar värdet "true" om de roller, rolltjänster eller funktioner 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 får det här attributet bara värdet "true" om de åtgärder som anges i kommandot resulterar i en null-operation. Visar värdet "false" om Serverhanteraren slutförde de åtgärder som anges i kommandot.

  • RequestedBy   Visar skälet till varför en roll, rolltjänst eller funktion installerades eller togs bort. Det finns fyra möjliga värden.

    • Direkt begäran av en användare

    • Begärt av ett beroende av en annan roll, rolltjänst eller funktion

    • Ett behållarobjekt installerades eller togs bort, och detta objekt väljs som standard

    • Alla underordnade objekt för en behållare roll, rolltjänst eller funktion valdes (användaren lade t.ex. till parametern -allSubFeatures till Serverhanteraren-kommandot)

  • Meddelande   Se meddelandebeskrivningen på föregående rad. Meddelanden som kapslats i roll-, rolltjänst- eller funktionselement är specifika för just det objektet.