Configuration Manager Action XML

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

Every Configuration Manager 2007 action is defined by an ActionDescription XML element that defines the action type and other information that is used by the Configuration Manager console to display the action. An ActionDescription element has a variety of child elements that provide information specific to the action type and also conditional tests made before the action is displayed.

The following XML example describes an action that displays a report in the Configuration Manager console. The ActionDescription element Class attribute denotes a report action and the ReportDescription element provides the report details.

<ActionDescription Class="Report" DisplayName="Test Action (report)" MnemonicDisplayName="Mnemonic" Description="Description">
    <ReportDescription Id="05874720-1D08-4CF7-B182-5F9D065BEAE5">    </ReportDescription>
</ActionDescription>

The default actions used by the Configuration Manager console are defined in %ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\ConsoleRoot\AdminConsole.xml. The XML files for custom actions are placed in the %ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Actions folder under the appropriate Configuration Manager console node. The Configuration Manager console node is identified by a folder named with the GUID of the Configuration Manager console folder.

The following are typical attributes for an ActionDescription element:

Attribute Description

ActionVerb

Indicates whether the action is associated with a standard action.

Class

The action type, for example, ShowDialog.

DisplayName

The text displayed in the context menu.

MnemonicDisplayName

The mnemonic display name.

Description

The action description.

ImageDescription

Information about the action's icon.

SelectionMode

Determines when the action is displayed, as follows:

Single (default). Action is shown only when the selection set contains a single item.

Multiple. Action is shown when the selection set contains more than one item.

Both. Action is shown when one or more items are selected.

For a complete list of attributes, see ActionDescription.

There are a number of child elements for any given action type.

See Also

Concepts

About Configuration Manager Console Actions
Configuration Manager AssemblyType Action
Configuration Manager Conditional Actions
Configuration Manager Executable Action
Configuration Manager Group Action
Configuration Manager Report Action
Configuration Manager ShowDialog Action
How to Create a Configuration Manager Action
How to Find a Configuration Manager Console Node GUID