17.15 ioutils importupdategroup (importing update group settings)
Functionality
This command imports previously exported update group settings. Only the files that the update group was exported into are allowed to be imported.
If you have multiple JP1/IT Desktop Management systems configured, an update group setting in one system can be reused in another system.
Execute this command on the following servers:
-
In a single-server configuration system: Management server
-
In a multi-server configuration system: Database server
Format
ioutils importupdategroup -import import-file-name[ -name update-group-name][ -s]
Argument
- -import import-file-name
-
Specify the absolute path (within 259 bytes) of the XML file to import.
- -name update-group-name
-
Specify an update group name to import. If this argument is omitted, the update group name specified in the previous export will be used.
- -s
-
Overwrites the file even if an update group with the same file name already exists. If this argument is not specified and an update group with the same name already exists, an overwrite confirmation message appears. In this case, the system cancels the input or overwrites the file according to the administrator's reply.
Storage location
JP1/IT Desktop Management-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.
Notes
-
Execute this command in the following situations:
In a single-server configuration system: When the management server setup is completed, and the services on the management server have started.
In a multi-server configuration system: When the management server and database server are already set, and the services on both servers have started.
-
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 importfield
-
ioutils importfilter
-
ioutils importpolicy
-
ioutils importtemplate
-
reorgdb
-
startservice
-
stopservice
-
updatesupportinfo
-
Return value
The following table shows the return values of the ioutils importupdategroup command.
|
Return value |
Description |
|---|---|
|
0 |
The command finished normally. |
|
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 or database server has not been set up. |
|
79 |
The specified update group name is invalid. |
|
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 the previously exported update group settings file updategroup.xml in C:\temp\, with the import name "excluded group for headquarters".
ioutils importupdategroup -import C:\temp\updategroup.xml -name "excluded group for headquarters" -s
Related Topics: