ManagementModuleUtil

ManagementModuleUtil.exe is a MOM command-line utility that exports a rule group to a Management Pack file or imports a rule group from a Management Pack file. ManagementModuleUtil can also be used to export or import views and tasks.

Exporting Management Packs

ManagementModuleUtil -O|-Ox|-Ov|-Ot MOMServerName MPObjectName|MPObjectGUID AKMFileName [-V 00.0.0000.0000] [-Vm 00.0.0000.0000] -W|-A [DescriptionFile]

Flags

  • -O
    Performs a complete export of the rules group. The complete version includes additional data required to regenerate your vendor-specific knowledge and includes disabled group rules that have the component type set to MCS. It also includes rules marked as deleted with component type equal to MCS.
  • -Ox
    Performs a release export of the rules group. The release version will skip disabled group rules that have the component type set to MCS. Setting this flag causes rules that have been marked for deletion with component type equal to MCS to not be exported.
  • -Ov
    Exports a saved view.
  • -Ot
    Exports a saved task.
  • -V
    Specifies version information to assign to the management pack file and its contents. Use the following format: [major version number].[minor version number].[build number].[build revision number]
  • -Vm
    Specifies a MOM server version dependency for the management pack.
  • -W
    Writes to a new file.
  • -A
    Appends to a file. If you specify the -A flag, the file must exist and contain the proper AKM internal representation; otherwise, the export will not succeed.

Parameters

  • MOMServerName
    The name of the MOM management server.
  • MPObjectName|MPObjectGUID
    The name or GUID identifying the management pack.
  • AKMFileName
    The name of the file that the Management Pack is being imported from. Enclose this parameter in double-quotation marks if it contains spaces.
  • DescriptionFile
    [optional] The input file containing plain text that describes the Management Pack. The person exporting a Management Pack is responsible for providing this file. If provided, the contents of the description file appears in the Description field of the Import Management Pack dialog box in the MOM Administrator console. Enclose this parameter in double-quotation marks if it contains spaces. The maximum size for this file is 2000 bytes. The contents of the file should describe items such as the log files that are used by the Management Pack and which critical conditions are monitored.

Importing Management Packs

ManagementModuleUtil -I MOMServerName AKMFileName [-F|-R] [-V]

Flags

  • -I
    Imports a rules group.
  • -F
    Forces an overwrite of an existing rule if it is contained in the Management Pack being imported. The user's knowledge-base comments are preserved.
  • -R
    Replaces the entire rule group.
  • -V
    Disable import version verification.

Parameters

  • MOMServerName
    The name of the MOM management server.
  • AKMFileName
    The name of the file to which the Management Pack is being exported. Enclose this parameter in double-quotation marks if it contains spaces.

Note Note   

If neither the -F or -R flag is specified, the imported rules are merged with the existing rules and all of the user's changes to the rules are preserved.

Regenerating Knowledge

ManagementModuleUtil -K|-Kp MOMServerName ProcRuleGroupName

Flags

  • -K
    Regenerates knowledge for all rules in the rule group specified, as well as all child rule groups.
  • -Kp
    Regenerates knowledge for all rules in the specified rule group.

Parameters

  • MOMServerName
    The name of the MOM management server.
  • ProcRuleGroupName
    The name of the rule group.

Remarks

ManagementModuleUtil.exe is installed as part of the MOM installation. Because the utility depends on MOM DLLs in the directory where it is initially installed, it should not be moved or copied to another directory.

Running ManagementModuleUtil.exe with no command-line parameters displays Help.

If the Management Pack will contain views, export the rule group first and then add the exported views to the file (by using the -A flag).

Example Usage

ManagementModuleUtil -Ox MOMServer01 "Microsoft Operations Manager 2005" c:\MOM\file1.akm -W description.txt

ManagementModuleUtil -Ox MOMServer01 "Microsoft Operations Manager 2005" c:\MOM\file1.akm -A

ManagementModuleUtil -Ov MOMServer01 "Microsoft Operations Manager\All Alerts" c:\MOM\file1.akm -A

ManagementModuleUtil -Ox MOMServer01 "Microsoft Operations Manager 2005" c:\MOM\file1.akm -V 4.0.0.0100 -W description.txt

ManagementModuleUtil -Ox MOMServer01 "Microsoft Operations Manager 2005" c:\MOM\file1.akm -V 4.0.0.0100 -Vm 4.0.0.1300 -W description.txt

ManagementModuleUtil -Ot MOMServer01 "Microsoft Operations Manager\Start MOM 2005 Service" c:\MOM\file1.akm -A

ManagementModuleUtil -I  MOMServer01 c:\MOM\file1.akm -F

ManagementModuleUtil -I  MOMServer01 c:\MOM\file1.akm -R -V

ManagementModuleUtil -Kp MOMServer01 "Microsoft Operations Manager 2005"

Note Note   

The MOM operations database should be regularly backed up. Before importing a Management Pack, ensure that you have a backup of the database.

See Also

MOM Tools