解释服务器管理器命令的输出

应用到: Windows Server 2008 R2

note注意
Servermanagercmd.exe 已被弃用,因此不保证在将来版本的 Windows 中支持该功能。建议您使用可用于服务器管理器的 Windows PowerShell cmdlet。

服务器管理器命令,即 ServerManagerCmd.exe 生成有关其操作的输出,并在屏幕上突出显示输出。服务器管理器还将更详细的输出写入到纯文本日志文件中。还可以配置 服务器管理器 以将命令行操作的结果写入到基于 XML 的结果文件中。

本部分识别并描述 服务器管理器 命令输出文件中找到的代码和消息。

服务器管理器命令行操作的结果

默认情况下,服务器管理器将命令输出写入到纯文本日志文件 logname.txt 中,此文件位于 %windir%\logs\ServerManager.log 中。

note注意
虽然此日志存储有关 服务器管理器 命令操作的输出,但此输出非常详细,而且没有使用用户友好格式。如果需要与 Microsoft 产品支持服务部门联系有关 服务器管理器 操作的信息,则此日志文件非常有用。

通过将 -logPath 参数添加到服务器管理器行命令 ServerManagerCmd.exe 中,可以更改日志文件的默认名称和位置。有关 -logPath 参数和 ServerManagerCmd.exe 语法的详细信息,请参阅服务器管理器命令概述

除了 服务器管理器 默认创建的纯文本文件之外,还可以指定 服务器管理器 使用您提供的名称和位置将操作结果存储在 XML 文件中。用于指定 XML 结果文件的名称和位置的参数是 -resultPath

-logPath 和 -resultPath 参数在命令提示符中使用,而不管您是要结合使用答案文件和 服务器管理器 命令来指定要删除的角色或功能列表,还是要直接在命令行中安装或删除单个项目。有关 服务器管理器 命令行答案文件的详细信息,请参阅为服务器管理器命令创建答案文件

示例

下列示例显示如何在 服务器管理器 命令中指定 XML 结果文件的名称和路径。

使用答案文件在命令中指定结果文件的示例

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

在前面的示例中,管理员已经创建了一个名为 Remove_roles.xml 的答案文件,其中包含用于从服务器中删除多个角色的命令。管理员已经指定了结果文件的名称和位置 C:\CmdLine\010107.xml

不使用答案文件在命令中指定结果文件的示例

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

在前面的示例中,管理员已指示 服务器管理器 安装网络策略和访问服务。请注意,角色的命令名称 npas 区分大小写。

在本例中,按照 -allSubFeatures 参数的要求,已经安装了网络策略和访问服务的所有角色服务。管理员使用 -resultPath 参数的缩写形式 -r 指定结果文件的名称和路径。最后,管理员使用 -restart 参数指示服务器管理器重新启动计算机,如有必要,可在网络策略和访问服务角色安装完成后立即重新启动。

输出消息的描述

本节描述 服务器管理器 返回的输出和结果,该结果在基于 XML 的结果文件中。

输出消息

下表标识并描述 服务器管理器 命令写入到控制台窗口和结果文件中的消息。

 

消息 退出代码 文本字符串 注意

成功,无需重新启动

0

成功:安装成功。

成功:删除成功。

两个不同的消息可能略有变化,这取决于用户是否在命令中指定了角色或功能。

成功,需要重新启动

3010

成功:安装成功。需要重新启动。

成功:删除成功。需要重新启动。

需要重新启动时返回此代码。重新启动计算机之后,可能需要在 Windows Server 2008 R2 用户界面中运行服务器管理器以完成角色或功能所需的配置。

参数无效

4

ArgumentNotValid:参数无效 {argument}

ArgumentNotValid:缺少答案文件路径

ArgumentNotValid:缺少日志文件路径

ArgumentNotValid:功能无效:“{name}”。找不到功能的名称。

ArgumentNotValid:角色无效:“{name}”。找不到角色的名称。

ArgumentNotValid:已经在输入路径中指定下列名称:{name}

ArgumentNotValid:已经在输入路径中指定下列设置:{setting}

