Managing hosts from the command line

You can add, modify or delete hosts using the host command line utility, iftpaddh.exe.

To start the Add Host Utility:

  1. From the Windows desktop, select Start > Run. The Run dialog appears.
  2. Enter cmd.exe and click OK.
  3. Change the directory to the WS_FTP Server directory. For a default installation, this should be C:\Program Files\Ipswitch\WS_FTP Server\.
  4. For a list of command options, enter iftpaddh /?.

Basic Command Syntax

The basic syntax for adding, modifying and removing a host is indicated below.

Adding a Host

iftpaddh -add hostname [options]

Modifying a Host

iftpaddh -mod hostname [options]

Deleting a Host

iftpaddh -kill hostname

Note: All arguments are case-sensitive and must be supplied as lower case.

Note: iftpaddh will fail if you do not have an active license. (Use the ipsactive command to launch the licensing application and enter your serial number.)

Arguments

When to use

-add hostname

Use to create a new host. Specify a name for the new host after -add.

-mod hostname

Use to modify a host. You must specify a host name after -mod.

-kill hostname

Use to delete a host. You must specify a host name after -kill.

-l ip_address:port:protocol

Use to specify a listener to associate with the host. You must specify the IP address, port and protocol for the listener you want to associate with the host. To use a listener listening on all IP addresses, enter 0.0.0.0 as the IP address.

Note:If you enter SSH as your protocol, you must have a valid license that includes SSH support.

-d directory

Use to specify the top folder of the host. If a folder is not specified, the server will create a subfolder with the same name as the new host under the top folder of the server.

-t number

Use to specify the server time-out. The default is 600 seconds.

-mu number

Use to specify the maximum number of concurrent users. The default is 1000.

-i address

Use to specify the host IP address.

-ma number

Use to specify the number of maximum concurrent anonymous users. The default is 200.

+anon

Allow anonymous connections.

-anon

Disable anonymous connections.

+hide

Use to hide files and folders whose names begin with the dollar sign ($).

-hide

Use to show files and folders whose names begin with the dollar sign ($).

+lt

Use the server's local time instead of Greenwich Mean Time (GMT).

-lt

Use GMT instead of the server's local time.

+ext

Enable extended commands for the host (such as FEAT, HOST, LANG, MDTM, MLST, OPTS, XAUT, AUTH SSL and AUTH TLS).

-ext

Disable extended commands for the host (such as FEAT, HOST, LANG, MDTM, MLST, OPTS, XAUT, AUTH SSL and AUTH TLS).

+tpt

Allow third-party transfers.

-tpt

Disable third-party transfers.

-rd

Use to delete all files and folders associated with the host. By default, all files and folders remain when a host is removed.