De uitvoer van Serverbeheer-opdrachten interpreteren

Opmerking
Servermanagercmd.exe is afgeschaft en wordt mogelijk niet ondersteund in toekomstige versies van Windows. U wordt aangeraden de cmdlets van Windows PowerShell te gebruiken die beschikbaar zijn voor Serverbeheer.

De Serverbeheer-opdracht, ServerManagerCmd.exe, genereert uitvoer over de bewerkingen en geeft de belangrijkste informatie hierover weer in de uitvoer op het scherm. Door Serverbeheer wordt ook veel uitgebreidere uitvoer vastgelegd in een logboekbestand in tekstindeling. U kunt Serverbeheer ook configureren om het resultaat van opdrachtregelbewerkingen naar een bestand met resultaten in XML-indeling te schrijven.

In deze sectie worden de codes en berichten aangeduid en beschreven die u kunt vinden in de uitvoerbestanden voor Serverbeheer-opdrachten.

Resultaten van opdrachtregelbewerkingen van Serverbeheer

Door Serverbeheer wordt de opdrachtuitvoer standaard naar een logboekbestand in tekstindeling geschreven, logname.txt, dat u kunt vinden op %windir%\logs\ServerManager.log.

	Opmerking
	Hoewel in dit logboek de uitvoer wordt opgeslagen van de bewerkingen naar aanleiding van Serverbeheer-opdrachten, is deze uitvoer zeer uitgebreid en is de indeling niet zeer gebruiksvriendelijk. Dit logboekbestand is handig als u contact moet opnemen met Microsoft Productondersteuning over Serverbeheer-bewerkingen.

U kunt de standaardnaam en -locatie van het logboekbestand wijzigen door de parameter -logPath toe te voegen aan de Serverbeheer-regelopdracht, ServerManagerCmd.exe. Raadpleeg Overzicht van Serverbeheer-opdrachten voor meer informatie over de parameter -logPath en de syntaxis van ServerManagerCmd.exe.

Naast het logboekbestand in tekstindeling dat standaard door Serverbeheer wordt gemaakt, kunt u Serverbeheer via een opdracht instellen om het resultaat van de bewerkingen op te slaan in een XML-bestand met een door u opgegeven naam en locatie. De parameter voor het opgeven van de naam en locatie van een XML-bestand met resultaten is -resultPath.

De parameters -logPath en -resultPath worden gebruikt op de opdrachtprompt, ongeacht of u een antwoordbestand gebruikt in combinatie met de Serverbeheer-opdracht voor het opgeven van een lijst met rollen of onderdelen die moeten worden verwijderd en ongeacht of u een enkel item rechtstreeks via de opdrachtregel installeert of verwijdert. Zie Een antwoordbestand maken voor Serverbeheer-opdrachten voor meer informatie over het antwoordbestand voor de Serverbeheer-opdrachtregel.

Voorbeelden

In de volgende voorbeelden wordt toegelicht hoe u de naam en het pad kunt opgeven voor een bestand met resultaten in XML-indeling via een Serverbeheer-opdracht.

Voorbeeld van het opgeven van een bestand met resultaten in een opdracht in combinatie met een antwoordbestand

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

In het vorige voorbeeld heeft een beheerder een antwoordbestand gemaakt met de naam Remove_roles.xml, met daarin opdrachten voor het verwijderen van verschillende rollen van een server. De beheerder heeft ook een naam en locatie voor het bestand met resultaten opgegeven, C:\CmdLine\010107.xml.

Voorbeeld van het opgeven van een bestand met resultaten in een opdracht zonder een antwoordbestand

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

In het vorige voorbeeld heeft een beheerder Serverbeheer instructie gegeven Netwerkbeleid en toegangsservices te installeren. Bij de opdrachtnaam voor de functie, npas, wordt geen onderscheid gemaakt tussen hoofdletters en kleine letters.

In dit voorbeeld worden alle functieservices van Services voor netwerkbeleid en -toegang geïnstalleerd, zoals aangevraagd met de parameter -allSubFeatures. De beheerder gebruikt de korte vorm van de parameter -resultPath, -r, om de naam en het pad van het bestand met resultaten op te geven. Ten slotte gebruikt de beheerder de parameter -restart om Serverbeheer te instrueren om de computer indien nodig opnieuw op te starten nadat de installatie van Services voor netwerkbeleid en -toegang is uitgevoerd.

Beschrijvingen van uitvoerberichten

In deze sectie vindt u beschrijvingen van de uitvoer en het resultaat dat wordt geretourneerd door Serverbeheer in een bestand met resultaten in XML-indeling.

Uitvoerberichten

In de volgende tabel worden de berichten aangeduid en beschreven die door de Serverbeheer-opdracht naar het consolevenster worden geschreven en naar bestanden met resultaten.

Bericht	Afsluitcode	Tekenreeks	Opmerkingen
Geslaagd, opnieuw opstarten niet vereist	0	Geslaagd: de installatie is geslaagd. Geslaagd: de verwijdering is geslaagd.	De twee verschillende berichten kunnen iets anders zijn, waarbij het ervan af hangt of de gebruiker in de opdracht functies of onderdelen heeft opgegeven.
Geslaagd: u moet de computer opnieuw starten	3010	Geslaagd: de installatie is geslaagd. U moet de computer opnieuw opstarten. Geslaagd: de verwijdering is geslaagd. U moet de computer opnieuw opstarten.	Deze code wordt geretourneerd als de computer opnieuw moet worden opgestart. Nadat u de computer opnieuw hebt opgestart, moet u mogelijk Serverbeheer uitvoeren in de gebruikersinterface van Windows Server 2008 R2 voor het voltooien van de vereiste configuratie van functies of onderdelen.
Het argument is niet geldig	4	ArgumentNotValid: het argument is ongeldig {argument} ArgumentNotValid: het antwoordbestandspad ontbreekt ArgumentNotValid: het logboekbestandspad ontbreekt ArgumentNotValid: Ongeldige functie: '{naam}'. Kan de naam van de functie niet vinden. ArgumentNotValid: rol is niet geldig: '{naam}'. Kan de naam van de rol niet vinden. ArgumentNotValid: De volgende naam is al opgegeven in het invoerpad: {naam} ArgumentNotValid: De volgende instelling is al opgegeven in het invoerpad: {instelling} ArgumentNotValid: Geen geldige functie. '{naam}' is een rol. ArgumentNotValid: Geen geldige functie. '{naam}' is een rolservice. ArgumentNotValid: Geen geldige rol. '{naam}' is een functie. ArgumentNotValid: Ongeldige rol. De naam '{naam}' is voor een rolservice. ArgumentNotValid: Geen geldige rolservice. '{naam}' is een functie. ArgumentNotValid: Geen geldige rolservice. '{naam}' is een rol.	Dit foutbericht wordt weergegeven als een gebruiker een argument opgeeft dat niet bestaat of een vereist gedeelte van een argument weglaat in de Serverbeheer-opdrachtregel. Er kunnen verschillende berichten worden weergegeven op basis van het argument dat de meeste aandacht vereist. {argument} vertegenwoordigt het onjuiste argument dat door gebruiker is opgegeven. {naam} vertegenwoordigt de onjuist opgegeven naam van de rol, de rolservice of het onderdeel. {instelling} vertegenwoordigt de naam van een onjuist opgegeven naar een instelling voor een rol, rolservice of onderdeel, of een of dubbele verwijzing naar het betreffende item.
Fout bij het openen of lezen van het invoerbestand	110	ReadError: Het antwoordbestand bestaat niet: {0} ReadError: Kan het antwoordbestand niet lezen: {0} ReadError: Kan het antwoordbestand niet laden: {0}. {1}	Wordt weergegeven als de opdrachtregelinterface van Serverbeheer het antwoordbestand dat door de gebruikers is opgegeven, niet kan lezen of vinden. Er kunnen verschillende berichten worden weergegeven voor dezelfde foutcode (110) op basis van de opgegeven reden waarom het antwoordbestand niet kan worden geladen. {0} vertegenwoordigt het pad en de naam die door de gebruiker zijn opgegeven. {1} vertegenwoordigt de uitzondering die is vastgesteld door Serverbeheer. De aanbevolen procedure voor probleemoplossing als dit foutbericht wordt weergegeven, is om te controleren of u de juiste naam en het juiste pad hebt opgegeven voor het XML-antwoordbestand, en om te controleren of het antwoordbestand wordt gevalideerd met het schema voor antwoordbestanden van Serverbeheer en gebruikmaakt van de juiste elementstructuur. Zie Een antwoordbestand maken voor Serverbeheer-opdrachten voor meer informatie over de juiste instellingen en het correcte uiterlijk van een antwoordbestand met Serverbeheer-opdrachten.
Onvoldoende machtigingen of referenties	5	Fout: Serverbeheer Kan alleen worden uitgevoerd door een lid van de ingebouwde groep Administrators op de lokale computer. U moet meer rechten hebben als u rollen en functies wilt installeren of verwijderen.	Deze fout treedt op als de opgegeven gebruikersreferenties niet beschikken over bevoegdheden voor de lokale groep Administrators op de server of als een gebruiker het opdrachtpromptvenster niet heeft geopend met verhoogde bevoegdheden. Klik hiervoor met de rechtermuisknop op het uitvoerbare bestand van de opdrachtprompt of klik met de rechtermuisknop op het Opdrachtprompt-object in het menu Start en klik op Als administrator uitvoeren.
Geen wijzigingen vereist	1003	NoChange: er zijn geen wijzigingen aangebracht omdat de rollen en functies die zijn opgegeven in het antwoordbestand, al zijn geïnstalleerd of al zijn verwijderd van de lokale computer.	Deze fout treedt op als de rollen, rolservices of onderdelen die in het antwoordbestand zijn opgegeven om te worden geïnstalleerd op de computer, al zijn geïnstalleerd of als verwijdering hiervan in het antwoordbestand wordt opgegeven en door Serverbeheer is vastgesteld dat deze niet op de computer aanwezig zijn of al zijn verwijderd. Dit bericht treedt derhalve op als de in de opdracht opgegeven acties resulteren in een null-bewerking.
Er is al een sessie van een Serverbeheer-wizard actief op deze computer	1004	Fout: Een andere gebruiker voert een wizard uit in de gebruikersinterface van Serverbeheer.	Als een van de Serverbeheer-wizards (Rollen toevoegen, Onderdelen toevoegen, Rolservices toevoegen, Rollen verwijderen, Onderdelen verwijderen, Rolservices verwijderen) al wordt uitgevoerd, en een gebruiker probeert om de Serverbeheer-opdrachtregel uit te voeren voor het installeren of verwijderen van rollen, rolservices of onderdelen, mislukt deze bewerking. Serverbeheer voorkomt dat conflicterende wijzigingen door gebruikers worden aangebracht in softwarepakketten door het uitvoeren van slechts één hulpprogramma tegelijk toe te staan. Op hetzelfde moment kunnen slechts de opdrachtregelprogramma's óf een Serverbeheer-wizard worden uitgevoerd, maar niet beide tegelijkertijd.
Er is een fout opgetreden bij het verzamelen van de lijst met geïnstalleerde rollen of onderdelen of tijdens het installeren of verwijderen van de door de gebruiker opgegeven items.	1000	Fout: De installatie van een of meer rollen, rolservices of functies is mislukt. Controleer het logboek van Serverbeheer voor extra informatie en probeer het opnieuw. Fout: Het verwijderen van een of meer functies, functieservices of functies is mislukt. Controleer het logboek van Serverbeheer voor extra informatie en probeer het opnieuw.	De twee verschillende berichten kunnen iets anders zijn, waarbij het ervan af hangt of de gebruiker in de opdracht functies of onderdelen heeft opgegeven.
Hetzelfde als fout 1000, behalve dat de computer opnieuw moet worden opgestart na het optreden van deze fout om wijzigingen die op de computer zijn aangebracht, ongedaan te maken.	1001	Error: De installatie van een of meer functies, functieservices of functies is mislukt. U moet de computer opnieuw starten om doorgevoerde wijzigingen ongedaan te maken. Controleer het logboek van Serverbeheer voor extra informatie en probeer het opnieuw. Fout: Het verwijderen van een of meer functies, functieservices of functies is mislukt. U moet de computer opnieuw starten om doorgevoerde wijzigingen ongedaan te maken. Controleer het logboek van Serverbeheer voor extra informatie en probeer het opnieuw. Fout: De installatie van de functie, functieservice of onderdelen is mislukt omdat de computer opnieuw moet worden gestart om een andere installatie of verwijdering te voltooien. Probeer de functie, functieservice of onderdelen opnieuw te installeren nadat u de computer opnieuw hebt gestart. Fout: Het verwijderen van de functie, functieservice of onderdelen is mislukt omdat de computer opnieuw moet worden gestart om een andere installatie of verwijdering te voltooien. Probeer de functie, functieservice of onderdelen opnieuw op te verwijderen nadat u de computer opnieuw hebt gestart.	De verschillende berichten kunnen iets anders zijn, waarbij het ervan af hangt of de gebruiker in de opdracht rollen of onderdelen heeft opgegeven.
Algemene fout	1002	Fout: Algemene fout. {0}	Dit is een algemene fout waarvoor geen informatie voor probleemoplossing beschikbaar is. Als deze fout optreedt, moet u de syntaxis van de opdracht controleren, controleren of u bent aangemeld bij de lokale computer als lid van de groep Administrators, en de opdracht opnieuw uitproberen. {0} vertegenwoordigt de uitzondering die is vastgesteld door Serverbeheer.

