Enables you to shut down or restart local or remote computers one at a time.
For examples of how to use this command, see Examples.
Syntax
shutdown [/i | /l | /s | /r | /a | /p | /h | /e] [/f] [/m \\<ComputerName>] [/t <XXX>] [/d [p|u:]<XX>:<YY> [/c "comment"]]
Parameters
Parameter | Description | ||||
---|---|---|---|---|---|
/i |
Displays the Remote Shutdown Dialog box. The /i option must be the first parameter following the command. If /i is specified, all other options are ignored. |
||||
/l |
Logs off the current user immediately, with no time-out period. You cannot use /l with /m or /t. |
||||
/s |
Shuts down the computer. |
||||
/r |
Restarts the computer after shutdown. |
||||
/a |
Aborts a system shutdown. Effective only during the timeout period. To use /a, you must also use the /m option. |
||||
/p |
Turns off the local computer only (not a remote computer)—with no time-out period or warning. You can use /p only with /d or /f. If your computer does not support power-off functionality, it will shut down when you use /p, but the power to the computer will remain on. |
||||
/h |
Puts the local computer into hibernation, if hibernation is enabled. You can use /h only with /f. |
||||
/e |
Enables you to document the reason for the unexpected shutdown on the target computer. |
||||
/f |
Forces running applications to close without warning users.
|
||||
/m \\<ComputerName> |
Specifies the target computer. Cannot be used with the /l option. |
||||
/t <XXX> |
Sets the time-out period or delay to XXX seconds before a restart or shutdown. This causes a warning to display on the local console. You can specify 0-600 seconds. If you do not use /t, the time-out period is 30 seconds by default. |
||||
/d [p|u:]<XX>:<YY> |
Lists the reason for the system restart or shutdown. The following are the parameter values: p Indicates that the restart or shutdown is planned. u Indicates that the reason is user defined.
XX Specifies the major reason number (positive integer less than 256). YY Specifies the minor reason number (positive integer less than 65536). |
||||
/c "<Comment>" |
Enables you to comment in detail about the reason for the shutdown. You must first provide a reason by using the /d option. You must enclose comments in quotation marks. You can use a maximum of 511 characters. |
||||
/? |
Displays help at the command prompt, including a list of the major and minor reasons that are defined on your local computer. |
Remarks
- Users must be assigned the Shut down the system user
right to shut down a local or remotely administered computer that
is using the shutdown command.
- Users must be members of the Administrators group to annotate
an unexpected shutdown of a local or remotely administered
computer. If the target computer is joined to a domain, members of
the Domain Admins group might be able to perform this procedure.
For more information, see:
- Default local groups
- Default groups.
- Default local groups
- If you want to shut down more than one computer at a time, you
can call shutdown for each computer by using a script, or
you can use shutdown /i to display the Remote
Shutdown Dialog box.
- If you specify major and minor reason codes, you must first
define these reason codes on each computer where you plan to use
the reasons. If the reason codes are not defined on the target
computer, Shutdown Event Tracker cannot log the correct reason
text.
- Remember to indicate that a shutdown is planned by using the
p: parameter. Omitting p: indicates that a shutdown
is unplanned. If you type p: followed by the reason code for
an unplanned shutdown, the command will not carry out the shutdown.
Conversely, if you omit p: and type in the reason code for a
planned shutdown, the command will not carry out the shutdown.
Examples
To force applications to close and restart the local computer after a one-minute delay with the reason "Application: Maintenance (Planned)" and the comment "Reconfiguring myapp.exe" type:
shutdown /r /t 60 /c "Reconfiguring myapp.exe" /f /d p:4:1
To restart the remote computer \\ServerName with the same parameters, type:
shutdown /r /m \\servername /t 60 /c "Reconfiguring myapp.exe" /f /d p:4:1