Microsoft KB Archive/317584

= HOW TO: Use Iisreset.exe and Task Scheduler to Schedule IIS to Restart in Windows 2000 =

Article ID: 317584

Article Last Modified on 10/30/2006

-

APPLIES TO


 * Microsoft Windows 2000 Server
 * Microsoft Windows 2000 Advanced Server
 * Microsoft Windows 2000 Professional Edition

-



This article was previously published under Q317584



IN THIS TASK
SUMMARY
 * Overview of Iisreset.exe
 * How to Schedule IIS to Restart
 * Troubleshooting

REFERENCES



SUMMARY
This step-by-step article describes how to use Iisreset.exe and Task Scheduler to schedule Internet Information Services (IIS) 5.0 to restart.

You can use either the IIS snap-in or the Iisreset.exe command-line utility to start, stop, and restart Internet services. If you want to schedule IIS to restart on a particular day and time, use Iisreset.exe with Task Scheduler.

back to the top

Overview of Iisreset.exe
Iisreset.exe uses the following syntax:

iisreset [ ]

NOTE: Items in [] are optional.

While iisreset will run this without arguments, you may wish to perform other functions. You can use the following parameters with Iisreset.exe:
 *  : Use this parameter to specify the computer that you want to manage. If you omit this parameter, the local computer is specified.
 * /restart: Use this parameter to stop and restart all of the running Internet services.
 * /start: Use this parameter to start all of the Internet services that are stopped.
 * /stop: Use this parameter to stop all of the running Internet services.
 * /reboot: Use this parameter to restart the computer.
 * /rebootonerror: Use this parameter to restart the computer if an error occurs after the Internet services attempt to start, stop, or restart.
 * /noforce: Use this parameter so that the Internet services do not shut down forcefully if you cannot stop the services gracefully.
 * /timeout:  Use this parameter (where  is a timeout value in seconds) to specify the time the computer waits for the Internet services to stop. After the computer stops, it restarts if you use the /rebootonerror parameter. The following list describes the default values:
 * The default value is 20 seconds if you use this parameter with /restart.
 * The default value is 60 seconds if you use this parameter with /stop.
 * The default value is 0 seconds if you use this parameter with /reboot.
 * /status: Use this parameter to display the status of all of the Internet services.
 * /enable: Use this parameter to enable the Internet services to restart.
 * /disable: Use this parameter to disable the Internet services restart process.

back to the top

How to Schedule IIS to Restart
To schedule IIS to restart on the local computer, follow these steps:  Click Start, point to Settings, and then click Control Panel. Double-click Scheduled Tasks. Double-click Add Scheduled Task, and then click Next. Click Browse, navigate to the %SystemRoot%\System32 folder, click Iisreset.exe, and then click Open. Either accept the default name that is displayed in the Type a name for this task box or type the name that you want to use. Under Perform this task, click the interval that you want to use for this task, and then click Next. If you chose to schedule a daily task, a weekly task, a monthly task, or a task that runs only one time in step 6, specify the time and the day when you want the task to run, and then click Next.</li> Type the user name and the password of a user account in which you want to run the task, and then click Next.

This account must be a member of the Administrators group. You must type the user name by using the following format, where  is the domain name and   is the user account in which you want to schedule the task:

\

</li> Click to select the Open advanced properties for this task when I click Finish check box, and then click Finish.</li> Click the Task tab.</li> At the end of the command line that is displayed in the Run box, insert a space, type /restart, and then click OK.

For example, to stop and restart IIS services on the local computer, the command line that is displayed in the Run box should look similar to the following command line, where  is the drive on which Windows is installed:

 :\winnt\system32\iisreset.exe /restart

NOTE: You can use other Iisreset.exe parameters in combination with /restart. For example, to restart the computer if an error occurs less than one minute after the Internet services attempt to start, use the /rebootonerror parameter and the /timeout:  parameter. In this scenario, the command line that is displayed in the Run box looks similar to the following command line:

 :\winnt\system32\iisreset.exe /restart /rebootonerror /timeout:60

Alternatively, if you want to schedule the computer to restart, use the /reboot parameter. In this scenario, the command line that is displayed in the Run box looks similar to the following command line:

 :\winnt\system32\iisreset.exe /reboot

</li> Verify that the new task is displayed in the Scheduled Tasks window, and then close the Scheduled Tasks window.</li></ol>

back to the top

Troubleshooting
A scheduled restart of IIS does not occur after you create the task in Task Scheduler.

This behavior can occur if the task is not configured correctly. To resolve this behavior, follow these steps:
 * 1) Click Start, point to Settings, and then click Control Panel.
 * 2) Double-click Scheduled Tasks.
 * 3) Right-click the task, click Properties, and then click the Task tab
 * 4) Verify that the correct command line is displayed in the Run box.
 * 5) Verify that the correct user account is displayed in the Run as box, and that you typed the user account in the  \  format.
 * 6) Click Set password, and then type the password again if necessary.

The Scheduled Task Wizard does not verify the password after you originally create the task. Make sure that you type the correct password for the user account.
 * 1) Verify that the Enabled (scheduled task runs at specified time) check box is selected.
 * 2) Click the Schedule tab, and then verify that the task start times and start dates are correct.
 * 3) Click OK, and then close the Scheduled Tasks window.

back to the top

<div class="references_section">