解譯伺服器管理員的輸出

附註
Servermanagercmd.exe 已經過時，並且不保證未來的 Windows 版本會支援。建議您使用伺服器管理員的 Windows PowerShell Cmdlet。

伺服器管理員命令 (ServerManagerCmd.exe) 會產生關於其操作的輸出，並在螢幕上反白顯示該輸出。伺服器管理員也會將更詳細的輸出寫入純文字記錄檔中。您也可以設定伺服器管理員，將命令列作業的結果寫入 XML 型結果檔中。

本節識別並描述位於伺服器管理員命令輸出檔中的代碼及訊息。

伺服器管理員命令列作業的結果

根據預設值，伺服器管理員會將命令輸出寫入純文字記錄檔 logname.txt 中，該檔案位於 %windir%\logs\ServerManager.log。

	附註
	雖然這個記錄檔儲存關於伺服器管理員命令作業的輸出，但是輸出非常的詳細，而且不是以使用者容易理解的格式來表示。如果需要就伺服器管理員作業連絡 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	錯誤：只有本機電腦的內建 Administrators 群組成員才可以執行伺服器管理員。您需要擁有較高的權限，才可以安裝及移除角色和功能。	如果提供的使用者認證在伺服器上沒有本機系統管理權限，或如果使用者未以提升的權限開啟命令提示字元視窗，則會發生此錯誤。若要這麼做，請在命令提示字元可執行檔上或在 [開始] 功能表的 [命令提示字元] 上按一下滑鼠右鍵，然後按一下 [以系統管理員身分執行]。
不需變更	1003	NoChange：因為已安裝回應檔案中指定的角色及功能，或已自本機電腦中移除那些角色或功能，所以未進行變更。	如果要安裝的回應檔案中指定的角色、角色服務或功能已安裝在電腦上，或如果回應檔案要求移除它們，但伺服器管理員發現它們不存在於電腦上或已遭移除，便會發生這種情況。換句話說，如果命令中指定的動作造成 Null 作業，便會產生此訊息。
伺服器管理員精靈的執行個體已在這部電腦上執行。	1004	錯誤：另一個使用者正在伺服器管理員使用者介面中執行精靈。	如果其中一個伺服器管理員精靈 ([新增角色]、[新增功能]、[新增角色服務]、[移除角色]、[移除功能]、[移除角色服務]) 已執行中，則執行伺服器管理員命令列以安裝或移除角色、角色服務或功能的作業將失敗。伺服器管理員一次只會執行一個工具，以防使用者對伺服器上安裝的軟體套件做出衝突的變更。命令列工具或伺服器管理員精靈必須分開執行，不能同時執行。
收集已安裝之角色或功能的清單時，或安裝或移除使用者指定的項目時，發生失敗。	1000	錯誤：安裝一或多個角色、角色服務或功能失敗。請檢查伺服器管理員記錄檔，以取得相關資訊並再試一次。錯誤：移除一或多個角色、角色服務或功能失敗。請檢查伺服器管理員記錄檔，以取得相關資訊並再試一次。	兩個不同的訊息可能稍微不同，視使用者在命令中指定的角色或功能而定。
與錯誤 1000 相同，但這個錯誤需要重新啟動，才能將電腦上的任何變更復原。	1001	錯誤：安裝一或多個角色、角色服務或功能失敗，需要重新啟動，才能將電腦上的任何變更復原。請檢查伺服器管理員記錄檔，以取得相關資訊並再試一次。錯誤：移除一或多個角色、角色服務或功能失敗，需要重新啟動，才能將電腦上的任何變更復原。請檢查伺服器管理員記錄檔，以取得相關資訊並再試一次。錯誤：安裝角色、角色服務或功能失敗，因為必須重新啟動電腦，才能完成另一個安裝或移除作業。在重新啟動電腦之後，請嘗試重新安裝角色、角色服務或功能。錯誤：移除角色、角色服務或功能失敗，因為必須重新啟動電腦，才能完成另一個安裝或移除作業。在重新啟動電腦之後，請嘗試重新移除角色、角色服務或功能。	不同的訊息可能稍微不同，視使用者在命令中指定的角色或功能而定。
一般錯誤	1002	錯誤：一般錯誤。 {0}	這是當沒有疑難排解資訊可用時出現的一般錯誤。如果您收到這個錯誤，建議您確認命令語法、確認您是以 Administrators 群組成員的身分登入本機電腦，然後重試命令。 {0} 代表伺服器管理員找到的例外狀況。

XML 結果檔案

下列是伺服器管理員在將 -resultPath 或 -r 參數新增到伺服器管理員列命令後建立的 XML 結果檔案範例，參數中會提供路徑及名稱。

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

下表識別並描述在結果檔案中找到的元素。

元素或屬性	描述
ServerManagerCommandLineResult	標題元素；整個檔案的容器。
Action	識別顯示的是安裝作業結果還是移除作業結果。
Time	顯示作業的完成日期和時間。
Language	顯示結果中包含之當地語言訊息的語言碼 (在範例中，這是美式英文)。
Success	如果命令中指定的所有角色、角色服務與功能已順利完成動作，則會顯示 "true" 值；如果一或多個角色、角色服務或功能無法完成動作，則顯示 "false" 值。
RequiresReboot	如果順利完成安裝或移除作業後必須重新啟動電腦，則會顯示 "true" 值；如果不需要重新啟動，則顯示 "false" 值。
Xmlns	這個屬性會參照伺服器管理員命令列 XML 結構描述定義。
Message	所有參考、警告及錯誤訊息都會併入在 XML 檔案的本文中。您可以在最上層找到關於整個作業的一般訊息。不過，如果訊息適用於特定角色、角色服務或功能，則訊息會含在該項目的特定元素內。訊息會翻成 Language 屬性中指定的語言。 Level 描述訊息是參考訊息、警告訊息還是錯誤訊息。 Code 如果適用的話，會顯示錯誤碼或訊息代碼數字。伺服器管理員錯誤碼及訊息代碼會在本主題的純文字記錄檔一節中加以描述。
角色、角色服務或功能	角色、角色服務或功能元素可以在結果檔案中出現多次，視伺服器管理員命令列回應檔案要求安裝或移除的物件而定。 DisplayName 角色、角色服務或功能的當地語言名稱。 Id 角色、角色服務或功能的命令名稱。角色、角色服務或功能的命令名稱清單可在伺服器管理員命令的概觀中取得。 RootParent DisplayName 屬性中指定之值的父物件名稱。例如，[要求篩選] 角色服務的父物件為 [Web Server]。 Success 如果已在 DisplayName 中指定的物件上順利完成 Action 屬性中指定的動作，則會顯示 "true" 值，如果動作失敗，則顯示 "false" 值。 RequiresReboot 如果安裝或移除 DisplayName 屬性中指定的物件後需要重新啟動電腦，則會顯示 "true" 值，如果不需要重新啟動，則顯示 "false" 值。 Skipped 如果要安裝的回應檔案中指定的角色、角色服務或功能已安裝在電腦上，或如果回應檔案要求移除它們，但伺服器管理員發現它們不存在於電腦上或已被移除，便會顯示 "true" 值。換句話說，只有在命令中指定的動作造成 Null 作業時，這個屬性才會有 "true" 值。如果伺服器管理員已完成命令中指定的動作，則會顯示 "false" 值。 RequestedBy 顯示安裝或移除角色、角色服務或功能的原因。有四個可能的值。直接要求使用者另一個角色、角色服務或功能的依存性需要此值已安裝或移除容器物件，但是預設會選取這個物件已選取容器角色、角色服務或功能的所有子物件 (例如，使用者已將 -allSubFeatures 參數新增到伺服器管理員命令) Message 請參閱上列中的訊息描述。包在角色、角色服務或功能元素內的訊息是該物件特有的訊息。

	附註
	Servermanagercmd.exe 已經過時，並且不保證未來的 Windows 版本會支援。建議您使用伺服器管理員的 Windows PowerShell Cmdlet。