Command-line options for the Application Management agent
A software resource for the Application Management agent is created in the Software Catalog when Software Management Solution is installed. You can use this software resource to create your own policies and tasks to repair Windows Installer applications or to update their source paths. You deliver the agent with a command line that runs the agent according to your specifications. You use the Application Management agent command-line options to create the command line.
The executable file for the Application Management agent is Aexmsiagent.exe. The command lines must use the following format:
Aexmsiagent.exe /
option parameter
The command-line options for the Application Management agent adhere to the following standards:
- They can be standalone options or they can take parameters.
- They are not case sensitive.
- They can use environment variables.
- If they use GUIDs, the GUIDS must be formatted as follows:{8E1FC9E1-8ACC-4e1c-9D6C-F217C0223B7D}
Option | Description and parameters |
|---|---|
/? | Displays a help dialog box. |
/AddSourcePath | Adds a source path to the list of valid sources for the specified product. If another source in the set was used to install the product, the new source is not used unless the current source is unavailable. This option takes the following parameters:
|
/Collect | Runs the Inventory Collector and sends Windows Installer information to the Notification Server computer if the Symantec Management Agent is running on the computer. |
/ExcludeComponents IDs | Excludes the specified components. For IDs , type a semicolon-delimited list of the component names or GUIDs. Excluding components from the processing reduces the agent’s run time. |
/ExcludeProducts IDs | Excludes the specified products. For IDs , type a semicolon-delimited list of the product names or GUIDs. Excluding products from the processing reduces the agent’s run time. |
/first= Computer Name | Specifies the first package server that Windows Installer should check for source files during an update of source paths for an application. For Computer Name , type the computer name of the package server to check.This option can be used with the following options:
|
/ICFilePath file path | Specifies an alternate Inventory Collector program, where file path is the program’s full path and file name.After the Application Management agent creates its output, it invokes the Inventory Collector to process the output. The inventory collector prepares the output for loading into the Configuration Management Database. By default, the agent assumes that the Inventory Collector program is in the same directory as the agent. The Inventory Collector program is AeXNSInvCollector.exe. |
/IncludeComponents IDs | Processes only the specified components. For IDs , type a semicolon-delimited list of the component names or GUIDs. Limiting the components that are processed reduces the agent’s run time. |
/IncludeProducts IDs | Processes only the specified products. For IDs , type a semicolon-delimited list of the product names or GUIDs. Limiting the products that are processed reduces the agent’s run time. |
/last= Computer Name | Specifies the last package server that Windows Installer should check for source files during an update of source paths for an application. For Computer Name , type the computer name of the package server to check.This option can be used with the following options:
|
/LFile file name | When logging is enabled, log messages are written to Aexmsiagent.log by default. Use this option to specify an alternate log file, where file name is the path name and file name. If a path is not specified, the file is written to the current executable directory.This option is used with /Log . |
/LLevel | When logging is enabled, log messages contain only errors and warning by default. Use this option to specify the types of messages to log. This option is used with /Log .This option takes one or more of the following parameters:
Do not separate the parameters with spaces or other characters. For example, the following command logs error and information level messages: Aexmsiagent.exe /Log /LLevel ei |
/Log | Enables logging to disk. The default log file is Aexmsiagent.log. |
/Lsize x | Sets the maximum number of bytes that a log file can reach before it is backed up and a new log file is started. For x , type the number of bytes to allow.The default maximum size is 1,024,000. The minimum size that is allowed is 2,048. Any size less than that is set to 2,048. |
/nbest= number | Specifies the number of package servers that Windows Installer should check for source files during an update of source paths for an application. For number , type the number of servers to check. Leave this option blank for an unlimited number of package servers.This option can be used with the following options:
|
/NoDeepScan | Scans only the component’s key file instead of performing a deep scan on the component’s resources (files, shortcuts, and registry entries). |
/NoShortcuts | Prevents the agent from trying to verify (deep scan) shortcuts during its scan. |
/Output format | Specifies the type of output the agent produces. For format , type xml because the output must be in XML format. |
/Repair | Specifies whether a component should be repaired, where the options parameter is one or more characters that represent the component’s state. If the agent finds a component in one of the specified states, the agent immediately tries to repair the component. The agent then reports on the status of the repair.This option takes one or more of the following parameters:
Do not separate the parameters with spaces or other characters. For example, the following command repairs any features or components in an absent state or a corrupted state: Aexmsiagent.exe /Repair ac |
/RepairTO seconds | Specifies the time that the Application Management agent waits for Windows Installer to complete a repair before the agent terminates it. For seconds , type the number of seconds to wait. The default value is 300 seconds. |
/Sleep x | Specifies the number of milliseconds that the agent should wait each time the throttle threshold is reached. This option reduces the load on the CPU at run time. For x , type the number of milliseconds to wait. The default value is 150.This option is used with the /Throttle option to modify the performance of the agent. |
/SystemLevelScan | Scans the products that are installed per-machine, and ignores the specific user values. |
/Throttle x | Specifies the number of items to process before the throttle threshold is reached. For x , type the number of items to process. The default value is 20.When the threshold is reached, the agent waits the number of milliseconds specified by the /Sleep option and then proceeds. Because feature objects and component objects are the most numerous and the most common, they are used for the throttle count “item.” |
/UI | Displays a user interface on the user ’s computer. The interface displays details about each Windows Installer application and lets the user selectively scan and repair broken applications. |
/UpdateSourcePaths | Updates the source paths for all applications. This option can be used with the following options:
|
/Visible | Displays any errors that occur while the agent runs. |