17.47 deletenwctllist (deleting network control list)
Functionality
This command deletes all network control information on a management server. The conditions for deleting network control information are specified in the configuration file for the delete network control list command.
Execute this command on a management server. Complete the management server setup process, and start the management server service before executing this command.
Format
deletenwctllist.exe[∆-i∆configuration-file][∆-o∆CSV-output-file-storage-folder][∆-c∆command]
Arguments
- -i∆configuration-file
-
Specify the full path of the configuration file for the delete network control list command. If you omit this argument, the following file is referenced.
JP1/IT Desktop Management 2installation-destination-folder\mgr\conf\deletenwctllist.ini
- -o∆CSV-output-file-storage-folder
-
Specify the full path of the storage folder for outputting CSV files. If you omit this argument, CSV files are output to the following folder.
JP1/IT Desktop Management 2installation-destination-folder\mgr\temp
- -c∆command
-
Specify the processing command to be executed. If you omit this argument, the command prompt will be standing by for you to enter commands directly. A list of commands is given below.
- d
-
Outputs a CSV file of the network control information matching the conditions of the configuration file for the delete network control list command, and then deletes the matching network control information from the list.
- o
-
Outputs a CSV file of the network control information matching the conditions of the configuration file for the delete network control list command.
- e
-
Checks the configuration file for the delete network control list command, and then outputs the number of network control information entries matching the conditions.
Storage location
JP1/IT Desktop Management 2installation-destination-folder\mgr\bin\
You can execute this command without specifying the storage location for the executable file by using the command prompt provided by JP1/IT Desktop Management 2.
Format of the configuration file for the delete network control list command
The result of the AND condition for conditions set for each item in the configuration file for the delete network control list command acts as conditions for deleting network control information and outputting targets for deletion in CSV format.
The following describes the format of the configuration file for the delete network control list command.
Format
[WHERE] macip_way=setting macaddress=setting ipaddress=setting confirmation=setting device=setting
Item description
Item |
Description |
Setting |
---|---|---|
macip_way |
Specify the method used to set the MAC address and IP address. Always specify this setting. |
0: Unspecified (deletes network control information for all MAC addresses and IP addresses) 1: Specify the MAC address only 2: Specify the IP address only 3: Specify a MAC address and IP address (AND) 4: Specify a MAC address and IP address (OR) |
macaddress |
Specify the MAC address to be deleted. Always specify this setting if the macip_way setting is 1, 3, or 4. Prefix matching is used as the distinction method. A colon (:) is used as a delimiter. Separate between multiple MAC addresses using a comma (,). Multiple MAC addresses are combined under the OR condition. You can specify up to 10 MAC addresses. All subsequent MAC addresses will be ignored. |
The MAC addresses to be deleted |
ipaddress |
Specify the IP address to be deleted. Always specify this setting if the macip_way setting is 2, 3, or 4. Prefix matching is used as the distinction method. Separate between multiple IP addresses using a comma (,). Multiple IP addresses are combined under the OR condition. You can specify up to 10 IP addresses. All subsequent IP addresses will be ignored. |
The IP addresses to be deleted |
confirmation |
Specify whether to only delete candidates for confirmation. Always specify this setting. |
0: Delete all network control information. 1: Only delete network control information that is a candidate for confirmation. |
device |
Specify whether to only delete network confirmation information that is unrelated to the device. Always specify this setting. |
0: Delete all network control information. 1: Only delete network control information that is unrelated to the device. |
Configuration example
[WHERE] macip_way=3 macaddress=00:00:01,00:00:02 ipaddress=192.168.0,192.168.1 confirmation=0 device=0
Format of the CSV output file
The format of the CSV output file is described below.
Output destination
CSV files are output to the folder with the -o option specified. If unspecified, CSV files are output to the following folder.
JP1/IT Desktop Management 2installation-destination-folder\mgr\temp
File name
deletenwclist_yyyymmddhhmmssfff-format-of-output-date.csv
For example: deletenwclist_20210531173140307.csv
Output items
-
MAC address
-
IP address
-
Host identifier
-
Confirmation candidacy (0: No effect, 1: Candidate for confirmation)
Notes
-
Execute this command when the management server setup is completed and the management server is running.
-
This command cannot be simultaneously executed by multiple users.
-
This command cannot be executed simultaneously with any of the following commands:
-
exportdb
-
importdb
-
ioassetsfieldutil export
-
ioassetsfieldutil import
-
ioutils exportasset
-
ioutils exportassetassoc
-
ioutils exportdevice
-
ioutils exportdevicedetail
-
ioutils exportfield
-
ioutils exportfilter
-
ioutils exportoplog
-
ioutils exportpolicy
-
ioutils exporttemplate
-
ioutils exportupdategroup
-
ioutils exportupdatelist
-
ioutils importasset
-
ioutils importassetassoc
-
ioutils importexlog
-
ioutils importfield
-
ioutils importfilter
-
ioutils importpolicy
-
ioutils importtemplate
-
ioutils importupdategroup
-
ioutils importupdatelist
-
reorgdb
-
startservice
-
stopservice
-
updatesupportinfo
-
deletenwgroup
-
deletepackage
-
distributelicense
-
-
To execute this command, perform the following steps:
-
Stop the following services:
Start the Administration Tools service, and then stop the following services from the list of services: Check the service outage before stopping the next service.
-
JP1_ITDM2_Agent Control
-
JP1_ITDM2_Service
-
JP1_ITDM2_Web Container
-
JP1_ITDM2_Web Server
-
JP1_ITDM2_Relay Manager Service#
-
-
Execute the deletenwctllist command.
Make sure that the service is stopped when you run the command before running it.
-
After the command is complete, start the next service:
Start the Administration Tools service, and then start the following services from the list of services: Check the service startup before launching the next service.
-
JP1_ITDM2_Agent Control
-
JP1_ITDM2_Service
-
JP1_ITDM2_Web Container
-
JP1_ITDM2_Web Server
-
JP1_ITDM2_Relay Manager Service#
-
#: If you are administering a single configuration management server, you do not need to stop or start this service.
-
Return values
The following table shows the return values of the deletenwclist command.
Return value |
Description |
---|---|
0 |
The command finished normally. |
31 |
Another command is being executed. |
51 |
You do not have the permissions to execute this command. |
150 |
The command execution was interrupted due to some other error. |
-1 to -9 |
An initialization error occurred (JP1/IT Desktop Management 2 has not been set up) |
-11 to -49 |
A database error occurred (the database has not been started) |
-101 to -109 |
There was an error loading the configuration file for the delete network control list command.
|
-111 to -119 |
The specified format for the command argument is incorrect.
|
-201 to -209 |
Deletion error (database access error) |
-211 to -229 |
CSV output error |
-999 |
Other error |
Example
The following example shows the use of this command to output network control information matching the conditions listed in the configuration file for the delete network control list command (C:\temp\deletenwclist.ini) to the default folder in CSV format, and then delete the network control information from the list:
deletenwclist.exe -i C:¥temp¥deletenwctllist.ini -c d
Related Topics: