Configuration Manager Console Extension Deployment

 

Updated: November 1, 2013

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

Show: