|
Advanced Task Scheduler comes with a command line task execution tool. You can create
tasks in the "Shortcut properties" window as well as use this tool.
The command line tool is located in the Advanced Task Scheduler installation folder and is
called advscheduler_procmd.exe (Professional Edition) or advscheduler_bsccmd.exe (Basic
Edition). It is recommended to run the command line tool from this folder only (do not copy
it to other folders).
Command line:
[--Execute [-lang langid] [-type [logstdout | processuser | currentuser | localsystem |
logonuser [-username user_name] [-password password] | passwordless [-username
user_name]] [-exefile exe_file] [-cmdline cmd_line] [-cmdshow [hidden | normal |
maximized | minimized | normalnoactive | minimizednoactive]] [-startin path] [-terminate
sec] [-desktop desktop_name]]
[--Message [-lang langid] [-type [popup | layered | balloon]] [-title title] [-time time] [-text
message] [-snd sound_file] [-bg background_image_file] [-nobuttons]]
[--Service [-lang langid] [-type [start | stop | pause | continue]] [-name name] [-startargs
startargs]]
[--KillProcess [-lang langid] [-user user_name] [-image image_file] [-anyway] [-restore]
[-list]]
[--KillWindow [-lang langid] [-user user_name] [-caption window_caption] [-begins]
[-contains] [-anyway] [-restore] [-list]]
[--RasDial [-lang langid] [-name entry_name] [-auth username password] [-authbase64
username_password] [-attempts number_of_attempts] [-nostatus]]
[--RasHangUp [-lang langid] [-name entry_name]]
[--PlaySound [-lang langid] [-device device_name] [-sound sound_file]]
[--TurnOff [-lang langid] [-type [turnoff | standby | hibernate | reboot | logoff | monitor]]
[-logoff [user_name]]]
[--SendMessage [-lang langid] [-computer computer_name] [-msg message]]
[--SendEMail [-lang langid] [-email email_address] [-server server[:port]]
[-starttls] [-auth username password] [-authbase64 username_password]
[-sender sender_address] [-subject subject] [-msg message]
[-ctype content-type] [-charset charset] [-attach attach_file]
[-attachmsg message]]
[--SendKeys [-lang langid] [-caption window_caption] [-begins] [-contains] [-sequence
sequence]]
[--HTTP [-lang langid] [-url url] [-file file_name] [-overwrite] [-head] [-auth username
password] [-authbase64 username_password] [-POST post_data] [-proxy server[:port]]
[-proxytype [HTTP | SOCKS5]] [-proxyauth username password] [-proxyauthbase64
username_password] [-useragent useragent]]
[--FTP [-lang langid] [-upload | -download] [-folder | -file] [-remote remote_dir_or_file]
[-local local_dir_or_file] [-filemask file_mask] [-overwrite] [-passive][-auth username
password] [-authbase64 username_password] [-proxytunnel server[:port]] [-proxyauth
username password] [-proxyauthbase64 username_password]]
[--File [filename]] [--Pipe [pipename]] [--StdIn] - read command line from a file, a pipe or
standard input.
--Execute
-lang - langid (see below);
-type - type of execution
logstdout - the application will be started with redirected stdin and application's
stdout and stderr will be captured. If application is a 16-bit DOS application or a batch
file, it will be executed via the command processor;
processuser - run application as this process user (default);
currentuser - run application as currently logged on user;
localsystem - run application under LocalSystem account. To run an application under
LocalSystem account, the command line tool must be started under the system or administrator account;
logonuser - logon user (-username and -password are required).
The specified username and password will be used for executing the application. To run an application on
behalf of the specified user, the command line tool must be started under the system or
administrator account. The account must have the following privileges: "Act as part of the
operating system" (SeTcbPrivilege), "Replace a process-level token"
(SeAssignPrimaryTokenPrivilege), "Adjust memory quotas for a process"
(SeIncreaseQuotaPrivilege, may be named "Increase memory quotas" or "Increate quotas" in
Windows 2000 and NT 4.0), "Bypass traversy checking" (SeChangeNotifyPrivilege) and
"Debug programs" (SeDebugPrivilege). You can modify user privileges in Control Panel |
Administrative tools | Local Security Policy | User Rights Assignment;
passwordless - use passwordless authorization (-username is required).
You can use passwordless authorization, but you must make sure that the command line tool is running
under the system or administrator account. The account must have the following privileges:
"Act as part of the operating system" (SeTcbPrivilege), "Replace a process-level token"
(SeAssignPrimaryTokenPrivilege), "Adjust memory quotas for a process"
(SeIncreaseQuotaPrivilege, may be named "Increase memory quotas" or "Increate quotas" in
Windows 2000 and NT 4.0), "Bypass traversy checking" (SeChangeNotifyPrivilege),
"Debug programs" (SeDebugPrivilege) and "Create a token object"
(SeCreateTokenPrivilege). You can modify user privileges in Control Panel | Administrative
tools | Local Security Policy | User Rights Assignment. Windows Vista and later: the
command line tool must be running only under administrator account. Starting from this
Windows version, the system account doesn't have the SeCreateTokenPrivilege privilege.
This option is available only in Professional Edition;
-username - SAM-Account-Name or textual SID;
-password - account password;
-exefile - the name of the module to be executed;
-cmdline - the command line to be executed;
-startin - the starting directory;
-cmdshow - the window show state;
-terminate - number of seconds to terminate started application;
-desktop - the name of the desktop (Default: WinSta0\Default).
--Message
-lang - langid (see below);
-type - type of the message window (popup window, transparent window near task bar or
balloon tooltip);
-title - title of the message window;
-time - message start time;
-text - message text;
-snd - sound file to play when message window is displayed;
-bg - image file (.bmp, .gif or .jpg ) for the window background (only for the message
popup window);
-nobuttons - show only OK button (only for the message popup window).
--Service
-lang - langid (see below);
-type - type of operation with service (start, stop, pause or continue);
-name - name of the service;
-startargs - argument strings passed to a service (start only).
--KillProcess
-lang - langid (see below);
-user - SAM-Account-Name or textual SID of the user whose processes may be killed.
Use "*" for all users. If omitted, current user's name will be used. This option is available
only on the NT based platforms;
-image - process image file (name of the executable file of the process or full path and
executable file name). Wildcards ("*" and "?" are accepted);
-anyway - kill process without giving it chance to save data;
-restore - if the window is minimized, restore it before process is killed. If the window
is displaying the prompt for saving unsaved data and the option "-restore" is not selected, the
application's button on the taskbar will blink. When the option is selected, the application
window will be restored, and the prompt for saving unsaved data will be sent to foreground;
-list - list all found processes.
Note: If the option "-anyway" is selected, Advanced Task Scheduler can terminate only
those processes, which have their own windows. If a process does not have its own window,
it can be terminated only when the option "-anyway" is selected.
--KillWindow
-lang - langid (see below);
-user - SAM-Account-Name or textual SID of the user whose windows may be killed.
Use "*" for all users. If omitted, current user's name will be used. This option is available
only on the NT based platforms;
-caption - window caption text;
-begins - window caption must begin with the specified text;
-contains - window caption must contain the specified text;
-anyway - kill process without giving it chance to save data;
-restore - if the window is minimized, restore it before process is killed. If the window
is displaying the prompt for saving unsaved data and the option "-restore" is not selected, the
application's button on the taskbar will blink. When the option is selected, the application
window will be restored, and the prompt for saving unsaved data will be sent to foreground;
-list - list all found processes.
Terminal Services: only windows that are running on the same terminal session as this
program will be killed.
--RasDial
-lang - langid (see below);
-name - name of the Network Connection;
-auth - username and password for the specified connection. If omitted, the connection
information saved by the last successful connection will be used;
-authbase64 - base64 encoded username and password, tab delimited;
-attempts - number of attempts to establish the connection;
-nostatus - do not display connection window (background connection).
--RasHangUp
-lang - langid (see below);
-name - name of the Network Connection.
"*" means all established connections.
--PlaySound
-lang - langid (see below);
-device - name of the sound device.
If omitted, the default device will be used;
-sound - sound file.
--TurnOff
-lang - langid (see below);
-type - type of operation (turnoff, standby, hibernate,
reboot, logoff or monitor);
-logoff - SAM-Account-Name of the user to log off. "*" means all users.
If omitted, current user's name will be used. This option is available only on the NT based
platforms;
Terminal Services: To be able to log off another user's session, you need to have the Query
Information and Reset permissions. To modify permissions on a session, use the Terminal
Services Configuration administrative tool.
--SendMessage
-lang - langid (see below);
-computer - name of the computer;
-msg - message text.
--SendEMail
-lang - langid (see below);
-email - email address. Several email addresses can be separated by comma or semicolon;
-server - SMTP server name and port number;
-starttls - Use SSL secure connection;
-auth - username and password for SMTP server;
-authbase64 - base64 encoded username and password, tab delimited;
-sender - email address of the sender;
-subject - message subject;
-ctype - Content-Type of the message;
-charset - Charset of the message. If charset is omitted, the message is sent in utf-8 format;
-msg - message text;
-attach - file to send as attachment;
-attachmsg - message to send as attachment.
--SendKeys
-lang - langid (see below);
-caption - window caption text;
-begins - window caption must begin with the specified text;
-contains - window caption must contain the specified text;
-sequence - keys sequence to send (for more information, visit
http://www.advscheduler.com/docs/manual/type_sendkeys.htm).
Terminal Services: keys may be send only to the windows that are running on the same
terminal session as this program.
Windows Vista and later: keys cannot be send to the windows that are running with higher privileges
than this program.
--HTTP
-lang - langid (see below);
-url - URL to download (examples: http://www.advscheduler.com/index.html,
https://www.paypal.com/, http://user:passwd@domain.name/index.php3);
-file - file name to store downloaded file;
-overwrite - overwrite already existing file;
-head - use HEAD method to get only HTTP headers;
-auth - username and password for HTTP authorization;
-authbase64 - base64 encoded username and password, tab delimited;
-POST - the full data to post in an HTTP POST operation (for example,
"postvar1=value1&postvar2=value2&postvar3=value3"). You must make sure that the data
is formatted the way you want the server to receive it. Most web servers will assume this
data to be url-encoded. This POST is a normal application/x-www-form-urlencoded kind,
which is the most commonly used one by HTML forms;
-proxy - proxy server address and port number;
-proxytype - type of the proxy server (HTTP or SOCKS4);
-proxyauth - username and password for the proxy server;
-proxyauthbase64 - base64 encoded username and password, tab delimited;
-useragent - user-agent name.
--FTP
-lang - langid (see below);
-upload - upload file(s) to remote directory;
-download - download file(s) from remote directory;
-folder - upload/download a directory;
-file - upload/download a file;
-remote - URL and remote directory or file name to download or upload (examples:
ftp://ftp.funet.fi/, ftps://user:passwd@domain.name/,
ftps://user:passwd@domain.name/readme.txt);
-local - local directory or file to download or upload;
-filemask - name (or wildcard) of file(s) to upload or download (folder only);
-overwrite - overwrite already existing file(s);
-passive - use passive mode (like WWW browsers);
-auth - username and password for FTP authorization;
-authbase64 - base64 encoded username and password, tab delimited;
-proxytunnel - tunneling proxy server address and port number;
-proxyauth - username and password for the proxy server;
-proxyauthbase64 - base64 encoded username and password, tab delimited.
--file
Command line will be read from the specified file. Output will be sent to stdout. If
command line is in Unicode Little Endian charset, the file must begin with "0xFF
0xFE".
--pipe
Command line will be read from the specified named pipe (for example,
\\.\pipe\\mypipename). Output will be sent to the same named pipe. Command line must be
terminated with the new line character "\n" (0x0A). If command line is in Unicode Little
Endian charset, it must begin with "0xFF 0xFE".
--stdin
Command line will be read from stdin. Output will be sent to stdout. Command line must be
terminated with the new line character "\n" (0x0A). If command line is in Unicode Little
Endian charset, it must begin with "0xFF 0xFE".
If an argument contains spaces it must be enclosed in the quotes (").
Formats like "&0xhhhh;" are accepted, so to pass a quote mark, use "&0x22;". Note that
"hhhh" is a hexadecimal value of a Unicode character.
Use -h or --help option to display help information.
Use -l or --lang option to display language identifiers (langid).
|