O comando de linha do Gerenciador do Servidor no Windows Server® 2008 gera saída sobre suas operações e exibe destaques da saída na tela. O Gerenciador do Servidor também grava uma saída muito mais detalhada em um arquivo de log somente de texto. O Gerenciador do Servidor também pode ser configurado para gravar os resultados de operações de linha de comando em um arquivo de resultados baseado em XML.
Esta seção identifica e descreve os códigos e as mensagens encontrados nos arquivos de saída do comando Gerenciador do Servidor.
Resultados das operações de linha de comando do Gerenciador de Servidores
Por padrão, o Gerenciador do Servidor grava saída de comando em um arquivo de log somente de texto, nome_do_log.txt, localizado em %windir%\temp\servermanager.log.
Observação | |
Embora esse log armazene saída sobre as operações do comando Gerenciador do Servidor, a saída é muito detalhada e é exibida em um formato não amigável. Esse arquivo de log é útil se for necessário entrar em contato com o Atendimento Microsoft sobre operações do Gerenciador do Servidor. |
Você pode alterar o nome e o local padrão do arquivo de log adicionando o parâmetro -logPath ao comando de linha do Gerenciador do Servidor, ServerManagerCmd.exe. Para obter mais informações sobre o parâmetro -logPath e a sintaxe de ServerManagerCmd.exe, consulte Visão geral dos comandos do Gerenciador de Servidores.
Além do arquivo de log somente de texto que o Gerenciador do Servidor cria por padrão, é possível comandar que o Gerenciador do Servidor armazene os resultados de suas operações em um arquivo XML com um nome e local que você fornecer. O parâmetro para especificar o nome e o local de um arquivo de resultados XML é -resultPath.
Os parâmetros -logPath e -resultPath são usados no prompt de comando, independentemente de você estar usando um arquivo de resposta com o comando Gerenciador do Servidor para especificar uma lista de funções ou recursos para remoção ou de estar instalando ou removendo um único item diretamente na linha de comando. Para obter mais informações sobre o arquivo de resposta da linha de comando do Gerenciador do Servidor, consulte Criando um arquivo de resposta para comandos do Gerenciador de Servidores.
Exemplos
Os seguintes exemplos mostram como especificar o nome e o caminho para um arquivo de resultados XML no comando Gerenciador do Servidor.
Exemplo de especificação de arquivo de resultados em um comando com um arquivo de resposta
ServerManagerCmd.exe -inputPath C:\CmdLine\Remove_roles.xml -resultPath C:\CmdLine\010107.xml
No exemplo anterior, um administrador criou um arquivo de resposta chamado Remove_roles.xml
, contendo comandos para remover várias funções de um servidor. O administrador especificou um nome de arquivo de resultados e um local, C:\CmdLine\010107.xml
.
Exemplo de especificação de arquivo de resultados em um comando sem um arquivo de resposta
ServerManagerCmd.exe -install npas -allSubFeatures -r C:\CmdLine\Results\010107.xml -restart
No exemplo anterior, o administrador instruiu ao Gerenciador do Servidor que instalasse o Network Policy e os Access Services. Observe que o nome de comando para a função, npas, não coincide maiúsculas e minúsculas.
Neste exemplo, todos os serviços de função de Diretivas de Rede e Serviços de Acesso são instalados, conforme solicitado com a opção do parâmetro -allSubFeatures. O administrador usa a forma abreviada do parâmetro -resultPath, -r, para especificar um nome e caminho para o arquivo de resultados. Finalmente, o administrador usa o parâmetro -restart para instruir o Gerenciador do Servidor a reiniciar o computador, se necessário, quando a instalação da função de Diretiva de Rede e Serviços de Acesso estiver concluída.
Descrições de mensagens de saída
Esta seção descreve a saída e os resultados retornados pelo Gerenciador do Servidor em um arquivo de resultados baseado em XML.
Mensagens de saída
A tabela a seguir identifica e descreve mensagens que o comando Gerenciador do Servidor grava na janela do console e nos arquivos de resultados.
Mensagem | Código de saída | Cadeia de texto | Observações |
---|---|---|---|
Êxito, a reinicialização não é necessária |
0 |
Êxito: instalação bem-sucedida. Êxito: remoção bem sucedida. |
Duas mensagens diferentes podem variar um pouco, dependendo se o usuário tiver especificado funções ou recursos no comando. |
Êxito, é necessária uma reinicialização |
3010 |
Êxito: instalação bem-sucedida. Uma reinicialização é necessária. Êxito: remoção bem sucedida. Uma reinicialização é necessária. |
Este código é retornado quando uma reinicialização é necessária. Após reiniciar o computador, talvez seja necessário executar o Gerenciador do Servidor na interface do usuário do Windows Server 2008 para concluir a configuração necessária para funções ou recursos. |
Argumento inválido |
4 |
ArgumentNotValid: argumento inválido {argumento} ArgumentNotValid: caminho do arquivo de resposta ausente ArgumentNotValid: caminho do arquivo de log ausente ArgumentNotValid: recurso inválido: '{nome}'. O nome do recurso não foi localizado. ArgumentNotValid: função inválida: '{nome}'. O nome da função não foi localizado. ArgumentNotValid: o seguinte nome já foi especificado no caminho de entrada: {nome} ArgumentNotValid: a seguinte configuração já foi especificada no caminho de entrada: {configuração} ArgumentNotValid: recurso inválido. '{nome}' é uma função. ArgumentNotValid: recurso inválido. '{nome}' é um serviço de função. ArgumentNotValid: função inválida. '{nome}' é um recurso. ArgumentNotValid: função inválida. O nome '{nome}' é de um serviço de função. ArgumentNotValid: serviço de função inválido. '{nome}' é um recurso. ArgumentNotValid: serviço de função inválido. '{nome}' é uma função. |
Ocorre quando um usuário fornece um argumento que não existe ou omite uma parte necessária de um argumento específico na linha de comando do Gerenciador do Servidor. Mensagens diferentes são exibidas dependendo do argumento que requer atenção. {argumento} representa o argumento incorreto especificado pelo usuário. {nome} representa o nome de função, serviço de função ou recurso especificado incorretamente. {configuração} representa o nome de uma referência a uma configuração de função, serviço de função ou recurso especificada incorretamente ou duplicada. |
Erro ao abrir ou ler o arquivo de entrada |
110 |
ReadError: o arquivo de resposta não existe: {0} ReadError: falha ao ler o arquivo de resposta: {0} ReadError: falha ao carregar o arquivo de resposta: {0}. {1} |
Ocorre se a interface da linha de comando do Gerenciador do Servidor não puder ler ou localizar o arquivo de resposta fornecido por um usuário. Diferentes mensagens são exibidas para o mesmo código de erro (110) dependendo da razão específica para o arquivo de resposta não ter sido carregado. {0} representa o caminho e o nome especificados pelo usuário. {1} representa a exceção encontrada pelo Gerenciador do Servidor. A solução recomendada, se esta mensagem de erro ocorrer, é verificar se você forneceu o nome e o caminho corretos para o arquivo de resposta XML e verificar se o arquivo de resposta valida no esquema do arquivo de resposta do Gerenciador do Servidor e usa e estrutura de elemento correta. Para obter mais informações sobre a configuração correta e a aparência de um arquivo de resposta do comando Gerenciador do Servidor, consulte Criando um arquivo de resposta para comandos do Gerenciador de Servidores. |
Credenciais ou permissões insuficientes |
5 |
Erro: o Gerenciador do Servidor pode ser executado somente por um membro do grupo Administradores interno no computador local. Você deve instalar e remover as funções e os recursos somente com permissões elevadas |
Este erro ocorre se as credenciais de usuário fornecidas não tiverem direitos administrativos locais no servidor ou se um usuário não tiver aberto a janela do prompt de comando com permissões elevadas. Para fazer isso, clique com o botão direito do mouse no executável Prompt de Comando, ou no Prompt de Comando no menu Iniciar e clique em Executar como administrador. |
Não é necessária uma alteração |
1003 |
NoChange: nenhuma alteração foi feita porque as funções e os recursos especificados no arquivo de resposta já estão instalados ou já foram removidos do computador local |
Ocorre se as funções, os serviços de função ou recursos especificados no arquivo de resposta para ser instalados já estiverem instalados no computador ou se o arquivo de resposta solicitar sua remoção e o Gerenciador do Servidor tiver descoberto que eles não existem no computador ou já foram removidos. Em outras palavras, esta mensagem ocorre se as ações especificadas no comando resultarem em uma operação nula. |
Uma instância de um assistente do Gerenciador do Servidor já está sendo executada neste computador |
1004 |
Erro: outro usuário está executando um assistente na interface do usuário do Gerenciador do Servidor. |
Se um dos assistentes do Gerenciador do Servidor (Adicionar Funções, Adicionar Recursos, Adicionar Serviços de Função, Remover Funções, Remover Recursos, Remover Serviços de Função) já estiver sendo executado, as tentativas de executar a linha de comando do Gerenciador do Servidor para instalar ou remover funções, serviços de função ou recursos falharão. O Gerenciador do Servidor impede alterações de usuário conflitantes nos pacotes de software instalados em um servidor executando somente uma ferramenta por vez. Ou as ferramentas de linha de comando ou um assistente do Gerenciador do Servidor podem ser executados por vez, mas não ambos simultaneamente. |
Uma falha ocorreu ao coletar a lista de funções ou recursos instalados, ou ao instalar ou remover os itens especificados pelo usuário. |
1000 |
Erro: falha na instalação de uma ou mais funções, serviços de função ou recursos. Verifique o log do Gerenciador do Servidor para obter informações adicionais e tente novamente. Erro: falha na remoção de uma ou mais funções, serviços de função ou recursos. Verifique o log do Gerenciador do Servidor para obter informações adicionais e tente novamente. |
Duas mensagens diferentes podem variar um pouco, dependendo se o usuário tiver especificado funções ou recursos no comando. |
Mesmo erro que o 1000, sendo que uma reinicialização é necessária neste erro para desfazer as alterações feitas no computador. |
1001 |
Erro: falha na instalação de uma ou mais funções, serviços de função ou recursos e é necessária uma reinicialização para desfazer todas as alterações feitas no computador. Verifique o log do Gerenciador do Servidor para obter informações adicionais e tente novamente. Erro: falha na remoção de uma ou mais funções, serviços de função ou recursos e é necessária uma reinicialização para desfazer todas as alterações feitas no computador. Verifique o log do Gerenciador do Servidor para obter informações adicionais e tente novamente. Erro: falha na instalação de função, serviço de função ou recurso porque o computador deve ser reinicializado para concluir outra instalação ou remoção. Após reinicializar o computador, tente instalar função, serviço de função ou recurso novamente. Erro: falha na remoção de função, serviço de função ou recurso porque o computador deve ser reinicializado para concluir outra instalação ou remoção. Após reinicializar o computador, tente remover função, serviço de função ou recurso novamente. |
As mensagens diferentes podem variar um pouco, dependendo se o usuário tiver especificado funções ou recursos no comando. |
Erro genérico |
1002 |
Erro: erro genérico. {0} |
Este é um erro genérico para o qual não há informações de solução disponíveis. Caso você receba este erro, é recomendável que verifique a sintaxe do comando, verifique se efetuou logon no computador local como um membro do grupo Administradores e tente o comando novamente. {0} representa a exceção encontrada pelo Gerenciador do Servidor. |
Arquivo de resultados XML
Veja a seguir um exemplo do arquivo de resultados XML criado pelo Gerenciador do Servidor quando o parâmetro -resultPath ou -r é adicionado ao comando de linha do Gerenciador do Servidor e um caminho e nome são fornecidos 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: [Servidor DHCP] </Message> </Role> <Message Level="Information">Install succeeded.</Message> </ServerManagerConfigurationResult>
A tabela a seguir identifica e descreve os elementos encontrados no arquivo de resultados.
Elemento ou atributo | Descrição | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ServerManagerCommandLineResult |
Elemento de cabeçalho; contêiner para todo o arquivo. |
||||||||||||||||||
Action |
Identifica se os resultados mostrados são para uma operação de instalação ou remoção. |
||||||||||||||||||
Time |
Exibe a data e a hora de conclusão da operação. |
||||||||||||||||||
Language |
Exibe o código do idioma (no exemplo, inglês dos Estados Unidos) para as mensagens localizadas incluídas nos resultados. |
||||||||||||||||||
Bem-sucedida |
Exibe o valor "true" se a ação tiver sido bem-sucedida para todas as funções, serviços de função e recursos especificados no comando; "false" se a ação tiver falhado em uma ou mais funções, serviços de função ou recursos. |
||||||||||||||||||
RequiresReboot |
Exibe o valor "true" se for necessário reinicializar o computador devido à operação de instalação ou remoção bem-sucedida; "false" se não for necessária reinicialização. |
||||||||||||||||||
Xmlns |
Este atributo faz referência à definição do esquema XML da linha de comando do Gerenciador do Servidor. |
||||||||||||||||||
Mensagem |
Todas as mensagens informativas, de aviso e erro são incluídas no corpo do arquivo XML. Uma mensagem geral sobre a operação completa é encontrada no nível superior. Entretanto se uma mensagem se aplicar a função, serviço de função ou recurso específico, a mensagem estará no elemento específico desse item. As mensagens são localizadas no idioma especificado pelo atributo Language.
|
||||||||||||||||||
Função, serviço de função ou recurso |
Os elementos função, serviço de função ou recurso podem ocorrer várias vezes no arquivo de resultados, dependendo dos objetos para os quais o arquivo de resposta da linha de comando do Gerenciador do Servidor solicite instalação ou remoção.
|