17.46 softwaresearch (searching for software installed in an agent device)
This section describes the softwaresearch command that is used to search for software installed in a device with a Windows agent installed.
Functionality
The command can be used to search for software installed in the device with the Windows agent at any time. The search of software is done according to the conditions defined in the software search conditions file. If the software search conditions file does not exist, the command will not search for software even when executed. Place the software search conditions file in the installation path of the agent before executing the command.
You can view the information of software found by this command in the Software List view and Installed Software tab of the Inventory module, or in the Managed Software view of the Assets module.
Execute this command with administrator privileges.
Up to 64 pieces of software can be discovered using this command. Up to the 64th piece of software detected under the search conditions is searched. However, for search conditions that are not searched, the command terminates without executing the software search.
- Important
-
Even if more than 64 pieces of software information are detected by the command, no notification will be made for software information that is the same as that in Add/Remove Software or the software information obtained by software search.
As overlapping software information is removed from the software information managed on the Software List view and Installed Software tab of the Inventory module as well as the Managed Software view of the Assets module, the window display may be for up to 64 hits.
Format
softwaresearch∆[/START]
Arguments
- /START
-
Specify it when you perform software search. If you omit it, software search will not be performed.
Storage location
agent-installation-folder\bin\
Notes
-
The software search conditions file must be placed in the installation path of JP1/IT Desktop Management 2 - Agent.
-
If the information of software found is the same as that in Add/Remove Software or the software information obtained by software search, no notification will be made.
-
If you cannot view the software information correctly, take the following actions:
-
Check if the software search conditions file contains correct information.
-
Check if an error message has been logged in the publishing log (SWSEARCH.log).
The publishing log file (SWSEARCH.log) is stored in:
JP1/IT Desktop Management 2 - Agent-installation-folder\log
-
-
This command cannot be executed simultaneously with any of the commands.
-
The result of the software search is notified to the host system at the timing of Monitoring Interval (Security) (min) in the Agent Configurations.
Return values
The following table lists the return values of the softwaresearch command.
|
Return value |
Description |
System action |
Operator action |
|---|---|---|---|
|
0 |
The command started. |
-- |
-- |
|
0 |
The command finished normally. |
-- |
-- |
|
1 |
The number of software information hits detected by the command exceeded the upper limit (64). |
Search will halt. |
Review and revise the definition and then re-execute the command. |
|
11 |
The specified argument is incorrect. Usage: softwaresearch /START /START Specify the argument when you perform software search. |
No search is performed. |
Correct the argument and then re-execute the command. |
|
21 |
The software search conditions file does not exist. |
No search is performed. |
Place the file and then re-execute the command. |
|
22 |
An incorrect definition was found in the software search conditions file. |
No search is performed. |
Review and revise the definition and then re-execute the command. |
|
24 |
The software search conditions file is inaccessible. |
No search is performed. |
Check the access permissions of the file, change them to those allowing access, and then re-execute the command. |
|
25 |
The search conditions defined in the software search conditions file exceed the upper limit (500 rows). |
No search is performed. |
Set the search conditions to within 500 rows and then re-execute the command. |
|
31 |
The command is already being executed. |
No search is performed. |
Check if this command is running elsewhere, and if not, re-execute the command. |
|
32 |
You do not have permissions to execute the command. |
No search is performed. |
Re-execute the command with administrator privileges. |
|
150 |
The command execution was interrupted due to some other error. |
Search will halt. |
Collect data by using the getlogs command, and then contact the system administrator. |
Example
The following example shows how to use the command when you perform software search.
softwaresearch /START
Related Topics:
- Organization of this section