ArgumentNotValid:功能无效。“{name}”是一个角色。

ArgumentNotValid:功能无效。“{name}”是一个角色服务。

ArgumentNotValid:角色无效。“{name}”是一个功能。

ArgumentNotValid:角色无效。“{name}”是一个角色服务。

ArgumentNotValid:角色服务无效。“{name}”是一个功能。

ArgumentNotValid:角色服务无效。“{name}”是一个角色。

当用户在 服务器管理器 命令行中提供了不存在的参数或省略了指定参数的必需部分时,将出现此消息。

需要注意的参数不同,显示的消息则不同。

{argument} 表示用户指定的错误参数。

{name} 表示为角色、角色服务或功能指定的错误名称。

{setting} 表示所指定的错误引用或重复引用的名称,该引用可指向角色、角色服务或功能的设置。

打开或读取输入文件时出错

110

ReadError:答案文件不存在: {0}

ReadError:读取答案文件失败: {0}

ReadError:加载答案文件失败: {0}. {1}

当 服务器管理器 命令行接口无法读取或定位用户提供的答案文件时,将出现此消息。针对相同的错误代码 (110) 将显示不同的消息,这取决于无法加载答案文件的特定原因。

{0} 表示用户指定的路径和名称。

{1} 表示 服务器管理器 找到的例外情况。

如果出现此错误消息,推荐的解决问题的方法是验证您已为 XML 答案文件提供了正确的名称和路径,并验证答案文件符合 服务器管理器 答案文件架构且使用了正确的元素结构。有关 服务器管理器 命令答案文件的正确设置和格式的详细信息,请参阅为服务器管理器命令创建答案文件

权限不足或凭证不符

5

错误:服务器管理器 只能由本地计算机上的内置管理员组成员运行。只能使用提升的权限安装和删除角色和功能。

当提供的用户凭证没有服务器的管理权限,或当用户没有用提升权限打开命令提示符窗口时,将出现此错误。若要执行此操作,请右键单击命令提示符可执行文件,或者右键单击「开始」菜单上的“命令提示符”,然后单击“以管理员身份运行”

无需更改

1003

NoChange:因为已安装或已从本地计算机上删除了答案文件中指定的角色和功能,所以未进行任何更改。

当答案文件中指定要安装的角色、角色服务或功能已在计算机上安装,或答案文件要求删除它们,但 服务器管理器 发现计算机上不存在这些项目或这些项目已被删除时,将出现此消息。也就是说,当命令结果中指定的操作导致空操作时,将出现此消息。

服务器管理器 向导的实例已在此计算机上运行。

1004

错误:另一个用户正在 服务器管理器 用户界面中运行向导。

如果其中一个 服务器管理器 向导(添加角色、添加功能、添加角色服务、删除角色、删除功能、删除角色服务)已经在运行,则运行 服务器管理器 命令行来安装或删除角色、角色服务或功能的尝试会失败。服务器管理器 通过一次仅运行一个工具,来防止用户对安装在服务器上的软件程序包的更改发生冲突。一次只能运行命令行工具或 服务器管理器 向导之一,但不能同时运行两者。

收集已安装角色或功能的列表失败,或者安装或删除用户指定的项目失败。

1000

错误:安装一个或多个角色、角色服务或功能失败。检查 服务器管理器 日志以了解详细信息并重试。

错误:删除一个或多个 角色、角色服务或功能 失败。检查 服务器管理器 日志以了解详细信息并重试。

两个不同的消息可能略有变化,这取决于用户是否在命令中指定了角色或功能。

除此错误需要重新启动计算机以撤消对计算机进行的任何更改之外,与错误 1000 相同。

1001

错误:安装一个或多个 角色、角色服务或功能 失败,需要重新启动计算机以撤消对计算机进行的任何更改。检查 服务器管理器 日志以了解详细信息并重试。

错误:删除一个或多个 角色、角色服务或功能 失败,需要重新启动计算机以撤消对计算机进行的任何更改。检查 服务器管理器 日志以了解详细信息并重试。

错误:由于必须重新启动计算机以完成另一安装或删除,安装 角色、角色服务或功能 失败。重新启动计算机之后,尝试重新安装 角色、角色服务或功能。

