About Configuration Manager Custom Actions
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
You can create custom actions that can be used with existing Microsoft System Center Configuration Manager 2007 actions.
Custom actions are command-line actions that calls an application. The application can be a process, a script or other commands that you specify in a Managed Object Format (MOF) file description.
For more information, see About Configuration Manager Custom Action Client Applications.
To allow users to configure your custom action, you can create a custom action control that integrates into the Task Sequence Editor.
Creating a custom action control requires the following steps.
Creating the Custom Action Control
To create a custom action control, you use Visual Studio 2005 to create a Windows control that implements two classes.
The control that is displayed in the Task Sequence Editor is the first class, which derives from the SMSOsdEditorPageControl class. In this class, you define the user interface and the data transfer to and from the action. When a custom action is created, the control's PropertyManager makes the custom action's properties available for use. These are the properties that are defined in the custom action MOF file.
The second class implements the options control, and it derives from the TaskSequenceOptionControl class.
For more information about creating a custom control in Visual Studio, see How to Create a Configuration Manager Custom Action Control.
Note
The Configuration Manager 2007 SDK sample CustomTasksequenceAction shows how to create a custom task sequence action control and MOF.
Supporting Help
You cannot integrate your control's Help with the Configuration Manager console F1 key Help support. If a user presses F1 in your control, the control does nothing. However, you can implement Help in your control by using a mechanism of your choice to open the Help .chm file. For example, you can add a Help button that opens your Help .chm file.
Creating the Custom Action MOF File
Each Configuration Manager action is defined in the task sequence provider MOF file, _tasksequenceprovider.mof. A custom action extends this MOF file with a description for the custom action class. You should create the description of your custom action in a separate MOF file.
For more information, see About Configuration Manager Custom Action MOF Files and How to Create a MOF File for a Configuration Manager Custom Action.
Deploying the Custom Action Control Assembly
After the custom action control assembly is created, it must be copied to the same directory as the Adminui.tasksequenceeditor.dll. Typically this directory is in %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin.
Using the Custom Action Control
To use the custom action, you create and edit a task sequence in the Configuration Manager console. Clicking Add displays a list of categories, and you should see the custom action listed in the category that you specified in the custom action MOF file.
After you select it, you will see the control that you have created. The action behaves like the default Configuration Manager actions. You can add conditions to the action and you can move the action within the task sequence.
For more information, see How to Use a Configuration Manager Custom Action Control.