17.21  ioutils exportfilter (exporting filter settings)

Functionality

This command exports filtering criteria. You can use one of the predefined filters displayed in the menu area in the following views.

• Hardware Assets

• Software Licenses

• Managed Software

• Contracts

• Device Inventory

• Software Inventory

• Computer Security Status

• Operation logs

• Windows Update

• Event list

• Packages

• Tasks

• Network Filter List^#

#: This filter can be defined in the Settings module, Network Access Control, and the Network Filter Settings view by entering in the information area.

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 exportfilter -export export-file-name -filtertype filter-type -name export-filter-name[ -s]

Argument

-export export-file-name

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

-filtertype filter-type

Specify a filter type to export. The following types of filters can be specified:

• asset: hardware assets

• license: software licenses

• mngsoft: managed software

• contract: contracts

• device: device inventory

• inssoft: software inventory

• secdevice: Computer Security Status

• oplog: operation logs

• update: windows update

• event: event list

• package: packages

• task: tasks

• netctl: Network Filter List

-name export-filter-name

Specify a filter name to export.

-s

Overwrites the file even if a file with the same file name already exists at the export destination. If this argument is not specified and a file with the same file name already exists, an overwrite confirmation message appears. In this case, the system cancels the output 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 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 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

The following table shows the filtering criteria that cannot be exported.

Item	Filtering criteria that cannot be exported when:
Device type	When the filter contains any optional items added by the user (such as the device type, asset status etc.)
Asset type
Planned asset status
License type
License status
Planned license status
License type
Contract type
Contract status
Department	When filter contains Department filed
Location	When filter contains Location field

Return value

The following table shows the return values of the ioutils exportfilter 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.
15	A file access error occurred when outputting the file, or the disk does not have sufficient capacity.
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.
70	The specified filter does not exist.
86	Some items cannot be exported.
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 export a hardware asset filter called "low-end computer" to C:\temp\exportfilter.xml.

ioutils exportfilter -export C:\temp\exportfilter.xml -filtertype asset -name "low-end computer" -s

Related Topics:

• 17.1 Executing commands

To Page Top