Server Manager Technical Overview Appendix
Applies To: Windows Server 2008
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="https://schemas.microsoft.com/sdm/Windows/ServerManager/Configuration/2007/1" xmlns="https://schemas.microsoft.com/sdm/Windows/ServerManager/Configuration/2007/1" xmlns:xs="https://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>
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.
|
-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.
|
-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
Active Directory Certificate Services command identifiers | Command value | Notes |
---|---|---|
Active Directory Certificate Services |
(No command) |
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. |
Certification Authority |
ADCS-Cert-Authority |
|
Certification Authority Web Enrollment (not installable by using the command line) |
AD-Certificate |
|
Online Certificate Status Protocol |
ADCS-Online-Cert |
|
Microsoft Simple Certificate Enrollment Protocol (not installable by using the command line) |
(No command) |
Active Directory Domain Services command identifiers | Command value | Notes |
---|---|---|
Active Directory Domain Services |
(No command) |
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. |
Active Directory Domain Controller |
ADDS-Domain-Controller |
|
Identity Management for UNIX |
ADDS-Identity-Management |
|
Server for Network Information Service |
ADDS-NIS |
|
Password Synchronization |
ADDS-Password-Sync |
|
Administration tools for Identity Management for UNIX |
ADDS-IDMU-Tools |
Active Directory Federation Services command identifiers | Command value | Notes |
---|---|---|
Active Directory Federation Services |
(No command) |
Active Directory Federation Services should be installed with default settings. |
Federation Service |
ADFS-Federation |
|
Federation Service Proxy |
ADFS-Proxy |
|
Web Agents |
ADFS-Web-Agents |
|
Claims-aware Agent |
ADFS-Claims |
|
Windows Token-based Agent |
ADFS-Windows-Token |
Active Directory Lightweight Directory Services command identifiers | Command value | Notes |
---|---|---|
Active Directory Lightweight Directory Services |
ADLDS |
None |
Active Directory Rights Management Services (AD RMS) command identifiers | Command value | Notes |
---|---|---|
Active Directory Rights Management Services (AD RMS) |
Active Directory Rights Management Services (AD RMS) cannot be installed by using the Server Manager command line. |
None |
Application Server command identifiers | Command value | Notes |
---|---|---|
Application Server |
Application-Server |
If you install the WS-Atomic Transaction Support role service by using the Server Manager command line, by default, WS-Atomic Transaction Support is configured to use a self-signed certificate. |
Application Server Core |
AS-AppServer-Core |
|
Web Server Support |
AS-Web-Support |
|
COM+ Network Access |
AS-Ent-Services |
|
TCP Port Sharing |
AS-TCP-Port-Sharing |
|
Windows Process Activation Service Support |
AS-WAS-Support |
|
HTTP Activation |
AS-HTTP-Activation |
|
Message Queuing Activation |
AS-MSMQ-Activation |
|
TCP Activation |
AS-TCP-Activation |
|
Named Pipes Activation |
AS-Named-Pipes |
|
Distributed Transaction Support |
AS-Dist-Transaction |
|
Incoming Remote Transactions |
AS-Incoming-Trans |
|
Outgoing Remote Transactions |
AS-Outgoing-Trans |
|
WS-Atomic Transaction Support |
AS-WS-Atomic |
DHCP Server command identifiers | Command value | Notes |
---|---|---|
DHCP Server |
DHCP |
The DHCP Server role should be installed with default settings. |
DNS Server command identifiers | Command value | Notes |
---|---|---|
DNS Server |
DNS |
None |
Fax Server command identifiers | Command value | Notes |
---|---|---|
Fax Server |
Fax |
Fax Server should be installed with default settings. |
File Services command identifiers | Command value | Notes |
---|---|---|
File Services |
(No command) |
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 Windows Server 2008 for Itanium-based Systems; it is available as a role service of File Services only on the 32-bit and 64-bit versions of Windows Server 2008. |
File Server |
FS-Fileserver |
|
Distributed File System (DFS) |
FS-DFS |
|
DFS Namespace |
FS-DFS-Namespace |
|
DFS Replication |
FS-DFS-Replication |
|
File Server Resource Manager |
FS-Resource-Manager |
|
Services for Network File System |
FS-NFS-Services |
|
Windows Search Service |
FS-Search-Service |
|
Windows Server 2003 File Services |
FS-Win2003-Services |
|
File Replication Service |
FS-Replication |
|
Indexing Service |
FS-Indexing-Service |
Hyper-V™ command identifiers | Command value |
---|---|
Hyper-V™ |
Hyper-V |
Network Policy and Access Services command identifiers | Command value | Notes |
---|---|---|
Network Policy and Access Services |
NPAS |
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. |
Network Policy Server |
NPAS-Policy-Server |
|
NPAS Routing and Remote Access Services |
NPAS-RRAS-Services |
|
Remote Access Service |
NPAS-RRAS |
|
Routing |
NPAS-Routing |
|
Health Registration Authority |
NPAS-Health |
Print Services command identifiers | Command value | Notes |
---|---|---|
Print Services |
Print-Server |
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. |
Print Server |
Print-Services |
|
Internet Printing |
Print-Internet |
|
LPD Service |
Print-LPD-Service |
Terminal Services command identifiers | Command value | Notes |
---|---|---|
Terminal Services |
Terminal-Services |
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. |
Terminal Server |
TS-Terminal-Server |
|
TS Licensing |
TS-Licensing |
|
TS Gateway |
TS-Gateway |
|
TS Web Access |
TS-Web-Access |
|
TS Session Broker |
TS-Session-Broker |
UDDI Services command identifiers | Command value | Notes |
---|---|---|
UDDI Services |
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. |
UDDI Services Web Application |
||
UDDI Services Database |
Web Server (IIS) command identifiers | Command value | Notes |
---|---|---|
Web Server (IIS) |
Web-Server |
None |
Internet Information Services |
Web-WebServer |
|
Common HTTP Features |
Web-Common-Http |
|
Static Content |
Web-Static-Content |
|
Default Document |
Web-Default-Doc |
|
Directory Browsing |
Web-Dir-Browsing |
|
HTTP Errors |
Web-Http-Errors |
|
HTTP Redirection |
Web-Http-Redirect |
|
Application Development |
Web-App-Development |
|
ASP.NET |
Web-Asp-Net |
|
.NET Extensibility |
Web-Net-Ext |
|
ASP |
Web-ASP |
|
CGI |
Web-CGI |
|
ISAPI Extensions |
Web-ISAPI-Ext |
|
ISAPI Filters |
Web-ISAPI-Filter |
|
Server Side Includes |
Web-Includes |
|
Health and Diagnostics |
Web-Health |
|
HTTP Logging |
Web-Http-Logging |
|
Logging Tools |
Web-Log-Libraries |
|
Request Monitor |
Web-Request-Monitor |
|
Tracing |
Web-Http-Tracing |
|
Custom Logging |
Web-Custom-Logging |
|
ODBC Logging |
Web-ODBC-Logging |
|
Security |
Web-Security |
|
Basic Authentication |
Web-Basic-Auth |
|
Windows Authentication |
Web-Windows-Auth |
|
Digest Authentication |
Web-Digest-Auth |
|
Client Certificate Mapping Authentication |
Web-Client-Auth |
|
IIS Client Certificate Mapping Authentication |
Web-Cert-Auth |
|
URL Authorization |
Web-Url-Auth |
|
Request Filtering |
Web-Filtering |
|
IP and Domain Restrictions |
Web-IP-Security |
|
Performance |
Web-Performance |
|
Static Content Compression |
Web-Stat-Compression |
|
Dynamic Content Compression |
Web-Dyn-Compression |
|
Management Tools |
Web-Mgmt-Tools |
|
IIS Management Console |
Web-Mgmt-Console |
|
IIS Management Scripts and Tools |
Web-Scripting-Tools |
|
Management Service |
Web-Mgmt-Service |
|
IIS 6 Management Compatibility |
Web-Mgmt-Compat |
|
IIS 6 Metabase Compatibility |
Web-Metabase |
|
IIS 6 WMI Compatibility |
Web-WMI |
|
IIS 6 Scripting Tools |
Web-Lgcy-Scripting |
|
IIS 6 Management Console |
Web-Lgcy-Mgmt-Console |
|
FTP Publishing Service |
Web-Ftp-Publishing |
|
FTP Server |
Web-Ftp-Server |
|
FTP Management Console |
Web-Ftp-Mgmt-Console |
Windows Deployment Services command identifiers | Command value | Notes |
---|---|---|
Windows Deployment Services |
WDS |
None |
Feature command identifiers
Features | Command Value | Notes |
---|---|---|
BitLocker Drive Encryption |
BitLocker |
|
BITS Server Extensions |
BITS |
|
Connection Manager Administration Kit |
CMAK |
|
Desktop Experience |
Desktop-Experience |
|
Failover Clustering |
Failover-Clustering |
|
File Server Resource Manager |
Resource-Manager |
File Server Resource Manager is available as a feature only on the Windows Server 2008 Web Server edition. On other Windows Server 2008 SKUs, File Server Resource Manager is a role service of File Services. |
Group Policy Management |
GPMC |
|
Internet Printing Client |
Internet-Print-Client |
|
Internet Storage Naming Server |
ISNS |
|
LPR Port Monitor |
LPR-Port-Monitor |
|
Message Queuing |
MSMQ |
|
|
MSMQ-Services |
|
|
MSMQ-Server |
|
|
MSMQ-Directory |
|
|
MSMQ-Triggers |
|
|
MSMQ-HTTP-Support |
|
|
MSMQ-Multicasting |
|
|
MSMQ-Routing |
|
|
MSMQ-Win2000 |
|
|
MSMQ-DCOM |
|
Multipath I/O |
Multipath-IO |
|
Network Load Balancing |
NLB |
|
.NET Framework 3.0 Features |
NET-Framework |
Note that the command-line syntax for .NET Framework 3.0 Features does not contain the "." character before NET. |
|
NET-Framework-Core |
|
|
NET-XPS-Viewer |
|
|
NET-Win-CFAC |
|
|
NET-HTTP-Activation |
|
|
NET-Non-HTTP-Activ |
|
Peer Name Resolution Protocol |
PNRP |
|
Quality Windows Audio Video Experience |
Qwave |
|
Remote Assistance |
Remote-Assistance |
|
Remote Differential Compression |
RDC |
|
Removable Storage Manager |
Removable-Storage |
|
RPC over HTTP Proxy |
RPC-over-HTTP-Proxy |
|
Remote Server Administration 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 |
|
Remote Server Administration Tools feature administration tools |
RSAT-Feature-Tools |
|
|
RSAT-BitLocker |
|
|
RSAT-BITS-Server |
|
|
RSAT-Clustering |
|
|
RSAT-NLB |
|
|
RSAT-SMTP |
|
|
RSAT-WDS |
|
|
RSAT-WINS |
|
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. |
Simple TCP/IP Services |
Simple-TCPIP |
|
SMTP Server |
SMTP-Server |
|
SNMP Services |
SNMP-Services |
|
|
SNMP-Service |
|
|
SNMP-WMI-Provider |
|
Storage Manager for SANs |
Storage-Mgr-SANS |
|
Subsystem for UNIX-based Applications |
Subsystem-UNIX-Apps |
|
Telnet Client |
Telnet-Client |
|
Telnet Server |
Telnet-Server |
|
TFTP Client |
TFTP-Client |
|
Windows Internal Database |
Windows-Internal-DB |
|
Windows PowerShell |
PowerShell |
|
Windows Process Activation Service |
WAS |
|
|
WAS-Process-Model |
|
|
WAS-NET-Environment |
|
|
WAS-Config-APIs |
|
Windows Server Backup Features |
Backup-Features |
|
|
Backup |
|
|
Backup-Tools |
|
|
Backup-Cmdlets |
|
Windows System Resource Manager |
WSRM |
|
WINS Server |
WINS-Server |
|
Wireless Networking |
Wireless-Networking |
|
Additional references
Server Manager Technical Overview main page (https://go.microsoft.com/fwlink/?LinkId=85101).