错误:由于必须重新启动计算机以完成另一安装或删除,删除 角色、角色服务或功能 失败。重新启动计算机之后,尝试重新删除 角色、角色服务或功能。

不同的消息可能略有变化,这取决于用户是否在命令中指定了角色或功能。

一般错误

1002

错误:一般错误。 {0}

这是一般错误。对于此类错误,没有可用的疑难解答信息。收到此错误时,建议验证命令的语法,并验证您作为 Administrator 组的成员登录到本地计算机上,然后重试命令。

{0} 表示 服务器管理器 找到的例外情况。

XML 结果文件

下例是将 -resultPath 或 -r 参数添加到 服务器管理器 行命令并在参数中提供路径和名称时,服务器管理器 创建的 XML 结果文件。

< ServerManagerConfigurationResult
Action="Install"
Time="2006-11-29T14:26:39"
Language="en-US"
Success="true"
RequiresReboot="false"
xmlns="http://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>

下表识别并描述在结果文件中找到的元素。

 

元素或属性 描述

ServerManagerCommandLineResult

标题元素;整个文件的容器。

操作

识别显示的是安装操作结果还是删除操作结果。

时间

显示完成操作的日期和时间。

语言

显示结果中包括的本地化消息的语言代码(在本例中为“英语(美国)”)。

成功

如果对于命令中指定的所有 角色、角色服务和功能,此操作均成功,则显示值“true”;如果对于一个或多个 角色、角色服务或功能,此操作失败,则显示值“false”。

RequiresReboot

如果由于安装或删除操作成功而必须重新启动计算机,则显示值“true”;如果不需要重新启动,则显示值“false”。

Xmlns

此属性引用 服务器管理器 命令行 XML 架构定义。

消息

所有信息、警告和错误消息均包括在 XML 文件的正文中。在顶级部分可找到有关整个操作的常规消息。但是,如果消息应用于特定的 角色、角色服务或功能,则此消息包含在该项目的特定元素内。消息会本地化为由“语言”属性指定的语言。

  • Level   描述消息是信息、警告还是错误。

  • Code   如果适用,则显示数字形式的错误或消息代码。服务器管理器错误和消息代码在本主题的纯文本日志文件部分描述。

角色、角色服务或功能

角色、角色服务或功能元素可以在结果文件中出现多次,这取决于 服务器管理器 命令行答案文件请求安装或删除的对象。

  • DisplayName   角色、角色服务或功能的本地化名称。

  • Id   角色、角色服务或功能的命令名称。可以在服务器管理器命令概述中获得 角色、角色服务或功能 的命令名称列表。

  • RootParent   DisplayName 属性所指定的值的父对象名称。例如,“请求筛选”角色服务的父对象是 Web 服务器。

  • 成功   如果“操作”属性中指定的操作在 DisplayName 指定的对象上成功,则显示值“true”;如果操作失败,则显示值“false”。

  • RequiresReboot   如果安装或删除 DisplayName 属性所指定的对象需要重新启动计算机,则显示值“true”;如果不需要重新启动,则显示值“false”。

  • 跳过   如果答案文件中指定要安装的角色、角色服务或功能已在计算机上安装,或答案文件要求删除它们,但服务器管理器发现计算机上不存在这些项目或已经删除这些项目,则显示值“true”。也就是说,仅当命令结果中指定的操作导致空操作时,此属性具有“true”值。如果服务器管理器完成了命令中指定的操作,则显示值“false”。

  • RequestedBy   显示安装或删除角色、角色服务或功能的原因。有四个可能的值。

    • 用户直接请求

    • 其他 角色、角色服务或功能 的依存关系需要

    • 安装或删除了某个容器对象,且此对象被默认选择

    • 选择容器 角色、角色服务或功能 的所有子对象(例如,用户将 -allSubFeatures 参数添加到 服务器管理器 命令中)

  • 消息   请参阅上一行的“消息”描述。嵌套在角色、角色服务或功能元素中的消息仅特定于该对象。

社区附加资源

添加
显示: