Windows Server 2008 Technical Library > Server Manager > Getting Started: Server Manager

Server Manager Technical Overview Appendix

Updated: October 18, 2007

In this Appendix

This topic includes the following references:

•	The Server Manager command line XML answer file schema
•	Server Manager command-line syntax, examples, options, and parameters in the section Server Manager command line syntax and parameters

XML answer file schema

The following section of code is the Server Manager command-line XML schema.

<?xml version="1.0" encoding="utf-8" ?> 
- <xs:schema targetNamespace="http://schemas.microsoft.com/sdm/Windows/ServerManager/Configuration/2007/1" xmlns="http://schemas.microsoft.com/sdm/Windows/ServerManager/Configuration/2007/1" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
- <!--  ======================================================================================= 
  --> 
- <!--  Root element for the input xml for install or remove. 
  --> 
- <!--  ======================================================================================= 
  --> 
- <xs:element name="ServerManagerConfiguration">
- <xs:complexType>
- <xs:choice minOccurs="1" maxOccurs="unbounded">
  <xs:element name="Role" type="FeatureType" minOccurs="0" /> 
  <xs:element name="RoleService" type="FeatureType" minOccurs="0" /> 
  <xs:element name="Feature" type="FeatureType" minOccurs="0" /> 
  <xs:any namespace="##other" processContents="skip" minOccurs="0" /> 
  </xs:choice>
  <xs:attribute name="Action" type="InstallationActionType" use="required" /> 
  <xs:anyAttribute namespace="##other" processContents="skip" /> 
  </xs:complexType>
  </xs:element>
- <!--  ======================================================================================= 
  --> 
- <!--  Root element for the results of an install or remove. 
  --> 
- <!--  ======================================================================================= 
  --> 
- <xs:element name="ServerManagerConfigurationResult">
- <xs:complexType>
- <xs:choice minOccurs="1" maxOccurs="unbounded">
  <xs:element name="Role" type="FeatureResultType" minOccurs="0" /> 
  <xs:element name="RoleService" type="FeatureResultType" minOccurs="0" /> 
  <xs:element name="Feature" type="FeatureResultType" minOccurs="0" /> 
  <xs:element name="Message" type="MessageType" minOccurs="0" /> 
  <xs:any namespace="##other" processContents="skip" minOccurs="0" /> 
  </xs:choice>
  <xs:attribute name="Action" type="InstallationActionType" use="required" /> 
  <xs:attribute name="RequiresReboot" type="xs:boolean" /> 
  <xs:attribute name="Success" type="xs:boolean" /> 
  <xs:attributeGroup ref="CommonOutputAttributes" /> 
  <xs:anyAttribute namespace="##other" processContents="skip" /> 
  </xs:complexType>
  </xs:element>
- <!--  ======================================================================================= 
  --> 
- <!--  Root element for querying the roles and features that are installed. 
  --> 
- <!--  ======================================================================================= 
  --> 
- <xs:element name="ServerManagerConfigurationQuery">
- <xs:complexType>
- <xs:sequence>
  <xs:element name="Role" type="RoleQueryType" minOccurs="0" maxOccurs="unbounded" /> 
  <xs:element name="Feature" type="FeatureQueryType" minOccurs="0" maxOccurs="unbounded" /> 
  <xs:any namespace="##other" processContents="skip" minOccurs="0" maxOccurs="unbounded" /> 
  </xs:sequence>
  <xs:attributeGroup ref="CommonOutputAttributes" /> 
  <xs:anyAttribute namespace="##other" processContents="skip" /> 
  </xs:complexType>
  </xs:element>
- <!--  ======================================================================================= 
  --> 
- <!--  Supporting types for the install (or remove) input xml. 
  --> 
- <!--  ======================================================================================= 
  --> 
- <!--  Definition for roles, role services, and features 
  --> 
- <xs:complexType name="FeatureType">
- <xs:choice minOccurs="0" maxOccurs="unbounded">
  <xs:element name="Setting" type="SettingType" /> 
  <xs:any namespace="##other" processContents="skip" /> 
  </xs:choice>
  <xs:attribute name="Id" type="xs:string" use="required" /> 
- <!--  InstallAllSubFeatures is ignored for features without subfeatures and during remove. 
  --> 
  <xs:attribute name="InstallAllSubFeatures" type="xs:boolean" /> 
  <xs:anyAttribute namespace="##other" processContents="skip" /> 
  </xs:complexType>
- <!--  Definition for settings 
  --> 
- <xs:complexType name="SettingType">
- <xs:simpleContent>
- <xs:extension base="xs:string">
  <xs:attribute name="Name" use="required" /> 
  </xs:extension>
  </xs:simpleContent>
  </xs:complexType>
- <!--  Install or Remove action 
  --> 
