Reference Guide › AutoShell › AutoShell Core Reference › General AutoShell Commands › run-client Command--Run the Autoshell Client on a Remote Windows System (Funclet)

run-client Command--Run the Autoshell Client on a Remote Windows System (Funclet)

The run-client command (funclet) runs the AutoShell client on a remote Windows system. Input and output are redirected to the calling AutoShell.

The command has the following syntax:

run-client -host hostname [-user username>] [-pass password]

The command returns true or false.

-host hostname

Specifies the name of the remote Windows host. Unquoted argument tokens are automatically stringified. Prevent automatic quoting for expressions by placing expression code in parenthesis.

-user username

(Optional) Specifies the user name to log on to the remote Windows system. The user must have rights to connect to the $ADMIN share. If no user name is specified, the user name entered during AutoShell login is used. Unquoted argument tokens are automatically stringified. Prevent automatic quoting for expressions by placing expression code in parenthesis.

Default: $$User

-pass password

(Optional) Specifies password to use to log in to the remote node. If no password is specified, the password entered during AutoShell login is used. To enter a hidden password after issuing this command, specify PW_GET() with an optional prompt as argument. Unquoted argument tokens are automatically stringified. Prevent automatic quoting for expressions by placing expression code in parenthesis.

Default: $$Pass

Example

To run the AutoShell client on host1.

run-client -host host1

See also:

push-client Command--Install the Autoshell Client on a Remote Windows System (Funclet)

push-winRemote Command--Copy and Execute on Multiple Remote Windows Systems (Funclet)

rem-client Command--Remove the Autoshell Client from a Remote Windows System (Funclet)

run-winRemote Command--Execute a Command on Multiple Remote Windows Systems (Funclet)