17.22  ioutils importfilter, importing filter settings

Functionality

This command imports previously exported filters. You can only import a file into which filters were previously exported.

If you have multiple JP1/IT Desktop Management 2 systems configured, a filter in one system can be reused in another system.

Execute this command on the management server.

Format

ioutils importfilter -import import-file-name[ -name filter-name][ -s]

Argument

-export import-file-name

Specify the absolute path (within 259 bytes) of the XML file to import.

-name filter-name

Specify a filter name to import. If the filter name is omitted, the name from a previous export will be used.

-s

Overwrites a filter with the same name if it is already exists without displaying an overwrite confirmation message. If this argument is not specified and a filter 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 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 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 importpolicy

  • ioutils importtemplate

  • ioutils importupdategroup

  • ioutils importupdatelist

  • reorgdb

  • startservice

  • stopservice

  • updatesupportinfo

  • deletenwgroup

  • deletepackage

  • distributelicense

Return value

The following table shows the return values of the ioutils importfilter 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 has not been set up.
77	The specified filter does not exist.
80	The format of the file being imported is invalid.
84	A custom field for asset management does not match between the export-from location and the import-to location.
101	Command execution failed because there is not enough memory, or due to some other reason.
120	A database access error occurred.
150	Command execution was interrupted due to some other error.

Example

The following examples shows use of this command to import a previously exported filter, exportfilter.xml in C:\temp\, as a import filter name "PC to dispose."

ioutils importfilter -import C:\temp\exportfilter.xml -name "PC to dispose" -s

Related Topics:

• 17.1 Executing commands

To Page Top