Home > Commands A-M > Commands B

BOOTCFG /EMS


Description | Syntax | Parameters | Switches | Related | Notes | Examples | Errorlevels | Availability

Configures, queries, or changes Boot.ini file settings.

Enables the user to add or change the settings for redirection of the EMS console to a remote computer. By enabling EMS, you add a "redirect=Port#" line to the [boot loader] section of the BOOT.INI file and a /redirect switch to the specified operating system entry line. The EMS feature is enabled only on servers.


Syntax

BOOTCFG /ems /?

BOOTCFG /ems [EDIT | OFF | ON] [/s [computer] [/u [[domain\]user] /p password [/baud baud_rate] [/port communications_port] /id line_number


Parameters
EDIT (NTXP)
Allows changes to port and baud rate settings by changing the redirect=COMx setting in the [bootloader] section. The value of COMx is set to the value of the /port.
OFF (NTXP)
Disables output to a remote computer. Removes the /redirect switch from the specified line_number and the redirect=comX setting from the [boot loader] section.
ON (NTXP)
Enables remote output for the specified line_number. Adds a /redirect switch to the specified line_number and a redirect=comX setting to the [boot loader] section. The value of comX is set by the /port.

Switches
/? (NTXP)
Display help.
/ems (NTXP)
Enables the user to add or change the settings for redirection of the EMS console to a remote computer. By enabling EMS, you add a "redirect=Port#" line to the [boot loader] section of the BOOT.INI file and a /redirect switch to the specified operating system entry line. The EMS feature is enabled only on servers.
/baud baud_rate (NTXP)
Specifies the baud rate to be used for redirection. Do not use if remotely administered output is being disabled.
/id line_number (NTXP)
Specifies the operating system entry line number in the [operating systems] section of the Boot.ini file to which the operating system load options are added. The first line after the [operating systems] section header is 1.
/p password (NTXP)
Specifies the password of the user account that is specified in /u.
/port communications_port (NTXP)
Specifies the COM port to be used for redirection. Do not use if remotely administered output is being disabled.
/s computer (NTXP)
Specifies the name or IP address of a remote computer (do not use backslashes). The default is the local computer.
/u [[domain\]user] (NTXP)
Runs the command with the account permissions of the user specified by User or Domain\User. The default is the permissions of the current logged on user on the computer issuing the command.

Related

BOOTCFG /ADDSW Adds BOOT.INI load options.
BOOTCFG /COPY Makes another operating system instance copy.
BOOTCFG /DBG1394 Configures 1394 port debugging.
BOOTCFG /DEBUG Adds or changes the debug settings.
BOOTCFG /DEFAULT Designate the default operating system entry.
BOOTCFG /DELETE Deletes an operating system entry.
BOOTCFG /QUERY Displays the [boot loader] and [operating systems] sections.
BOOTCFG /RAW Adds load options to an [operating systems] entry.
BOOTCFG /RMSW Removes BOOT.INI load options.
BOOTCFG /TIMEOUT Changes the operating system time-out value.


Notes

none.


Examples
    bootcfg /ems ON /port com1 /baud 19200 /id 2

    bootcfg /ems ON /port biosset /id 3

    bootcfg /s srvmain /ems OFF /id 2

    bootcfg /ems EDIT /port com2 /baud 115200

    bootcfg /s srvmain /u maindom\hiropln /p p@ssW23 /ems OFF /id 2

Errorlevels

none.


Availability
External
DOS
v3.0 v3.20 v3.05 v3.1 v3.21 v3.25 v3.30 v3.3A v3.3R v3.3T v3.31 v3.40 v4.0 v4.01 v4.01A v5.0 v5.0A v5.00.02 v5.001A v5.01 v5.02 v6.0 v6.10 v6.2 v6.21 v6.22 v6.23 v7.00 v7.0R1 v7.10 v8.00
Windows
Win95 Win98 WinME
Windows NT
NT3.5 NT4 NT2000 NTXP NT2003

Last Updated: 2003/07/28
Direct corrections or suggestions to: Rick Lively