17.7 ioutils importfield (importing custom field settings)
Functionality
This command imports custom fields from an XML file. You can only import the files to which custom fields were previously exported.
This command only allows the adding of custom fields by importing. Fields cannot be added or changed with this command. Use this command to restore the custom fields from a backup file that was previously exported to, in the event of a failure or environment migration.
Execute this command on the management server.
Format
ioutils importfield -import import-file-name
Argument
- -import import-file-name
-
Specify the absolute path (within 259 bytes) of the XML file to import.
Storage location
JP1/IT Desktop Management 2-installation-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.
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 exportdevice
-
ioutils exportdevicedetail
-
ioutils exportfield
-
ioutils exportfilter
-
ioutils exportoplog
-
ioutils exportpolicy
-
ioutils exporttemplate
-
ioutils exportupdategroup
-
ioutils importasset
-
ioutils importfilter
-
ioutils importpolicy
-
ioutils importtemplate
-
ioutils importupdategroup
-
reorgdb
-
startservice
-
stopservice
-
updatesupportinfo
-
Return values
The following table shows the return values of the ioutils importfield command.
Return value |
Description |
---|---|
0 |
The command finished normally. |
1 |
Custom fields were imported normally, but some services have not started. |
11 |
The format for specifying the command arguments is invalid. |
12 |
The specified folder is invalid, the disk does not have sufficient capacity, or the folder does not exist. |
31 |
Another command is being executed. |
51 |
You do not have the permissions to execute this command. |
54 |
The management server has not been set up. |
80 |
The format of the file being imported is invalid. |
101 |
Command execution failed because there is not enough memory, or due to some other reason. |
120 |
A database access error occurred. |
150 |
The command execution was interrupted due to some other error. |
Example
The following example shows use of this command to import previously exported file hardexportfield.xml. in C:\temp\.
ioutils importfield -import C:\temp\hardexportfield.xml
Related Topics: