Interpretar os Resultados dos Comandos do Gestor de Servidor

Nota
O Servermanagercmd.exe foi preterido, não havendo garantia de suporte em futuras versões do Windows. Recomendamos que utilize os cmdlets Windows PowerShell que estão disponíveis para o Gestor de servidor.

O comando do Gestor de servidor, ServerManagerCmd.exe, gera saída acerca das respectivas operações e apresenta linhas gerais da saída no ecrã. O Gestor de servidor também escreve saída muito mais verbosa num ficheiro de registo só de texto. Também pode configurar o Gestor de servidor para escrever os resultados de operações de linha de comandos para um ficheiro de resultados baseado em XML.

Esta secção identifica e descreve os códigos e as mensagens que são encontradas nos ficheiros de saída de comando do Gestor de servidor.

Resultados das operações de linha de comandos do Gestor de Servidor

Por predefinição, o Gestor de servidor escreva a saída de comandos num ficheiro de registo só de leitura, logname.txt, localizado em %windir%\logs\ServerManager.log.

	Nota
	Apesar de este registo armazenar a saída referente às operações do comando do Gestor de servidor, essa saída é bastante verbosa e não tem um formato destinado ao utilizador. Este ficheiro de registo é útil se for necessário contactar o suporte técnico da Microsoft por causa de operações do Gestor de servidor.

Pode alterar o nome e a localização predefinidos do ficheiro de registo adicionando o parâmetro -logPath ao comando do Gestor de servidor, ServerManagerCmd.exe. Para mais informações sobre o parâmetro -logPath e a sintaxe de ServerManagerCmd.exe, consulte Descrição Geral dos Comandos do Gestor de Servidor.

Para além do ficheiro de registo só de texto criado pelo Gestor de servidor por predefinição, pode ordenar ao Gestor de servidor para armazenar os resultados das operações num ficheiro XML, fornecendo um nome e uma localização. O parâmetro para especificar o nome e a localização de um ficheiro de resultados XML é -resultPath.

Os parâmetros -logPath e -resultPath são utilizados na linha de comandos, independentemente de estar a ser utilizado um ficheiro de resposta com o comando Gestor de servidor para especificar uma lista de funções ou funcionalidades, ou de estar a instalar ou a remover um item singular directamente na linha de comandos. Para obter mais informações sobre como o ficheiro de resposta de linha de comandos do Gestor de servidor, consulte Criar um Ficheiro de Resposta para Comandos do Gestor de Servidor.

Exemplos

Os exemplos seguintes mostram como especifica o nome e o caminho para um ficheiro de resultados XML no comando do Gestor de servidor.

Exemplo de especificação de ficheiro de resultados num comando com um ficheiro de resposta

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

No exemplo anterior, um administrador criou um ficheiro de resposta chamado Remove_roles.xml, com comandos para remover várias funções de um servidor. O administrador especificou um nome e uma localização para o ficheiro de resultados, C:\CmdLine\010107.xml.

Exemplo de especificação de ficheiro de resultados num comando sem um ficheiro de resposta

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

No exemplo anterior, um administrador indicou ao Gestor de servidor para instalar os Serviços de Política e Acesso de Rede. Tenha em atenção que o nome de comando para a função, npas, não é sensível às maiúsculas e minúsculas.

Neste exemplo, todos os serviços de função dos Serviços de Política e Acesso de Rede são instalados, como pedido com o parâmetro -allSubFeatures. O administrador utiliza o formato abreviado do parâmetro -resultPath, -r, para especificar um nome e um caminho para o ficheiro de resultados. Por fim, o administrador utiliza o parâmetro -restart para indicar ao Gestor de servidor para reiniciar o computador, se necessário, assim que a instalação da função Serviços de Política e Acesso de Rede estiver concluída.

Descrições de mensagens de saída

Esta secção descreve a saída e os resultados devolvidos pelo Gestor de servidor num ficheiro de resultados baseado em XML.

Mensagens de saída

A tabela seguinte identifica e descreve mensagens que o comando Gestor de servidor escreve na janela da consola e em ficheiros de resultados.

Mensagem	Código de saída	Cadeia de texto	Notas
Êxito, não é necessário reiniciar	0	Êxito: Instalação com êxito. Êxito: Remoção com êxito.	Duas mensagens diferentes podem variar ligeiramente, consoante o utilizador tenha especificado funções ou funcionalidades no comando.
Êxito, é necessário reiniciar	3010	Êxito: Instalação com êxito. É necessário reiniciar. Êxito: Remoção com êxito. É necessário reiniciar.	Este código é devolvido quando é necessário reiniciar. Após reiniciar o computador, poderá ser necessário executar o Gestor de servidor na interface de utilizador do Windows Server 2008 R2 para concluir a configuração necessárias das funções ou funcionalidades.
O argumento não é válido	4	ArgumentNotValid: O argumento não é válido {argumento} ArgumentNotValid: Caminho do ficheiro de resposta em falta ArgumentNotValid: Caminho do ficheiro de registo em falta ArgumentNotValid: A funcionalidade não é válida: '{nome}'. O nome da funcionalidade não foi encontrado. ArgumentNotValid: A função não é válida: '{nome}'. O nome da função não foi encontrado. ArgumentNotValid: O nome que se segue já foi especificado no caminho de entrada: {nome} ArgumentNotValid: A definição que se segue já foi especificada no caminho de entrada: {definição} ArgumentNotValid: Não é uma funcionalidade válida. '{nome}' é uma função. ArgumentNotValid: Não é uma funcionalidade válida. '{nome}' é um serviço de função. ArgumentNotValid: Não é uma função válida. '{nome}' é uma funcionalidade. ArgumentNotValid: Função inválida. O nome '{nome}' é de um serviço de função. ArgumentNotValid: Não é um serviço de função válido. '{nome}' é uma funcionalidade. ArgumentNotValid: Não é um serviço de função válido. '{nome}' é uma função.	Ocorre quando um utilizador fornece um argumento que não existe ou omite uma parte obrigatória de um argumento especificado na linha de comandos do Gestor de servidor. São apresentadas mensagens diferentes consoante o argumento que requer atenção. {argumento} representa o argumento incorrecto especificado pelo utilizador. {nome} representa o nome da função, serviço de função ou funcionalidade especificado incorrectamente. {definição} representa o nome de uma referência especificada incorrectamente ou duplicada a uma definição para uma função, serviço de função ou funcionalidade.
Erro ao abrir ou ler o ficheiro de entrada.	110	ReadError: O ficheiro de resposta não existe: {0} ReadError: Falha ao ler o ficheiro de resposta: {0} ReadError: Falha ao carregar o ficheiro de resposta: {0}. {1}	Ocorre se a interface de linha de comandos do Gestor de servidor não conseguir ler ou localizar o ficheiro de resposta fornecido por um utilizador. São apresentadas mensagens diferentes para o mesmo código de erro (110) consoante a razão específica pela qual o ficheiro de resposta não foi carregado. {0} representa o caminho e o nome especificado pelo utilizador. {1} representa a excepção encontrada pelo Gestor de servidor. A resolução de problemas recomendada, se ocorrer esta mensagem de erro, é verificar se forneceu o nome e o caminho correctos para o ficheiro de resposta XML e verificar se o ficheiro de resposta é válido para o esquema de ficheiro de resposta do Gestor de servidor e se utiliza a estrutura de elementos correcta. Para obter mais informações sobre a configuração e o aspecto correctos de um ficheiro de resposta de linha de comandos do Gestor de servidor, consulte Criar um Ficheiro de Resposta para Comandos do Gestor de Servidor.
Permissões ou credenciais insuficientes	5	Erro: O Gestor de servidor só pode ser executado por um membro do grupo incorporado Administradores no computador local. Apenas deve instalar e remover funções e funcionalidades com permissões elevadas.	Este erro ocorre se as credenciais de utilizador fornecidas não possuem direitos de administração locais no servidor, ou se um utilizador não abriu a janela de linha de comandos com permissões elevadas. Para isso, clique com o botão direito do rato no executável Linha de Comandos ou no objecto Linha de Comandos no menu Iniciar e, em seguida, clique em Executar como administrador.
Não é necessária alteração	1003	NoChange: Não foram efectuadas alterações porque as funções e funcionalidades especificadas no ficheiro de resposta já estão instaladas ou já foram removidas do computador local.	Ocorre se as funções, serviços de função ou funcionalidades especificadas no ficheiro de resposta para serem instaladas, já estão instaladas no computador, ou se o ficheiro de resposta solicita a sua remoção e o Gestor de servidor descobriu que não existiam no computador ou já tinham sido removidas. Por outras palavras, esta mensagem ocorre se as acções especificadas no comando resultam numa operação nula.
Uma instância de um assistente do Gestor de servidor já está em execução neste computador	1004	Erro: Outro utilizador está a executar um assistente na interface de utilizador do Gestor de servidor.	Se um dos assistentes do Gestor de servidor (Adicionar Funções, Adicionar Funcionalidades, Adicionar Serviços de Função, Remover Funções, Remover Funcionalidades, Remover Serviços de Função) já está em execução, as tentativas para executar a linha de comandos do Gestor de servidor para instalar ou remover funções, serviços de função ou funcionalidades falham. O Gestor de servidor impede alterações conflituantes de utilizador aos pacotes de software instalados num servidor, executando uma ferramenta de cada vez. Tanto as ferramentas de linha de comandos como os assistentes do Gestor de servidor podem ser executados em determinada altura, mas nunca ambos em simultâneo.
Ocorreu uma falha durante a recolha da lista de funções ou funcionalidades instaladas, ou durante a instalação ou remoção dos itens especificados pelo utilizador.	1000	Erro: A instalação de uma ou mais funções, serviços de função ou funcionalidades falhou. Verifique o registo do Gestor de servidor para saber mais informações e tente novamente. Erro: A remoção de uma ou mais funções, serviços de função ou funcionalidades falhou. Verifique o registo do Gestor de servidor para saber mais informações e tente novamente.	Duas mensagens diferentes podem variar ligeiramente, consoante o utilizador tenha especificado funções ou funcionalidades no comando.
Idêntico ao erro 1000, com excepção de que para este erro é necessário reiniciar para anular as alterações que tenham sido feitas ao computador.	1001	Erro: A instalação de uma ou mais funções, serviços de função ou funcionalidades falhou e é necessário reiniciar para anular as alterações que tenham sido feitas ao computador. Verifique o registo do Gestor de servidor para saber mais informações e tente novamente. Erro: A remoção de uma ou mais funções, serviços de função ou funcionalidades falhou e é necessário reiniciar para anular as alterações que tenham sido feitas ao computador. Verifique o registo do Gestor de servidor para saber mais informações e tente novamente. Erro: A instalação de função, serviço de função ou funcionalidade falhou porque o computador tem de ser reiniciado para concluir outra instalação ou remoção. Depois de reiniciar o computador, experimente instalar de novo função, serviço de função ou funcionalidade. Erro: A remoção de função, serviço de função ou funcionalidade falhou porque o computador tem de ser reiniciado para concluir outra instalação ou remoção. Depois de reiniciar o computador, experimente remover de novo função, serviço de função ou funcionalidade.	Duas mensagens diferentes podem variar ligeiramente, consoante o utilizador especificou funções ou funcionalidades no comando.
Erro genérico	1002	Erro: Erro genérico. {0}	Trata-se de um erro genérico relativamente ao qual não existe informação de resolução de problemas disponível. Na eventualidade de receber este erro, é aconselhável verificar a sintaxe do comando, verificar se tem sessão iniciada no computador local como membro do grupo Administradores e repetir o comando. {0} representa a excepção encontrada pelo Gestor de servidor.

