servermanagercmd

  • Статья

Область применения: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Устанавливает и удаляет роли, службы ролей и компоненты. Также отображает список всех ролей, служб ролей и доступных компонентов и показывает, какие установлены на этом компьютере.

Внимание

Эта команда, servermanagercmd, устарела и не гарантируется, что она будет поддерживаться в будущих выпусках Windows. Вместо этого рекомендуется использовать командлеты Windows PowerShell, доступные для диспетчер сервера. Дополнительные сведения см. в разделе Install or Uninstall Roles, Role Services, or Features.

Синтаксис

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

Параметры

Параметр Описание
-Запроса [[[<drive>:]<path>]<query.xml>] Отображает список всех ролей, служб ролей и компонентов, установленных и доступных для установки на сервере. Кроме того, можно использовать короткую форму этого параметра -q. Если вы хотите, чтобы результаты запроса, сохраненные в XML-файле, укажите XML-файл для замены <query.xml>.
-inputpath [[[<drive>:]<path>]<answer.xml>] Устанавливает или удаляет роли, службы ролей и компоненты, указанные в XML-файле ответа, представленном <answer.xml>. Вы также можете использовать короткую форму этого параметра -p.
-Установить <id> Устанавливает роль, службу ролей или компонент, указанный в параметре <id>. Идентификаторы не учитывает регистр. Несколько ролей, служб ролей и функций должны быть разделены пробелами. Следующие необязательные параметры используются с параметром -install :
  • -setting<SettingName>=<SettingValue> — задает необходимые параметры для установки.
  • -allSubFeatures — указывает установку всех подчиненных служб и компонентов вместе с родительской ролью, службой ролей или функцией, именуемой в значении <id> .

    ПРИМЕЧАНИЕ
    Некоторые контейнеры ролей не имеют идентификатора командной строки, чтобы разрешить установку всех служб ролей. Это происходит, когда службы ролей не могут быть установлены в том же экземпляре команды диспетчер сервера. Например, служба роли службы федерации служб федерации служб Active Directory и служба прокси-роли службы федерации не могут быть установлены с помощью того же экземпляра команды диспетчер сервера.

  • -resultpath<result.xml> — сохраняет результаты установки в XML-файл, <result.xml>представленный . Кроме того, можно использовать короткую форму этого параметра -r.

    ПРИМЕЧАНИЕ
    Невозможно запустить servermanagercmd с параметром -resultpath и указанным параметром -whatif.

  • -restart — автоматически перезапускает компьютер при завершении установки (если перезагрузка требуется ролями или компонентами).
  • -whatif — отображает все операции, указанные для параметра -install . Можно также использовать короткую форму параметра -whatif , -w. Невозможно запустить servermanagercmd с параметром -resultpath и указанным параметром -whatif.
  • -logpath<[[<drive>:]<path>]<log.txt>> — указывает имя и расположение для файла журнала, отличного от используемого по умолчанию %windir%\temp\servermanager.log.
-Удалить <id> Удаляет роль, службу ролей или функцию, указанную в параметре <id>. Идентификаторы не учитывает регистр. Несколько ролей, служб ролей и функций должны быть разделены пробелами. Следующие необязательные параметры используются с параметром -remove :
  • -resultpath<[[<drive>:]<path>]result.xml> — сохраняет результаты удаления в XML-файл, <result.xml>представленный . Кроме того, можно использовать короткую форму этого параметра -r.

    ПРИМЕЧАНИЕ
    Не удается запустить servermanagercmd с заданными параметрами -resultpath и -whatif .

  • -restart — автоматически перезапускает компьютер при завершении удаления (если перезагрузка требуется оставшимися ролями или функциями).
  • -whatif — отображает все операции, указанные для параметра -remove. Можно также использовать короткую форму параметра -whatif, -w. Не удается запустить servermanagercmd с заданными параметрами -resultpath и -whatif .
  • -logpath<[[<Drive>:]<path>]<log.txt>> — указывает имя и расположение для файла журнала, отличного от используемого по умолчанию %windir%\temp\servermanager.log.
-version Отображает номер версии диспетчер сервера. Можно также использовать короткую форму -v.
-help Отображает справку в окне командной строки. Вы также можете использовать короткую форму - ?.

Примеры

Чтобы отобразить список всех ролей, служб ролей и доступных компонентов, а также доступных ролей, служб ролей и компонентов, установленных на компьютере, введите:

servermanagercmd -query

Чтобы установить роль веб-сервера (IIS) и сохранить результаты установки в XML-файл, представленный installResult.xml, введите:

servermanagercmd -install Web-Server -resultpath installResult.xml

Чтобы отобразить подробные сведения о ролях, службах ролей и компонентах, которые будут установлены или удалены, на основе инструкций, указанных в XML-файле ответа, представленном install.xml, введите:

servermanagercmd -inputpath install.xml -whatif