Schedules commands and programs to run on a computer at a specified time and date. You can useat only when the Schedule service is running. Used without parameters,at lists scheduled commands. You must be a member of the local Administrators group to run this command.

Syntax

at [\computername] [[id] [/delete] | /delete [/yes]]at [\computername] <time> [/interactive] [/every:date[,...] | /next:date[,...]] <command>

Parameters

Remarks

• This command doesn't automatically load cmd.exe before running commands. If you're not running an executable (.exe) file, you must explicitly load cmd.exe at the beginning of the command as follows:

  cmd /c dir > c:\test.out

• If using this command without command-line options, scheduled tasks appear in a table formatted similar to the following:

  Status  ID   Day        time        Command LineOK      1    Each F     4:30 PM     net send group leads status dueOK      2    Each M     12:00 AM    chkstor > check.fileOK      3    Each F     11:59 PM    backup2.bat

• If including an identification number (ID) with this command, only information for a single entry appears in a format similar to the following:

  Task ID: 1Status: OKSchedule: Each  FTime of Day: 4:30 PMCommand: net send group leads status due

• After you schedule a command, especially a command that has command-line options, check that the command syntax is correct by typingat without any command-line options. If the information in theCommand Line column is wrong, delete the command and retype it. If it's still incorrect, retype the command using fewer command-line options.

• Commands scheduled withat run as background processes. Output is not displayed on the computer screen. To redirect output to a file, use the redirection symbol>. If you redirect output to a file, you need to use the escape symbol^ before the redirection symbol, whether you are usingat at the command line or in a batch file. For example, to redirect output tooutput.txt, type:

  at 14:45 c:\test.bat ^>c:\output.txt

  The current directory for the executing command is the systemroot folder.

• If you change the system time after you schedule a command to run, synchronize theat scheduler with the revised system time by typingat without command-line options.

• Scheduled commands are stored in the registry. As a result, you don't lose scheduled tasks if you restart the Schedule service.

• Do not use a redirected drive for scheduled jobs that access the network. The Schedule service might not be able to access the redirected drive, or the redirected drive might not be present if a different user is logged on at the time the scheduled task runs. Instead, use UNC paths for scheduled jobs. For example:

  at 1:00pm my_backup \\server\share

  Do not use the following syntax, wherex: is a connection made by the user:

  at 1:00pm my_backup x:

  If you schedule anat command that uses a drive letter to connect to a shared directory, include anat command to disconnect the drive when you are finished using the drive. If the drive is not disconnected, the assigned drive letter won't be available at the command prompt.

• By default, tasks scheduled using this command will stop after 72 hours. You can modify the registry to change this default value.

  To modify the registry

  Caution

  Incorrectly editing the registry may severely damage your system. Before making changes to the registry, you should back up any valued data on the computer.

  1. Start the registry editor (regedit.exe).

  2. Locate and click the following key in the registry:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Schedule

  3. On theEdit menu, clickAdd Value, and then add the following registry values:

     • Value Name. atTaskMaxHours

     • Data type. reg_DWOrd

     • Radix. Decimal

     • Value Data: 0. A value of0 in theValue Data field indicates no limit and doesn't not stop. Values from 1 through 99 indicates the number of hours.

• You can use the Scheduled Tasks folder to view or modify the settings of a task that was created by using this command. When you schedule a task using this command, the task is listed in the Scheduled Tasks folder, with a name such as the following:at3478. However, if you modify a task through the Scheduled Tasks folder, it's upgraded to a normal scheduled task. The task is no longer visible to theat command, and the at account setting no longer applies to it. You must explicitly enter a user account and password for the task.

Examples

To display a list of commands scheduled on the Marketing server, type:

at \\marketing

To learn more about a command with the identification number 3 on the Corp server, type:

at \\corp 3

To schedule a net share command to run on the Corp server at 8:00 A.M. and redirect the listing to the Maintenance server, in the Reports shared directory, and the Corp.txt file, type:

at \\corp 08:00 cmd /c net share reports=d:\marketing\reports >> \\maintenance\reports\corp.txt

To back up the hard drive of the Marketing server to a tape drive at midnight every five days, create a batch program called Archive.cmd, which contains the backup commands, and then schedule the batch program to run, type:

at \\marketing 00:00 /every:5,10,15,20,25,30 archive

To cancel all commands scheduled on the current server, clear theat schedule information as follows:

at /delete

To run a command that is not an executable (.exe) file, precede the command withcmd /c to load cmd.exe as follows:

cmd /c dir > c:\test.out

Related links

• Command-Line Syntax Key

• schtasks. Another command-line scheduling tool.