- <xs:simpleType name="InstallationActionType">
- <xs:restriction base="xs:string">
  <xs:enumeration value="Install" /> 
  <xs:enumeration value="Remove" /> 
  </xs:restriction>
  </xs:simpleType>
- <!--  ======================================================================================= 
  --> 
- <!--  Supporting types for the results output of an install or remove. 
  --> 
- <!--  ======================================================================================= 
  --> 
- <xs:complexType name="FeatureResultType">
- <xs:sequence>
  <xs:element name="Message" type="MessageType" minOccurs="0" maxOccurs="unbounded" /> 
  </xs:sequence>
  <xs:attribute name="DisplayName" type="xs:string" use="required" /> 
  <xs:attribute name="Success" type="xs:boolean" /> 
  <xs:attribute name="RootParent" type="xs:string" /> 
  <xs:attribute name="Id" type="xs:string" /> 
  <xs:attribute name="RequiresReboot" type="xs:boolean" /> 
  <xs:attribute name="Skipped" type="xs:boolean" /> 
  <xs:attribute name="RequestedBy" type="RequestedByType" /> 
  </xs:complexType>
- <xs:complexType name="MessageType">
- <xs:simpleContent>
- <xs:extension base="xs:string">
  <xs:attribute name="Level" use="required" type="LevelType" /> 
  <xs:attribute name="Code" type="xs:integer" /> 
  </xs:extension>
  </xs:simpleContent>
  </xs:complexType>
- <xs:simpleType name="LevelType">
- <xs:restriction base="xs:string">
  <xs:enumeration value="Error" /> 
  <xs:enumeration value="Warning" /> 
  <xs:enumeration value="Information" /> 
  </xs:restriction>
  </xs:simpleType>
- <xs:simpleType name="RequestedByType">
- <xs:restriction base="xs:string">
  <xs:enumeration value="UserSpecified" /> 
  <xs:enumeration value="Default" /> 
  <xs:enumeration value="AllChildren" /> 
  <xs:enumeration value="Dependency" /> 
  </xs:restriction>
  </xs:simpleType>
- <xs:attributeGroup name="CommonOutputAttributes">
  <xs:attribute name="Time" type="xs:dateTime" /> 
  <xs:attribute name="Sku" type="xs:string" /> 
  <xs:attribute name="Language" type="xs:string" /> 
  <xs:attribute name="Architecture" type="xs:string" /> 
  </xs:attributeGroup>
- <!--  ======================================================================================= 
  --> 
- <!--  Supporting types for querying the roles and features that are installed. 
  --> 
- <!--  ======================================================================================= 
  --> 
- <xs:complexType name="RoleQueryType">
- <xs:sequence>
  <xs:element name="RoleService" type="RoleServiceQueryType" minOccurs="0" maxOccurs="unbounded" /> 
  <xs:element name="Setting" type="SettingQueryType" minOccurs="0" maxOccurs="unbounded" /> 
  </xs:sequence>
  <xs:attributeGroup ref="FeatureQueryAttributes" /> 
  </xs:complexType>
- <xs:complexType name="RoleServiceQueryType">
- <xs:sequence>
  <xs:element name="RoleService" type="RoleServiceQueryType" minOccurs="0" maxOccurs="unbounded" /> 
  </xs:sequence>
  <xs:attributeGroup ref="FeatureQueryAttributes" /> 
  </xs:complexType>
- <xs:complexType name="FeatureQueryType">
- <xs:sequence>
  <xs:element name="Feature" type="FeatureQueryType" minOccurs="0" maxOccurs="unbounded" /> 
  </xs:sequence>
  <xs:attributeGroup ref="FeatureQueryAttributes" /> 
  </xs:complexType>
- <xs:complexType name="SettingQueryType">
- <xs:sequence>
  <xs:element name="Value" type="ValueQueryType" minOccurs="0" maxOccurs="unbounded" /> 
  </xs:sequence>
  <xs:attribute name="Name" type="xs:string" /> 
  <xs:attribute name="Description" type="xs:string" /> 
  </xs:complexType>
- <xs:complexType name="ValueQueryType">
  <xs:attribute name="Name" type="xs:string" /> 
  <xs:attribute name="Description" type="xs:string" /> 
  </xs:complexType>
- <xs:attributeGroup name="FeatureQueryAttributes">
  <xs:attribute name="DisplayName" type="xs:string" use="required" /> 
  <xs:attribute name="Installed" type="xs:boolean" use="required" /> 
  <xs:attribute name="Id" type="xs:string" /> 
  <xs:attribute name="Default" type="xs:boolean" /> 
  </xs:attributeGroup>
  </xs:schema>

Top of page

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

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

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

Top of page

Additional references

Server Manager Technical Overview main page (http://go.microsoft.com/fwlink/?LinkId=85101).