Old Stuf‎ > ‎Microsoft‎ > ‎Windows 2008‎ > ‎

Server Manager command line syntax and parameters

The following sections show the syntax and command-line parameters and options for ServerManagerCmd.exe.

Syntax

ServerManagerCmd.exe -query [<query.xml>] [-logPath <log.txt>]

ServerManagerCmd.exe -inputPath <answer.xml> [-resultPath <result.xml> [-restart] | -whatIf] [-logPath <log.txt>]

ServerManagerCmd.exe -install <command-Id> [-allSubFeatures] [-resultPath <result.xml> [-restart] | -whatIf] [-logPath <log.txt>]

ServerManagerCmd.exe -remove <command-Id> [-resultPath <result.xml> [-restart] | -whatIf] [-logPath <log.txt>]

ServerManagerCmd.exe [-help | -?]

ServerManagerCmd.exe -version

Parameters

Parameter Description

-query [<query.xml>]

Displays a list of all roles, role services, and features installed and available for installation on the server. You can also use the short form of this parameter, -q.

If you want the query results saved to an XML file, specify an XML file to replace query.xml.

-inputPath <answer.xml>

Installs or removes the roles, role services, and features specified in the answer file, an XML file represented by answer.xml. You can also use the short form of this parameter, -p.

-install <Id>

Installs the role, role service, or feature specified by Id. See Role, role service, and feature command identifiers in this topic for a complete list of the role, role service, or feature identifiers from which you can choose to specify for Id. The identifiers are case-insensitive.

The following optional parameters are used with the -install parameter.

Parameter Description

-allSubFeatures

Specify the installation of all subordinate services and features along with the parent role, role service, or feature named in the -install command's Id parameter.

Note that some role containers do not have a command line identifier to allow installation of all role services. This is the case when role services cannot be installed in the same instance of the Server Manager command. For example, the Federation Service role service of Active Directory Federation Services and the Federation Service Proxy role service cannot be installed by using the same Server Manager command instance.

-resultPath <result.xml>

Saves installation results to an XML file represented by result.xml. You can also use the short form of this parameter, -r. You cannot use the -resultPath parameter and the -whatIf parameter in the same instance of ServerManagerCmd.exe.

-restart

Adding -restart to the -install command restarts the computer automatically when installation is complete, if restarting is required by the roles or features installed.

-whatIf

You can use -whatIf to display any operations specified for the -install command. You can also use the short form of the -whatIf parameter, -w. You cannot use the -resultPath parameter and the -whatIf parameter in the same instance of ServerManagerCmd.exe.

-logPath <log.txt>

Use -logPath to specify a name and location for the log file, other than the default, %windir%\temp\servermanager.log.

-remove <Id>

Removes the role, role service, or feature specified by Id. See Role, role service, and feature command identifiers in this topic for a complete list of the role, role service, and feature identifiers from which you can choose to specify for Id. The identifiers are case-insensitive.

The following optional parameters are used with the -remove parameter.

Parameter Description

-resultPath <result.xml>

Saves removal results to an XML file represented by result.xml. You can also use the short form of this parameter, -r. Note that you cannot use the -resultPath parameter and the -whatIf parameter in the same instance of ServerManagerCmd.exe.

-restart

Adding -restart to the -remove command restarts the computer automatically when removal is complete, if restarting is required by remaining roles or features.

-whatIf

You can use -whatIf to display any operations specified for the -remove command. You can also use the short form of the -whatIf parameter, -w. You cannot use the -resultPath parameter and the -whatIf parameter in the same instance of ServerManagerCmd.exe.

-logPath <log.txt>

Use -logPath to specify a name and location for the log file, other than the default, %windir%\temp\servermanager.log.

-help

Display Help for ServerManagerCmd.exe in the command window. You can also use the short form, -?.

-version

Display the Server Manager version number. You can also use the short form, -v.

Role, role service, and feature command identifiers

The tables in this section match roles, role services, and features available in Windows Server 2008 with the command identifiers you must use with ServerManagerCmd.exe to install or remove them.

Role and Role Service command identifiers

Role and Role Service command identifiers Command value Notes

DHCP Server

DHCP

The DHCP Server role should be installed with default settings.

Print Services

Print Server

Internet Printing

LPD Service

Print-Server

Print-Services

Print-Internet

Print-LPD-Service

 

During removal of this role in the Server Manager UI, you are prompted to delete instances of printers configured on the server. By default, these instances are preserved, which is the default behavior of command-line removal of the Print Services role.

Terminal Services

Terminal Server

TS Licensing

TS Gateway

TS Web Access

TS Session Broker

Terminal-Services

TS-Terminal-Server

TS-Licensing

TS-Gateway

TS-Web-Access

TS-Session-Broker

Because Terminal Services settings can be configured after installing the role, you are not required to specify Terminal Services settings in the command-line answer file.

Active Directory Domain Services

Active Directory Domain Controller

Identity Management for UNIX

Server for Network Information Service

Password Synchronization

(No command)

ADDS-Domain-Controller

ADDS-Identity-Management

ADDS-NIS

ADDS-Password-Sync

 

After installing Active Directory Domain Services (AD DS), you must run the dcpromo command to promote the server to a domain controller.

Removing the AD DS role while the computer is operating as a domain controller fails. You must first demote the domain controller to a standard domain member.

DNS Server

DNS

None

File Services

Distributed File System (DFS)

DFS Namespace

DFS Replication

File Server Resource Manager

Services for Network File System

Windows Search Service

Windows Server 2003 File Services

File Replication Service

Indexing Service

 

(No command)

FS-DFS

FS-DFS-Namespace

FS-DFS-Replication

FS-Resource-Manager

FS-NFS-Services

FS-Search-Service

FS-Win2003-Services

FS-Replication

FS-Indexing-Service

 

You cannot install or remove the File Services container by using the Server Manager command line. You can install or remove the File Services container only by using the Server Manager user interface. Note that for this reason, there is no command ID available to represent the File Services container.

Because you can configure File Services settings after installing the role, you are not required to specify File Services settings in the Server Manager command-line answer file.

Note that Services for Network File system is not part of the File Services role on computers running the IA64 version of Windows Server 2008; it is available as a feature on the 64-bit version of Windows Server 2008.

Web Server (IIS)

Internet Information Services

Common HTTP Features

Static Content

Default Document

Directory Browsing

HTTP Errors

HTTP Redirection

Application Development

ASP.NET

.NET Extensibility

ASP

CGI

ISAPI Extensions

ISAPI Filters

Server Side Includes

Health and Diagnostics

HTTP Logging

Logging Tools

Request Monitor

Tracing

Custom Logging

ODBC Logging

Security

Basic Authentication

Windows Authentication

Digest Authentication

Client Certificate Mapping Authentication

IIS Client Certificate Mapping Authentication

URL Authorization

Request Filtering

IP and Domain Restrictions

Performance

Static Content Compression

Dynamic Content Compression

Management Tools

IIS Management Console

IIS Management Scripts and Tools

Management Service

IIS 6 Management Compatibility

IIS 6 Metabase Compatibility

IIS 6 WMI Compatibility

IIS 6 Scripting Tools

IIS 6 Management Console

FTP Publishing Service

FTP Server

FTP Management Console

 

Web-Server

Web-WebServer

Web-Common-Http

Web-Static-Content

Web-Default-Doc

Web-Dir-Browsing

Web-Http-Errors

Web-Http-Redirect

Web-App-Development

Web-Asp-Net

Web-Net-Ext

Web-ASP

Web-CGI

Web-ISAPI-Ext

Web-ISAPI-Filter

Web-Includes

Web-Health

Web-Http-Logging

Web-Log-Libraries

Web-Request-Monitor

Web-Http-Tracing

Web-Custom-Logging

Web-ODBC-Logging

Web-Security

Web-Basic-Auth

Web-Windows-Auth

Web-Digest-Auth

Web-Client-Auth

Web-Cert-Auth

Web-Url-Auth

Web-Filtering

Web-IP-Security

Web-Performance

Web-Stat-Compression

Web-Dyn-Compression

Web-Mgmt-Tools

Web-Mgmt-Console

Web-Scripting-Tools

Web-Mgmt-Service

Web-Mgmt-Compat

Web-Metabase

Web-WMI

Web-Lgcy-Scripting

Web-Lgcy-Mgmt-Console

Web-Ftp-Publishing

Web-Ftp-Server

Web-Ftp-Mgmt-Console

 

None

Active Directory Federation Services

Federation Service

Federation Service Proxy

Web Agents

Claims-aware Agent

Windows Token-based Agent

(No command)

ADFS-Federation

ADFS-Proxy

ADFS-Web-Agents

ADFS-Claims

ADFS-Windows-Token

Active Directory Federation Services should be installed with default settings.

Active Directory Lightweight Directory Services

ADLDS

None

Application Server

Application Server Core

Web Server Support

COM+ Network Access

TCP Port Sharing

Windows Process Activation Service Support

HTTP Activation

Message Queuing Activation

TCP Activation

Named Pipes Activation

Distributed Transaction Support

Incoming Remote Transactions

Outgoing Remote Transactions

WS-Atomic Transaction Support

Application-Server

AS-AppServer-Core

AS-Web-Support

AS-Ent-Services

AS-TCP-Port-Sharing

AS-WAS-Support

AS-HTTP-Activation

AS-MSMQ-Activation

AS-TCP-Activation

AS-Named-Pipes

AS-Dist-Transaction

AS-Incoming-Trans

AS-Outgoing-Trans

AS-WS-Atomic

If you install the WS-Atomic Transaction Support role service, you should also configure it to use a self-signed certificate.

Active Directory Certificate Services

Certification Authority

Certification Authority Web Enrollment (not installable by using the command line)

Online Certificate Status Protocol

Microsoft Simple Certificate Enrollment Protocol (not installable by using the command line)

 

(No command)

ADCS-Cert-Authority

AD-Certificate

ADCS-Online-Cert

Certification Authority and Online Certificate Status Protocol can be installed by using the Server Manager command-line interface. Other role services for Active Directory Certificate Services cannot be installed by using the Server Manager command line.

Fax Server

Fax

Fax Server should be installed with default settings.

Network Policy and Access Services

Network Policy Server

NPAS Routing and Remote Access Services

Remote Access Service

Routing

Health Registration Authority

NPAS

NPAS-Policy-Server

NPAS-RRAS-Services

NPAS-RRAS

NPAS-Routing

NPAS-Health

Because Network Policy and Access Services settings can be configured after installing the role, you are not required to specify Network Policy and Access Services settings in the command-line answer file.

Active Directory Rights Management Services (AD RMS)

Rights Management Server

Active Directory Rights Management Services (AD RMS) cannot be installed by using the Server Manager command line.

None

UDDI Services

UDDI Services Web Application

UDDI Services Database

UDDI Services is not installable by using the Server Manager command line.

You cannot install UDDI Services by using the Server Manager command-line because complex database settings are required during UDDI Services setup.

Windows Deployment Services

WDS

None

Hyper-V

Hyper-V

None

Feature command identifiers

Features Command Value Notes

Failover Clustering

Failover-Clustering

 

Network Load Balancing

NLB

 

Desktop Experience

Desktop-Experience

 

.NET Framework 3.0 Features

.NET Framework 3.0

XPS Viewer

Windows Communication Foundation Activation Components

HTTP Activation

Non-HTTP Activation

NET-Framework

NET-Framework-Core

NET-XPS-Viewer

NET-Win-CFAC

NET-HTTP-Activation

NET-Non-HTTP-Activ

Note that the command-line syntax for .NET Framework 3.0 Features does not contain the "." character before NET.

Windows System Resource Manager

WSRM

 

Wireless Networking

Wireless-Networking

 

Windows Server Backup

Backup

 

WINS Server

WINS-Server

 

Remote Assistance

Remote-Assistance

 

Simple TCP/IP Services

Simple-TCPIP

 

Telnet Client