Ficheiro de resultados XML

É apresentado em seguida um exemplo do ficheiro de resultados XML criado pelo Gestor de servidor quando o parâmetro -resultPath ou -r é adicionado ao comando do Gestor de servidor e são fornecidos um caminho e um nome de ficheiro no parâmetro.

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

A tabela seguinte identifica e descreve elementos encontrados no ficheiro de resultados.

Elemento ou atributo	Descrição
ServerManagerCommandLineResult	Elemento de cabeçalho; contentor para todo o ficheiro.
Action	Identifica se os resultados apresentados são de uma operação de instalação ou de remoção.
Time	Mostra a data e a hora em que a operação foi concluída.
Language	Mostra o código do idioma (no exemplo, é o inglês-E.U.A.) para as mensagens localizadas incluídas nos resultados.
Success	Mostra o valor "true" se a acção foi bem sucedida para todas as funções, serviços de função e funcionalidades especificadas no comando; "false" é a acção que falhou numa ou mais funções, serviços de função ou funcionalidades.
RequiresReboot	Mostra o valor "true" se tiver de reiniciar o computador por causa da operação de instalação ou remoção bem sucedida; "false" se não for necessário reiniciar.
Xmlns	Este atributo referencia a definição do esquema XML da linha de comandos do Gestor de servidor.
Message	Todas as mensagens informativas, de aviso e de erro são incluídas no corpo do ficheiro XML. É encontrada uma mensagem geral sobre toda a operação no nível inicial. No entanto, se uma mensagem se aplicar a uma função, serviço de função ou funcionalidade específica, a mensagem é contida dentro do elemento específico desse item. As mensagens são localizadas no idioma especificado pelo atributo Idioma. Level Descreve se a mensagem é informativa, um aviso ou um erro, Code Se for aplicável, apresenta um erro numérico ou um código de mensagem. Os códigos de erro e de mensagem do Gestor de servidor são descritos neste tópico, na secção Ficheiro de registo só de texto.
Função, Serviço de Função ou Funcionalidade	Os elementos Função, Serviço de Função ou Funcionalidade podem ocorrer múltiplas vezes no ficheiro de resultados, consoante os objectos o ficheiro de resposta de linha de comandos do Gestor de servidor solicitarem instalação ou remoção. DisplayName Nome localizado da função, serviço de função ou funcionalidade. Id O nome da comando da função, serviço de função ou funcionalidade. Está disponível uma lista de nomes de comandos para funções, serviços de função ou funcionalidades em Descrição Geral dos Comandos do Gestor de Servidor. RootParent Nome do objecto principal para o valor especificado no atributo DisplayName. Por exemplo, o objecto principal do serviço de função Filtragem de Pedidos é o Servidor Web. Success Mostra um valor "true" se a acção especificada no atributo Action tiver tido êxito no objecto especificado em DisplayName, e um valor "false" se a acção tiver falhado. RequiresReboot Mostra um valor "true", se a instalação ou remoção do objecto especificado no atributo DisplayName exigir que o computador seja reiniciado, e "false" se não for necessário reiniciar. Skipped Mostra um valor "true" se as funções, serviços de função ou funcionalidades especificados no ficheiro de resposta para serem instalados já estiverem instalados no computador, ou se o ficheiro de resposta exigir a sua remoção e o Gestor de servidor tiver verificado que não existem no computador ou já foram removidos. Por outras palavras, este atributo tem um valor de "true", se as acções especificadas no comando resultam numa operação nula. Mostra um valor "false", se o Gestor de servidor tiver concluído as acções especificadas no comando RequestedBy Mostra a razão de instalação ou remoção de uma função, serviço de função ou funcionalidade. Existem quatro valores possíveis. Pedido directo de um utilizador Requerido pela dependência de outra função, serviço de função ou funcionalidade Um objecto contentor foi instalado ou removido e este objecto foi seleccionado por predefinição Todos os objectos subordinados de um função, serviço de função ou funcionalidade contentor foram seleccionados (por exemplo, o utilizador adicionou o parâmetro -allSubFeatures ao comando do Gestor de servidor) Message Consulte a descrição de Message na linha anterior. As mensagens aninhadas dentro de elementos Função, Serviço de Função ou Funcionalidade são específicas apenas desse objecto.

	Nota
	O Servermanagercmd.exe foi preterido, não havendo garantia de suporte em futuras versões do Windows. Recomendamos que utilize os cmdlets Windows PowerShell que estão disponíveis para o Gestor de servidor.