Impact Acquire SDK GUI Applications
Command-line Interface

IPConfigure supports various command-line parameters to allow various IP setup related configurations without the need of user interaction.

The following table lists the available command-line parameters:

Parameter Description
device or d Selects a serial number of a device for configuration.
forceAutoConfigureDHCP or facd Configures devices using misconfigured IP addresses connected to the adapter specified by a wildcard to use DHCP mode. If no wildcard is specified every detected misconfigured device will be configured to use DHCP mode. (syntax: <Adapter IP address wildcard>).
forceAutoConfigurePersistent or facp Assigns automatically a persistent IP address to devices connected to the adapter specified by a wildcard. If no wildcard is specified every misconfigured device will set up for a persistent IP address. (syntax: <Adapter IP address wildcard>).
hidden Will start the application without showing the splash screen or the application window. This might be useful when doing a silent configuration in combination with the 'quit' parameter.
log_file='file_name' or lf='file_name' Specifies a log file storing the content of this text control upon application shutdown.
persistentIPAddress Defines a persistent IP address for the device currently selected(value syntax: <interface index>;<value>).
persistentSubnetMask Defines a persistent subnet mask for the device currently selected(value syntax: <interface index>;<value>).
persistentDefaultGateway Defines a persistent default gateway for the device currently selected(value syntax: <interface index>;<value>).
quit or q Terminates the application automatically after all the configuration has been applied.
useDHCP Enables/disables the usage of DHCP for the device currently selected(value syntax: <interface index>;<value>).
userDefinedName or udn Sets a user defined name for the device currently selected.
usePersistentIP Enables/disables the usage of a persistent IP address for the device currently selected(value syntax: <interface index>;<value>).

Examples

IPConfigure device=GX000066 usePersistentIP=0;1 persistentIPAddress=0;172.111.2.1 persistentSubnetMask=0;255.255.255.0 persistentDefaultGateway=0;172.111.2.2 quit

Will configure interface 0 of the specified device to use a certain persistent IP configuration.

IPConfigure forceAutoConfigurePersistent=192.168.* quit

Will automatically enable persistent IPv4 address acquisition for all devices with an incorrect network setup on Ethernet adapters with an IP address matching the value after the '=' character and will terminate the application automatically afterwards.

IPConfigure facd=192.168.1.* quit

Will automatically enable DHCP address acquisition for all devices with an incorrect network setup on Ethernet adapters with an IP address matching the value after the '=' character. Both 'force*' parameters will only apply to misconfigured devices utilizing a persistent IP address and the 'Auto-fix Invalid Network Configurations' option from 'Settings' menu is active.

IPConfigure facd=192.168.1.* hidden quit

Will do the same but without displaying any GUI.

Note
Pressing F1 after the application is running will also display a detailed list of available command-line options as well as keyboard shortcuts and some other useful information!