Server Connection Parameters

The way the prlctl utility connects to the Parallels server depends on the parameters passed to the utility during its execution:

If no connection parameters are specified, prlctl assumes that the command is run on the local server. In this case the utility has the following syntax:
prlctl command [< ID | name >] [ options ]
If you specify a user name but omit the server parameters, prlctl will run the command on the local server on behalf of the specified user. In this case it has the following syntax:
prlctl command [< ID | name >] [ options ] -l user
If you specify the appropriate user credentials and server parameters (i.e. the server IP address or hostname and, if necessary, the port number), prlctl will establish a connection to the specified remote server, log in to this server using the indicated user credentials, and run the command on the remote server. In this case the utility has the following syntax:
prlctl command [< ID | name >] [ options ][-l user : passwd @ server

prlctl command [< ID | name >] [ options ] -p path -l user @ server

The full list of server connection parameters that can be used with prlctl is presented in the following table:

Parameter Name	Description
`-l, --login`	Sets the login parameters for `prlctl` to connect to a remote Parallels server or defines the user on behalf of which the command is to be run on the local Parallels server.
`user`	The name of the user: to log in to a remote Parallels server (if the server parameters are specified); on behalf of which the command is to be run on the local Parallels server (if the server parameters are omitted).
`passwd`	The password for accessing the remote Parallels server.
`-p, --read-passwd` `path`	The path to the file containing the password for accessing the remote Parallels server.
`server`	The IP address or hostname of the remote Parallels server.
`-v, --verbose` `number`	Sets the verbosity level for the executed command. The greater number you specify, the more verbose output the command will produce.