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}
Command-line options for the Application Management agent
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:
  • ProductID
    The GUID of the product to add the source path to.
  • User
    The user name of the user whose product installation is modified.
    For all users, type
    all
    .
    For a local user, type the user name in one of the following formats:
    domain\user name
    computer name\user name
    .
  • Path
    The source path to add to the list of valid sources for the specified product.
  • ClearSourceList
    Specify
    Yes
    or
    True
    to clear all other source paths from the source list and then add this source path as the only entry in the list.
    Type
    No
    or
    False
    to append this source path to the source list.
/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:
  • /nbest
  • /last
  • /UpdateSourcePaths
/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:
  • /nbest
  • /first
  • /UpdateSourcePaths
/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:
  • all
    Log all messages
  • I
    Log information level messages
  • w
    Log warning level messages
  • e
    Log error level messages
  • d
    Log debug messages
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:
  • /first
  • /last
  • /UpdateSourcePaths
/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:
  • All
    Repair items in any of the possible states
  • a
    Repair absent (missing) items
  • b
    Repair broken items
  • c
    Repair corrupted items
  • I
    Repair incomplete items
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:
  • /first
  • /last
  • /nbest
/Visible
Displays any errors that occur while the agent runs.