# ftpsubaccount.exe: Additional FTP Accounts

The `ftpsubaccount.exe` utility is designed to manage additional FTP accounts. The utility allows the following operations:

- creating/deleting additional FTP accounts on subscriptions
- changing additional FTP account login credentials, hard disk quota, home directory, and user permissions

## Location

`%plesk_cli%`

## Usage

    ftpsubaccount.exe <command> [<login_name>] [
    <option 1> <param> [<option 2> <param>] ... [<option N> <param>]
    ]

## Example

The following command creates an additional FTP account for the user JohnDoe on the subscription example.com, sets password userpass for the user, sets the hard disk quota for the additional FTP account to 50 MB, specifies the `/httpdocs/` directory as the default home directory for the additional FTP account, and sets the Read permission for the user.

    plesk bin ftpsubaccount.exe --create JohnDoe -domain example.com -passwd userpass -quota 50 -access_read true

## Commands

Command | Parameter | Description | Example
--- | --- | --- | ---
`--create` or `-c` | `<login>` | Creates the additional FTP account. Requires `-domain` and `-passwd` options. | To create an additional FTP account with login name JohnDoe and password userpass on the subscription example.com:
    plesk bin ftpsubaccount.exe --create JohnDoe -passwd userpass -domain example.com
`--update` or `-u` | `<login>` | Updates a configuration of the existing additional FTP account with data specified in the options. | To change the password of additional FTP account for user with the login name JohnDoe to newpass:
    plesk bin ftpsubaccount.exe --update JohnDoe -passwd newpass
or
    plesk bin ftpsubaccount.exe -u JohnDoe -passwd newpass
`--remove` or `-r` | `<login>` | Deletes an additional FTP account for a user with a specified login name. | To delete the additional FTP account for the user with the login name JohnDoe:
    plesk bin ftpsubaccount.exe --remove JohnDoe
or
    plesk bin ftpsubaccount.exe -r JohnDoe
`--info` or `-i` | `<login>` | Displays information about a specified additional FTP account. | To view information about the additional FTP account for user with the login name JohnDoe:
    plesk bin ftpsubaccount.exe --info JohnDoe
or
    plesk bin ftpsubaccount.exe -i JohnDoe
`--help` or `-h` |  | Displays help on the use of the utility. | To view help on the use of this utility:
    plesk bin ftpsubaccount.exe --help
or
    plesk bin ftpsubaccount.exe -h

## Options

Option | Parameter | Description | Example
--- | --- | --- | ---
`-login` | `<login>` | Sets a login name for a user of an additional FTP account. | To change the login name of the additional FTP account user from JohnDoe to John:
    plesk bin ftpsubaccount.exe -u JohnDoe -login John
`-passwd` | `<password>` | Sets a password for an additional FTP account. | To change the password of the additional FTP account user JohnDoe to newpassword:
    plesk bin ftpsubaccount.exe -u JohnDoe -passwd newpassword
`-domain` | `<domain name>` | Specifies a subscription on which an additional FTP account is to be created. Required with `--create`. | To create the additional FTP account with the login name JohnDoe and password userpass on the subscription example.com:
    plesk bin ftpsubaccount.exe --create JohnDoe -passwd userpass -domain example.com
`-quota` | `<number> [B|K|M|G|T]` | Limits the amount of available disk space for an additional FTP account. Unlimited if set to `0` or a negative number. | To restrict the hard disk quota for the additional FTP account user JohnDoe to 50 megabytes:
    plesk bin ftpsubaccount.exe -u JohnDoe -quota 50M
To set the hard disk quota for the additional FTP account user JohnDoe to unlimited:
    plesk bin ftpsubaccount.exe -u JohnDoe -quota 0
or
    plesk bin ftpsubaccount.exe -u JohnDoe -quota -1
`-home` | `<home_path>` | Sets a path to the home directory for an additional FTP account. Is `/httpdocs` by default. | To set the home directory for the additional FTP account user JohnDoe to the existing directory `/httpdocs`:
    plesk bin ftpsubaccount.exe -u JohnDoe -home /httpdocs
The path is defined relative to the domain home directory path. The specified directory must exist.
`-access_read` | `true|false` | Allows or prohibits viewing the content of the home directory and download files from it. Is `false` by default. | To give read permission for the additional FTP account user JohnDoe:
    plesk bin ftpsubaccount.exe -u JohnDoe -access_read true
`-access_write` | `true|false` | Allows or prohibits creating, viewing, renaming, and deleting directories in the home directory. Is `false` by default. | To give write permission for the additional FTP account user JohnDoe:
    plesk bin ftpsubaccount.exe -u JohnDoe -access_read true