XML-bestand met resultaten

Het volgende is een voorbeeld van een XML-bestand met resultaten dat door Serverbeheer wordt gemaakt als de parameter -resultPath of -r wordt toegevoegd aan de Serverbeheer-opdrachtregel en een pad en naam in de parameter worden opgegeven.

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

In de volgende tabel worden de elementen van dit bestand met resultaten aangeduid en beschreven.

Element of kenmerk	Beschrijving
ServerManagerCommandLineResult	Koptekstelement; container voor het gehele bestand.
Action	Hiermee wordt aangeduid of in de resultaten gegevens voor een installatie- of verwijderingsbewerking worden opgenomen.
Time	Duidt de datum en het tijdstip aan waarop de bewerking is voltooid.
Language	Hier wordt de taalcode weergegeven (in het voorbeeld English-United States) voor de gelokaliseerde berichten die in de resultaten worden opgenomen.
Success	Hier wordt de waarde 'true' weergegeven als de actie is geslaagd voor alle functies, functieservices en functies die in de opdracht zijn opgegeven; de waarde is 'false' als de actie is mislukt voor een of meer functies, functieservices of functies.
RequiresReboot	Hier wordt de waarde 'true' weergegeven als de computer opnieuw moet worden opgestart vanwege de voltooide installatie- of verwijderingsbewerking; de waarde is 'false' als de computer niet opnieuw hoeft te worden opgestart.
Xmlns	Dit kenmerk verwijst naar de XML-schemadefinitie van de Serverbeheer-opdrachtregel.
Bericht	Alle informatieberichten, waarschuwingen of berichten die fouten aanduiden, worden opgenomen in de tekst van het XML-bestand. Bovenin vindt u een algemeen bericht over de algehele bewerking. Als een bericht echter van toepassing is op een specifieke functie, functieservice of onderdelen, bevat het specifieke element voor het betreffende item het bericht. De gelokaliseerde berichten worden weergegeven in de taal die met het kenmerk Language wordt opgegeven. Level Beschrijft of het bericht een informatief bericht, een waarschuwing of een fout is. Code Indien van toepassing wordt hier een numerieke fout- of berichtcode weergegeven. Fout- en berichtcodes voor Serverbeheer worden beschreven in dit onderwerp (in de sectie Logboekbestand in tekstindeling).
Rol, rolservice of onderdeel	Rol-, rolservice- of onderdeelelementen kunnen meerdere keren voorkomen in het resultaatbestand, afhankelijk van de objecten waarvoor het antwoordbestand voor de Serverbeheer-opdrachtregel installatie of verwijdering opgeeft. DisplayName De gelokaliseerde naam van de functie, functieservice of onderdelen. Id De opdrachtnaam voor de functie, functieservice of onderdelen. Een lijst met opdrachtnamen voor functies, functieservices of functies is beschikbaar in Overzicht van Serverbeheer-opdrachten. RootParent De naam van het bovenliggende object voor de waarde die is opgegeven in het kenmerk DisplayName. Het bovenliggende object van de rolservice Filtering aanvragen is bijvoorbeeld Webserver. Success Hier wordt de waarde 'true' weergegeven als de actie die in het kenmerk Action is opgegeven, is voltooid voor het object dat in DisplayName is opgegeven; de waarde is 'false' als de actie is mislukt. RequiresReboot Hier wordt de waarde 'true' weergegeven als voor de installatie of het verwijderen van het object dat is opgegeven in het kenmerk DisplayName, het opnieuw opstarten van de computer is vereist; de waarde is 'false' als de computer niet opnieuw hoeft te worden opgestart. Skipped Hier wordt de waarde 'true' weergegeven als de functies, functieservices of functies die in het antwoordbestand zijn opgegeven om te worden geïnstalleerd op de computer al zijn geïnstalleerd, of als het verwijderen hiervan in het antwoordbestand wordt opgegeven en door Serverbeheer is vastgesteld dat deze niet op de computer aanwezig zijn of al zijn verwijderd. Dit kenmerk heeft derhalve alleen de waarde 'true' als de acties die zijn opgegeven in de opdracht, resulteren in een null-bewerking. De waarde 'false' wordt weergegeven als Serverbeheer de in de opdracht opgegeven acties heeft voltooid. RequestedBy Hier wordt de reden weergegeven waarom een functie, functieservice of onderdelen is geïnstalleerd of verwijderd. Er zijn vier mogelijk waarden. Rechtstreekse aanvraag van een gebruiker Vereist vanwege afhankelijkheid van een andere functie, functieservice of onderdelen Een containerobject is geïnstalleerd of verwijderd en dit object wordt standaard geselecteerd Alle onderliggende objecten van een functie, functieservice of onderdelen die of dat tevens een container is, zijn geselecteerd (de gebruiker voegt bijvoorbeeld de parameter -allSubFeatures toe aan de Serverbeheer-opdracht) Message Zie de beschrijving bij Message in de vorige rij. De in de rol, rolservice of het onderdeel geneste elementen zijn alleen bestemd voor het betreffende object.

	Opmerking
	Servermanagercmd.exe is afgeschaft en wordt mogelijk niet ondersteund in toekomstige versies van Windows. U wordt aangeraden de cmdlets van Windows PowerShell te gebruiken die beschikbaar zijn voor Serverbeheer.