Configuration Manager Console Extension Deployment

Article
05/03/2011

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

The deployment of a typical Microsoft System Center Configuration Manager 2007 extension has to account for actions, forms, views, and node extensions.

When you deploy a Configuration Manager 2007 extension, you install the files in the following directories:

Extension Type	Directory
Actions	%ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Actions
Forms	%ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin for the assembly %ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Forms for the form XML files
Views	%ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\bin
Nodes	%ProgramFiles%Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Nodes

You must also perform the following tasks during installing and uninstalling actions.

Custom Actions

Installing a Custom Action

To install a custom action XML file, copy the file to the %ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Actions\GUID folder, where GUID is the GUID identifier for the node that the action applies to.

Removing a Custom Action

To remove a custom action, delete the custom action XML file. If there are no other XML files in the folder then it is safe to remove the folder.

Forms

Installing a Form

You copy the form assembly to either %ProgramFiles%\ Microsoft Configuration Manager\AdminUI\bin or to your application's installation folder.

If you are deploying to a directory other than the %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin folder, the form XML<Assembly> attribute, Name, should include the assembly filename and the full path to the file. For more information, see How to Create Form XML for a Configuration Manager Property Sheet.

To install an extension property sheet XML file for a form, copy the file to the %ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Forms folder. Because all extension forms are placed in this folder, you must ensure that your XML file has a unique name. It is suggested that you use your company name as part of the file name.

If the form is an extension of an existing property sheet, you must determine whether the property sheet already exists in the Extensions\Forms folder. If it does, add your property page to that property sheet. Otherwise, copy the original property sheet from %ProgramFiles%\Microsoft Configuration Manager \AdminUI\XmlStorage\Forms to the Extensions\Forms folder.

When the Configuration Manager console loads, it loads property sheets in the Extensions\Forms folder in preference to existing property sheets.

You should use the VendorId attribute of the PropertySheet element, because this allows other vendors to identify and avoid changing your extensions.

Removing a Form

To remove a form that does not extend an existing property sheet, remove the property sheet XML file from the folder %ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Forms.

To remove a property page that you have added to an existing property sheet, you must take the following actions with the property sheet:

Check the property pages for VendorIDs other than Microsoft Corporation. If none exist then it is safe to delete the property sheet XML file from the Extensions\Forms folder.
If other VendorIDs exist, remove your property page XML from the property sheet, and leave the property sheet in the Extensions\Forms folder.

Views

Installing a View

To install a view, copy the view assembly to the %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin folder, or to your application's installation folder.

If you are deploying to a folder other than %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin, the node XML<Assembly> element should include the assembly filename and the full path to the file. For more information, see How to Create Node XML for a Configuration Manager Console View.

You must also copy the node XML that integrates the view into the Configuration Manager console to the %ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Nodes\GUID folder. For more information, see the "Nodes" section later in this topic.

Removing a View

To remove a view, delete the view assembly from the %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin folder. You must ensure that no other extension is referencing the view before you delete it. You must also delete the view's node XML file from the %ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Nodes\GUID folder.

Nodes

Installing a Node

To install a node, create a folder %ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Nodes\GUID where GUID is the GUID identifier of the Configuration Manager console parent node. Copy the node XML file to the GUID folder. For more information, see Configuration Manager Console Nodes.

Removing a Node

To remove a node, delete the node XML file from the %ProgramFiles%\Microsoft Configuration Manager\AdminUI\XmlStorage\Extensions\Nodes\GUID folder.

Share via