Shutdown

Allows you to shut down or restart a local or remote computer. Used without parameters, shutdown will logoff the current user.

Syntax

shutdown [{-l|-s|-r|-a}] [-f] [-m [\\ComputerName]] [-t xx] [-c "message"] [-d[u][p]**:xx:**yy]

Parameters

-l   : Logs off the current user, this is also the defualt. -m ComputerName takes precedence.

-s : Shuts down the local computer.

-r   : Reboots after shutdown.

-a   : Aborts shutdown. Ignores other parameters, except -l and ComputerName. You can only use -a during the time-out period.

-f   : Forces running applications to close.

-m [ \\ ComputerName ] : Specifies the computer that you want to shut down.

-t   xx   : Sets the timer for system shutdown in xx seconds. The default is 20 seconds.

-c   " message "   : Specifies a message to be displayed in the Message area of the System Shutdown window. You can use a maximum of 127 characters. You must enclose the message in quotation marks.

-d [ u ][ p ] : xx : yy   : Lists the reason code for the shutdown. The following table lists the different values.

Value

Description

u

Indicates a user code.

p

Indicates a planned shutdown code.

xx

Specifies the major reason code (0-255).

yy

Specifies the minor reason code (0-65536).

/?   : Displays help at the command prompt.

Remarks

  • If you indicate a major and minor reason code, you must first define these reason codes on each computer for which you plan to use the particular reason. If the reason codes are not defined on the target computer, Event Viewer cannot log the correct reason text.

Examples

To shut down \\MyServer in 60 seconds, force running applications to close, restart the computer after shutdown, indicate a user code, indicate that the shutdown is planned, log major reason code 125, and log minor reason code 1, type:

shutdown -r -f -m \\MyServer -t 60 -d up:125:1

Formatting legend

Format

Meaning

Italic

Information that the user must supply

Bold

Elements that the user must type exactly as shown

Ellipsis (...)

Parameter that can be repeated several times in a command line

Between brackets ([])

Optional items

Between braces ({}); choices separated by pipe (|). Example: {even|odd}

Set of choices from which the user must choose only one

Courier font

Code or program output

Shutdown Event Tracker

Command-line reference A-Z