ipmanage.exe: IP Addresses
The ipmanage.exe
utility serves to manage Plesk IP addresses. This utility allows the following:
- registering IP addresses in Plesk database
- removing IP addresses from Plesk database
- assigning an SSL certificate to an IP
- changing a network interface for an IP
- viewing a list of available IP addresses, SSL certificates, and interfaces
Location
%plesk_cli%
Usage
ipmanage.exe <command> [<IP>] [
<option 1> <param> [<option 2> <param>] ... [<option N> <param>]
]
Example
The following command creates IP address 192.0.2.10 with a subnet mask 255.255.255.0, sets the Local Area Connection interface for it, makes this IP address exclusive (available for using by only one client), and assigns the SSL certificate called My certificate to the IP.
ipmanage.exe --create 192.0.2.10 -mask 255.255.255.0 -interface "\"Local Area Connection"\" -type exclusive -ssl_certificate "My certificate<code>"</code>
Commands
Command | Parameter | Description | Example |
---|---|---|---|
|
|
Creates an IP address in Plesk database. Requires |
See Example above. |
|
|
Changes IP address properties. |
To change IP 192.0.2.123 type to exclusive: ipmanage.exe --update 192.0.2.123 -type exclusive |
|
|
Removes an IP address from Plesk database. |
To remove IP 192.0.2.123: ipmanage.exe --remove 192.0.2.123 |
|
|
Rereads the IP addresses. |
To reread the IP addresses: ipmanage.exe --reread |
|
|
Outputs the list of existing IP addresses. |
To view the list of existing IP addresses: ipmanage.exe --ip_list |
|
|
Outputs the list of available SSL certificates. |
To view the list of available SSL certificates: ipmanage.exe --ssl_list |
|
|
Outputs the list of available network interfaces. |
To view the list of available network interfaces: ipmanage.exe --inter_list |
|
|
Displays information about all available IP address in the XML format. |
To view information about all available IP addresses in the XML format: ipmanage.exe --xml-info or ipmanage.exe -xi |
|
|
Specifies a default SSL certificate to all available IP addresses. |
To set default SSL certificate to all available IP addresses: ipmanage.exe --reset_ssl_certificate |
|
|
Defines whether to perform the automatic mapping of IP addresses on Plesk startup. Use the option in cases when the registered IP addresses are changed (for example, when cloning a VPS with Plesk). |
To enable automatic mapping of IP addresses on Plesk startup: ipmanage.exe --auto-remap-ip-addresses |
|
|
Reassigns the IP address. |
To reassign the IP 192.168.1.2 to 192.168.1.3: ipmanage.exe --change-ip 192.168.1.2 -mask 255 .255.255.0 -interface "\"Local Area Connection"\" -ip 192.168.1.3 |
|
|
Outputs help on the utility use. |
ipmanage.exe --help |
Options
Option | Parameter | Description | Example |
---|---|---|---|
|
|
Defines the IP address type: an exclusive IP can be used by only one client, a shared IP can be used by many clients. Required with |
To change IP 192.0.2.123 type to exclusive: ipmanage.exe -u 192.0.2.123 -type exclusive |
|
|
Specifies a name of SSL certificate to be used for the IP. Required with |
To assign a default certificate to IP 192.0.2.1: ipmanage.exe -u 192.0.2.1 -ssl_certificate "Default Certificate" |
|
|
Specifies the IP subnet mask. Used with Required with |
To create an IP with 24-bit mask see Example above. |
|
|
Specifies the name of the physical network interface. Used with Required with |
To create an IP for the network interface "Local Area Connection" see Example above. |
|
|
Allows\prohibits using FTPS, i.e., accessing FTP associated with the IP over SSL. |
To allow FTPS on IP 192.0.2.1: ipmanage.exe -u 192.0.2.1 -ftps true |
|
|
Maps an internal IP to a public one to create NAT. Used with the |
To map an internal IP 192.168.1.2 to a public IP 92.68.1.2: # ./ipmanage -u # ./ipmanage -u -public_ip 92.68.1.2 |
|
|
Maps the target IP address. |
To reassign the IP 192.168.1.2 to 192.168.1.3: ipmanage.exe --change-ip 192.168.1.2 -mask 255 .255.255.0 -interface "\"Local Area Connection"\" -ip 192.168.1.3 |
Notes
- It is preferable that the name of the SSL certificate is specified as a double-quoted string. If the name of the SSL certificate contains spaces, double quotes are mandatory.
- The name of the network interface must be specified as a double-quoted string. If the name of the network interface contains spaces, then it must be enclosed with
"\"
characters.
For example, the default name for the network adapter used in Windows is Local Area Connection. To specify it, use the following format:
-interface "\"Local Area Connection"\"