Telnet-Client

 

Telnet Server

Telnet-Server

 

Subsystem for UNIX-based Applications

Subsystem-UNIX-Apps

 

RPC over HTTP Proxy

RPC-over-HTTP-Proxy

 

SMTP Server

SMTP-Server

 

LPR Port Monitor

LPR-Port-Monitor

 

Storage Manager for SANs

Storage-Mgr-SANS

 

BITS Server Extensions

BITS

 

Message Queuing

Message Queuing Services

Message Queuing Server

Directory Service Integration

Message Queuing Triggers

HTTP Support

Multicasting Support

Routing Service

Windows 2000 Client Support

Messaging Queue DCOM Proxy

MSMQ

MSMQ-Services

MSMQ-Server

MSMQ-Directory

MSMQ-Triggers

MSMQ-HTTP-Support

MSMQ-Multicasting

MSMQ-Routing

MSMQ-Win2000

MSMQ-DCOM

 

Windows Process Activation Service

Process Model

.NET Environment

Configuration APIs

WAS

WAS-Process-Model

WAS-NET-Environment

WAS-Config-APIs

 

Windows Internal Database

Windows-Internal-DB

 

BitLocker Drive Encryption

BitLocker

 

Multipath I/O

Multipath-IO

 

Internet Storage Naming Server

ISNS

 

Removable Storage Manager

Removable-Storage

 

TFTP Client

TFTP-Client

 

SNMP Services

SNMP Service

SNMP WMI Provider

SNMP-Services

SNMP-Service

SNMP-WMI-Provider

 

Services for Network File System

NFS-Services

Services for Network File System is available as a feature only on the Windows Server 2008 IA64 version. On other versions of Windows Server 2008, it is available as a role service of File Services.

Internet Printing Client

Internet-Print-Client

 

Peer Name Resolution Protocol

PNRP

 

Connection Manager Administration Kit

CMAK

 

Remote Server Administration Tools

Role administration tools

Active Directory Certificate Services Tools

Active Directory Domain Services Tools

Active Directory Domain Controller Tools

Server for NIS Tools

Active Directory Lightweight Directory Services Tools

Active Directory Rights Management Services (AD RMS) Tools

DHCP Server Tools

DNS Server Tools

Fax Server Tools

DFS Management Console Tools

File Server Resource Manager Management Console Tools

Hyper-V Tools

Services for Network File System Tools

File Services Tools

Network Policy and Access Services Tools

Health Registration Authority Tools

Network Policy Server Tools

Remote Access Service Tools

Print Services Tools

Web Server (IIS) Tools

Terminal Services Tools

TS RemoteApp Tools

TS Gateway Tools

TS Licensing Tools

UDDI Services Tools

Feature administration tools

BitLocker Drive Encryption Tools

BITS Server Extensions Tools

Failover Clustering Tools

Network Load Balancing Tools

SMTP Server Tools

Windows Deployment Services Tools

WINS Server Tools

Hyper-V Tools

 

RSAT

RSAT-Role-Tools

RSAT-ADCS

RSAT-ADDS

RSAT-ADDC

RSAT-SNIS

RSAT-ADLDS

RSAT-RMS

RSAT-DHCP

RSAT-DNS

RSAT-Fax

RSAT-DFS-Mgnt-Con

RSAT-FSRM-Mgnt

RSAT-Hyper-V

RSAT-NFS-Admin

RSAT-File-Services

RSAT-NPAS

RSAT-HRA

RSAT-NPS

RSAT-Print-Services

RSAT-Web-Server

RSAT-TS

RSAT-TS-RemoteApp

RSAT-TS-Gateway

RSAT-TS-Licensing

RSAT-UDDI

RSAT-Feature-Tools

RSAT-BitLocker

RSAT-BITS-Server

RSAT-Clustering

RSAT-NLB

RSAT-SMTP

RSAT-WDS

RSAT-WINS

RSAT-Hyper-V

 

 

Windows PowerShell

PowerShell

 

Group Policy Management

GPMC

 

Quality Windows Audio Video Experience

Qwave

Comments