servermanagercmd

  • Artículo

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 y Windows Server 2012.

Instala y quita roles, servicios de rol y características. También muestra la lista de todos los roles, servicios de rol y características disponibles, y muestra los que están instalados en este equipo.

Importante

Este comando, servermanagercmd, está en desuso y no se puede garantizar la compatibilidad con próximas versiones de Windows. En su lugar, se recomienda usar los cmdlets de Windows PowerShell que están disponibles para Administrador del servidor. Para obtener más información, consulta el tema sobre la instalación o desinstalación de roles, servicios de rol o características.

Sintaxis

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 Descripción
-query [[[<drive>:]<path>]<query.xml>] Muestra una lista de todos los roles, servicios de rol o las características instalados y disponibles para su instalación en el servidor. También puede usar la forma abreviada de este parámetro, -q. Si desea guardar los resultados de la consulta en un archivo XML, especifique un archivo XML para reemplazar <query.xml>.
-inputpath [[[<drive>:]<path>]<answer.xml>] Instala o quita los roles, los servicios de rol o las características especificados en un archivo de respuesta XML representado por <answer.xml>. También puede usar la forma abreviada del parámetro, -p.
-install <id> Instala el rol, el servicio de rol o la característica especificados por <id>. Los identificadores no distinguen mayúsculas de minúsculas. Varios roles, servicios de rol y características se deben separar mediante espacios. Se usan los siguientes parámetros opcionales con el parámetro -install:
  • -setting<SettingName>=<SettingValue>: especifica la configuración necesaria para la instalación.
  • -allSubFeatures: especifica la instalación de todos los servicios y características subordinados junto con el rol, servicio de rol o característica primarios mencionados en el valor <id>.

    NOTA:
    Algunos contenedores de funciones no tienen con un identificador de línea de comandos para permitir la instalación de todos los servicios de rol. Esto sucede, por ejemplo, cuando no pueden instalarse servicios de función en la misma instancia del comando del Administrador del servidor. Por ejemplo, el servicio de rol Servicio de federación de los Servicios de federación de Active Directory y el servicio de rol Proxy de Servicio de federación no pueden instalarse mediante la misma instancia de comando de Administrador del servidor.

  • -resultpath<result.xml>: guarda los resultados de la instalación en el archivo XML representado por <result.xml>. También puede usar la forma abreviada del parámetro, -r.

    NOTA:
    No se puede ejecutar servermanagercmd con los parámetros -resultpath y -whatif especificados.

  • -restart: reinicia el equipo automáticamente cuando se completa la instalación (si los roles o características instalados lo requieren).
  • -whatif: muestra todas las operaciones especificadas para el comando -install. También puede usar la forma abreviada del parámetro, -whatif, -w. No se puede ejecutar servermanagercmd con los parámetros -resultpath y -whatif especificados.
  • -logpath<[[<drive>:]<path>]<log.txt>>: especifica un nombre y una ubicación para el archivo de registro, que no sea el predeterminado, %windir%\temp\servermanager.log.
-remove <id> Quita el rol, el servicio de rol o la característica que <id> especifica. Los identificadores no distinguen mayúsculas de minúsculas. Varios roles, servicios de rol y características se deben separar mediante espacios. Con el parámetro -remove se usan los siguientes parámetros opcionales:
  • -resultpath<[[<drive>:]<path>]result.xml>: guarda los resultados de la desinstalación en el archivo XML representado por <result.xml>. También puede usar la forma abreviada del parámetro, -r.

    NOTA:
    No se puede ejecutar servermanagercmd con los parámetros -resultpath y -whatif especificados.

  • -restart: reinicia el equipo automáticamente cuando se completa la desinstalación (si los roles o las características que permanecen requieren reinicio).
  • -whatif: muestra todas las operaciones especificadas para el comando -remove. También puede usar la forma abreviada del parámetro, -whatif, -w. No se puede ejecutar servermanagercmd con los parámetros -resultpath y -whatif especificados.
  • -logpath<[[<Drive>:]<path>]<log.txt>>: especifica un nombre y una ubicación para el archivo de registro, que no sea el predeterminado, %windir%\temp\servermanager.log.
-version Muestra el número de versión del Administrador del servidor. También puede usar la forma abreviada, -v.
-help Muestra la ayuda en la ventana del símbolo del sistema. También puede usar la forma abreviada, -?.

Ejemplos

Para mostrar una lista de todos los roles, servicios de rol y características disponibles, y qué roles, servicios de rol y características están instalados en el equipo, escriba:

servermanagercmd -query

Para instalar el rol Servidor web (IIS) y guardar los resultados de la instalación en un archivo XML representado por installResult.xml, escriba:

servermanagercmd -install Web-Server -resultpath installResult.xml

Para mostrar información detallada sobre los roles, los servicios de rol y las características que se instalarían o quitarían, en función de las instrucciones especificadas en un archivo de respuesta XML representado por install.xml, escriba:

servermanagercmd -inputpath install.xml -whatif