Share via

servermanagercmd

  • Artigo

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 e Windows Server 2012

Instala e remove funções, serviços de função e recursos. Também exibe a lista de todas as funções, os serviços de função e os recursos disponíveis e mostra quais estão instalados neste computador.

Importante

O comando servermanagercmd foi preterido e não há garantia de que tenha suporte em versões futuras do Windows. Recomendamos que você use os cmdlets do Windows PowerShell disponíveis para o Gerenciador do Servidor. Para mais informações, consulte Instalar ou desinstalar funções, Serviços de função ou Recursos.

Sintaxe

servermanagercmd -query [[[<drive>:]<path>]<query.xml>] [-logpath [[<drive>:]<path>]<log.txt>]
servermanagercmd -inputpath  [[[<drive>:]<path>]<answer.xml>] [-resultpath <result.xml> [-restart] | -whatif] [-logpath [[<drive>:]<path>]<log.txt>]
servermanagercmd -install <id> [-allSubFeatures] [-resultpath [[<drive>:]<path>]<result.xml> [-restart] | -whatif] [-logpath [[<Drive>:]<path>]<log.txt>]
servermanagercmd -remove <id> [-resultpath <result.xml> [-restart] | -whatif] [-logpath  [[<drive>:]<path>]<log.txt>]
servermanagercmd [-help | -?]
servermanagercmd -version

Parâmetros

Parâmetro Descrição
-query [[[<drive>:]<path>]<query.xml>] Exibe uma lista de todas as funções, os serviços de função e os recursos instalados e disponíveis para instalação no servidor. Você também pode usar a forma abreviada desse parâmetro, -q. Para que os resultados da consulta sejam salvos em um arquivo XML, especifique um arquivo XML para substituir <query.xml>.
-inputpath [[[<drive>:]<path>]<answer.xml>] Instala ou remove as funções, os serviços de função e os recursos especificados em um arquivo de resposta XML representado por <answer.xml>. Você também pode usar a forma abreviada desse parâmetro, -p.
-install <id> Instala a função, o serviço de função ou o recurso especificado por <id>. Os identificadores diferenciam maiúsculas de minúsculas. Várias funções, serviços de função e recursos precisam ser separados por espaços. Os seguintes parâmetros opcionais são usados com o parâmetro -install:
  • -setting<SettingName>=<SettingValue> – especifica as configurações obrigatórias para a instalação.
  • -allSubFeatures – especifica a instalação de todos os serviços e recursos subordinados, juntamente com a função pai, o serviço de função ou o recurso nomeado no valor <id>.

    OBSERVAÇÃO
    Alguns contêineres de função não têm um identificador de linha de comando para permitir a instalação de todos os serviços de função. Esse é o caso quando serviços de função não podem ser instalados na mesma instância do comando do Gerenciador do Servidor. Por exemplo, o serviço de função Serviço de Federação do Active Directory Federation Services e o serviço de função Proxy do Serviço de Federação não podem ser instalados usando a mesma instância de comando do Gerenciador do Servidor.

  • -resultpath<result.xml> – salva os resultados da instalação em um arquivo XML representado por <result.xml>. Você também pode usar a forma abreviada desse parâmetro, -r.

    OBSERVAÇÃO
    Você não pode executar servermanagercmd com os parâmetros -resultpath e -whatif especificados.

  • -restart – reinicia o computador automaticamente quando a instalação é concluída (se a reinicialização for necessária para as funções ou os recursos instalados).
  • -whatif – exibe as operações especificadas para o parâmetro -install. Você também pode usar a forma abreviada do parâmetro -whatif, -w. Você não pode executar servermanagercmd com os parâmetros -resultpath e -whatif especificados.
  • -logpath<[[<drive>:]<path>]<log.txt>> – especifica um nome e um local para o arquivo de log diferentes do padrão, %windir%\temp\servermanager.log.
-remove <id> Remove a função, o serviço de função ou o recurso especificado por <id>. Os identificadores diferenciam maiúsculas de minúsculas. Várias funções, serviços de função e recursos precisam ser separados por espaços. Os seguintes parâmetros opcionais são usados com o parâmetro -remove:
  • -resultpath<[[<drive>:]<path>]result.xml> – salva os resultados da remoção em um arquivo XML representado por <result.xml>. Você também pode usar a forma abreviada desse parâmetro, -r.

    OBSERVAÇÃO
    Você não pode executar servermanagercmd com os parâmetros -resultpath e -whatif especificados.

  • -restart – reinicia o computador automaticamente quando a remoção é concluída (se a reinicialização for necessária para as funções ou os recursos restantes).
  • -whatif – exibe as operações especificadas para o parâmetro -remove. Você também pode usar a forma abreviada do parâmetro -whatif, -w. Você não pode executar servermanagercmd com os parâmetros -resultpath e -whatif especificados.
  • -logpath<[[<Drive>:]<path>]<log.txt>> – especifica um nome e um local para o arquivo de log diferentes do padrão, %windir%\temp\servermanager.log.
-version Exibe o número da versão do Gerenciador do Servidor. Também é possível usar a forma abreviada, -v.
-help Exibe a ajuda na janela do prompt de Comando. Também é possível usar a forma abreviada, -?.

Exemplos

Para exibir uma lista de todas as funções, serviços de função e recursos disponíveis e quais funções, serviços de função e recursos estão instalados no computador, digite:

servermanagercmd -query

Para instalar a função de Servidor Web (IIS) e salvar os resultados da instalação em um arquivo XML representado por installResult.xml, digite:

servermanagercmd -install Web-Server -resultpath installResult.xml

Para exibir informações detalhadas sobre as funções, os serviços de função e os recursos que seriam instalados ou removidos com base nas instruções especificadas em um arquivo de resposta XML representado por install.xml, digite:

servermanagercmd -inputpath install.xml -whatif