Configuration Manager Console Extension Deployment

Article
06/29/2016

Applies To: System Center 2012 Configuration Manager, System Center 2012 Configuration Manager SP1, System Center 2012 R2 Configuration Manager

The deployment of a typical System Center 2012 R2 Configuration Manager extension has to account for actions, forms, views, management classes and node extensions.

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

Extension Type	Directory
Actions	%ProgramFiles%\Microsoft Configuration Manager\AdminConsole\bin for the assembly %ProgramFiles%\Microsoft Configuration Manager\AdminConsole\XmlStorage\Extensions\Actions for the action XML files
Forms	%ProgramFiles%\Microsoft Configuration Manager\AdminConsole\bin for the assembly %ProgramFiles%\Microsoft Configuration Manager\AdminConsole\XmlStorage\Extensions\Forms for the form XML files
Views	%ProgramFiles%\Microsoft Configuration Manager\AdminConsole\XmlStorage\bin for the assembly
Nodes	%ProgramFiles%\Microsoft Configuration Manager\AdminConsole\bin for the assembly %ProgramFiles%Microsoft Configuration Manager\AdminConsole\XmlStorage\Extensions\Nodes for the node XML files
ManagementClasses	%ProgramFiles%\Microsoft Configuration Manager\AdminConsole\bin for the assembly %ProgramFiles%Microsoft Configuration Manager\AdminConsole\XmlStorage\Extensions\ManagementClasses for the management classes XML files

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\AdminConsole\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\AdminConsole\bin or to your application's installation folder.

If you are deploying to a directory other than the %ProgramFiles%\Microsoft Configuration Manager\AdminConsole\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\AdminConsole\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, then add your property page to that property sheet.

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 Page 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\AdminConsole\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\AdminConsole\bin folder, or to your application's installation folder.

If you are deploying to a folder other than %ProgramFiles%\Microsoft Configuration Manager\AdminConsole\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 Grid View.

You must also copy the node XML that integrates the view into the Configuration Manager console to the %ProgramFiles%\Microsoft Configuration Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID folder>, where <GUID> is the GUID identifier for the node that the action applies to. 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\AdminConsole\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\AdminConsole\XmlStorage\Extensions\Nodes\<GUID> folder, where <GUID> is the GUID identifier for the node that the action applies to.

Custom Management Classes

Installing a Custom Management Class

Copy the management class assembly to either %ProgramFiles%\ Microsoft Configuration Manager\AdminConsole\bin or to your application's installation folder.

To install an custom management class XML file, copy the file to the %ProgramFiles%\Microsoft Configuration Manager\AdminConsole\XmlStorage\Extensions\ManagementClasses folder. Because all custom management classes 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.

Removing a Custom Management Class

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

Nodes

Installing a Node

To install a node, create a folder %ProgramFiles%\Microsoft Configuration Manager\AdminConsole\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\AdminConsole\XmlStorage\Extensions\Nodes\<GUID> folder.

Share via