This service template runs commands stored on a server and outputs the results.
Service Definition Properties
The following table lists the properties shown in the Service Definition and Submit Service windows for the Execute Remote Command service template.
| Property Key | Property Name | Description | Required or optional |
|---|---|---|---|
| common.targetHost | Host name of target server | Specifies the host name or IP address of the target server. IPv6 addresses are not supported. | R |
| common.remoteCommand | Command | Specify the full path of the command to run on the target server. If the path contains a space, enclose the entire path in double quotation marks. | R |
| common.remoteCommandParameter | Command parameters | Specify the parameters for the command to run on the target server. If a parameter contains a space, enclose the entire parameter in double quotation marks. | O |
Note: Although some of the properties in the tables indicate that they can be omitted, they might be required when used in conjunction with some other property setting as indicated in the descriptions.
Usage guidelines
- If the standard output result of the command exceeds 100 KB, the service ends abnormally.
- Up to 1,024 characters of the standard output result of the command are stored in property common.stdoutProperty; any output more than this is discarded.
- Interactive commands and scripts that need user input and commands that do not end automatically using a UI display or similar input cannot be run.
- If the OS running on the target server is Linux, the command is run in the default locale defined in the agentless-connection target for the connected user.
Server requirements
To use this service template, the following servers are needed:
- Target server: This is the server on which a supported version of Windows-based OS or Linux OS is installed. The commands must already be stored on the server.