17.17 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 exportdevice
-
ioutils exportdevicedetail
-
ioutils exportfield
-
ioutils exportoplog
-
ioutils exportpolicy
-
ioutils exporttemplate
-
ioutils exportupdategroup
-
ioutils importasset
-
ioutils importfield
-
ioutils importfilter
-
ioutils importpolicy
-
ioutils importtemplate
-
ioutils importupdategroup
-
reorgdb
-
startservice
-
stopservice
-
updatesupportinfo
-
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: