Admittedly I do not use custom console extensions very often, however I know that these right click tools are quite popular; from time to time I will encounter a customer situation in which creating a custom console extension makes sense. With System Center 2012 Configuration Manager we have a new console, a ribbon, and basically a new platform. How do custom console extensions play out with the new system? In this System Center PFE Blog posting I will discuss the internals of Configuration Manager 2012 console extensions, and also walk through the creation of a practical ‘right click’ extension for the 2012 console.

The text of this blog is a result of my own exploration with console extensions in a pre-release version of System Center 2012 Configuration Manager. As Configuration Manager is at pre-release, this information may change. At some point in the future there should be a System Center 2012 Configuration Manager SDK release which will discuss console extensions in more detail. Please refer to this publication (once available) as development documentation. My goal here is to simply show the possibilities through example and raise awareness towards these extensions.

 

Goals for this blog:

  • Discuss the 2012 Configuration Manager Console Extension Internals.
  • Create a custom extension that will ping all machines in a selected collection, and write the result to and Excel spread sheet.

 

Console Extension Internals:

When considering console extensions for Configuration Manager (2007 or 2012) there are several components to consider

  • Console Extension Type – many different types of extensions are documented (or will be documented) in the Configuration Manager SDK. These types include Actions, Forms, Views, Nodes, and Management Classes. In this Blog post we will be focusing only on the Actions type.
  • Console Component GUID – this GUID corresponds to the console component on which you would like to add the custom Action.
  • Extension Folder – Each custom extension will be created and placed in a specific location for console consumption. This location will vary depending on why type of console extension is being created and what platform it is being created for (2007 or 2012).
  • XML File – each console extension is made up of a custom XML file.
  • Action Executable – typically each Console Action extension will have an executable (script or otherwise) that will be called from the XML file.

With each of these components defined, let’s take a closer look at how to work with each specific component.

 

Console Component GUID :

Before we can determine the location in which to place our custom extension XML file, we will need to find the GUID corresponding to the console component on which we would like our custom action to be added. In other words if we want to add our action (right click tool)  to the Software Library / Software Update section of the console, we need to determine the specific GUID  for the this location. Likewise if we would like our action (right click tool) to surface on a collection under the Assets and Compliance node of the 2012 Configuration Manager console we would need to know the corresponding GUID. In order to identify these GUID’s we must traverse existing root console XML files and manually (or using a script) locate these GUIDS.

If you have done this with 2007 you will recall the root console file as AdminConsole.XML. With 2012 there are multiple files corresponding to the multiple Configuration Manager nodes. For instance if you have an action that is to be placed on the Overview node under Administration, you would be searching SiteConfigurationNode.XML. For the exercise detailed in this blog (ping all machines in a collection) we will be adding an extension to device collections underneath the Assets and compliance node. For this we will be searching the AssetManagementNode.xml file.

When examining the root console XML files for specific GUIDS, search for NamespaceGuid=<GUID> followed by Id=<Node Description>. The Id will give you a good idea of which console component the GUID belongs too. Note that most console components will have child components; these will not have an ID, rather a Type=’WQL’. I have found that is pretty easy to walk the XML matching up GUIDs to console components as I go. A little bit of trial and error helps as well. So for example if we open up AssettManagementNode.XML and search for ‘NamespaceGuid=’, the second item (after the root) we will come to is ‘NamespaceGuid="f10d0965-4b26-4e37-aab5-5400fbbc8eaa" Id="AssetManagementNodeOverview”’. This is the GUID associated with the root of Assets and Compliance or ‘Overview’ as it is displayed in the 2012 Configuration Manager Release Candidate console. Walking to the next ‘NamespaceGuid=’ we come up with ‘NamespaceGuid="80ea5cfa-5d28-47aa-a134-f455e2df2cd1" Id="Users"’. One more and we come up with ‘NamespaceGuid="baaa6910-892f-4d20-9082-b392e5a28a53" Type="WQL"’. We can assume that this is the GUID associated with the user objects.

For this exercise we want to right click on a device collection and ping all machines found in that collection. For this purpose we will use GUID a92615d6-9df3-49ba-a8c9-6ecb0e8b956b.


XML File Location

With the console component GUID determined, we can create our XML landing spot or destination folder. With 2012 Configuration Manager the XML file location will be %Program Files%\Microsoft Configuration Manager\AdminConsole\XmlStorage\Extensions\Actions\<GUID>”. Replace <GUID> with the appropriate GUID. This folder will need to be created. In some cases you may need to create the “\Extensions\Actions\<GUID>” folders as well.

 XML File:

Here is sample XML for both 2007 and 2012. Notice that the 2012 XML has slightly changed due to the introduction of the ribbon. The new addition of the ‘ShowOn’ tag allows us to control wither or not the extensions is show on the ribbon, right click menu, or both.  During this blog I will only be discussing right click menus and will not address adding actions to the ribbon. These two sample XML have been taken from the 2007 SDK and the 2012 beta SDK.

System Center Configuration Manager 2007 –

System Center Configuration Manager 2007
  1. <ActionDescription Class="Executable" DisplayName="Make a Note" MnemonicDisplayName="Note" Description = "Make a note about software updates">
  2.   <Executable>
  3.     <FilePath>Notepad.exe</FilePath>
  4.     <Parameters>C:\MyConfigurationManagerNote.txt</Parameters>
  5.   </Executable>
  6. </ActionDescription>

System Center 2012 Configuration Manager -

System Center 2012 Configuration Manager
  1. <ActionDescription Class="Executable" DisplayName="Make a Note" MnemonicDisplayName="Note" Description = "Make a note about software updates">
  2.   <ShowOn>
  3.     <string>DefaultContextualTab</string>
  4.     <!—RIBBON -->
  5.     <string>ContextMenu</string>
  6.     <!—Context Menu -->
  7.   </ShowOn>
  8.   <Executable>
  9.     <FilePath>Notepad.exe</FilePath>
  10.     <Parameters>C:\MyConfigurationManagerNote.txt</Parameters>
  11.   </Executable>
  12. </ActionDescription>

 

PFE Ping Demo Extension XML

Here is the XML that will make up the ping console extension. Notice here that unlike the previous SDK samples, the ShowOn tag only includes <string>ContextMenu</string>. This is because for this example I only want the extension to be accessible from the context menu and not the ribbon.Take note of the FilePath tag, this will specify the location of the ping script. Also note the parameter tag. The ##SUB:CollectionID## will make the collection ID accessible as an argument for our ping script.

PFEPing.XML
  1. <ActionDescription Class="Group" DisplayName="PFE Ping Demo" MnemonicDisplayName="PFE Ping Demo" Description="PFE Ping Demo" SqmDataPoint="53">
  2.  
  3.   <ShowOn>
  4.     <string>ContextMenu</string>
  5.   </ShowOn>
  6.  
  7.   <ActionGroups>
  8.     <ActionDescription Class="Executable" DisplayName="Ping Computers" MnemonicDisplayName="Ping Computers" Description="Ping Computers">
  9.  
  10.       <ShowOn>
  11.         <string>ContextMenu</string>
  12.       </ShowOn>
  13.  
  14.  
  15.       <Executable>
  16.         <FilePath>"C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\XmlStorage\Extensions\Actions\a92615d6-9df3-49ba-a8c9-6ecb0e8b956b\PFEPing.vbs"</FilePath>
  17.         <Parameters>##SUB:CollectionID##</Parameters>
  18.       </Executable>
  19.     </ActionDescription>
  20.  
  21.   </ActionGroups>
  22. </ActionDescription>


Action Executable:

Here is the VBScript that the console extension will execute. Using this script as is, you will need to specify your site server and site code around line 22 of this script.

PFEPing.vbs
  1. Set WshShell = WScript.CreateObject("WScript.Shell")
  2. Set objExcel = CreateObject("Excel.Application")
  3. objExcel.Visible = True
  4. objExcel.Workbooks.Add
  5. intRow = 2
  6.  
  7.  
  8. objExcel.Cells(1, 1).Value = "Machine Name"
  9. objExcel.Cells(1, 2).Value = "Results"
  10.  
  11.  
  12. Set objArgs = WScript.Arguments
  13.  
  14. IF (objArgs.count > 0) then
  15.       MyPos = InStr(objArgs(0), ":")
  16.     COLLID = wscript.arguments.item(0)    
  17. END IF
  18.  
  19. Set SWbemLocator=CreateObject("WbemScripting.SWbemLocator")
  20. set SWbemServices = SWbemLocator.ConnectServer("<Site Server>","root\SMS\site_<Site Code>")
  21.  
  22. strQuery = "select * from SMS_CM_RES_COLL_" & COLLID
  23. Set Computers= SWbemServices.ExecQuery(strQuery)
  24.  
  25. for each Computer in Computers
  26.  
  27.     Ping = WshShell.Run("ping -n 1 " & Computer.Name, 0, True)
  28.     objExcel.Cells(intRow, 1).Value = UCase(Computer.Name)
  29.  
  30.     Select Case Ping
  31.     Case 0 objExcel.Cells(intRow, 2).Value = "On Line"
  32.     Case 1 objExcel.Cells(intRow, 2).Value = "Off Line"
  33.     End Select
  34.  
  35.     If objExcel.Cells(intRow, 2).Value = "Off Line" Then
  36.     objExcel.Cells(intRow, 2).Interior.ColorIndex = 3
  37.     Else
  38.     objExcel.Cells(intRow, 2).Interior.ColorIndex = 4
  39.     End If
  40.  
  41. intRow = intRow + 1
  42.  
  43. Next
  44.  
  45.  
  46. objExcel.Range("A1:B1").Select
  47. objExcel.Selection.Interior.ColorIndex = 19
  48. objExcel.Selection.Font.ColorIndex = 11
  49. objExcel.Selection.Font.Bold = True
  50. objExcel.Cells.EntireColumn.AutoFit


 Putting it all Together:

To create the console extension follows these steps.

  1. Create the following folder - %Program Files%\Microsoft Configuration Manager\AdminConsole\XmlStorage\Extensions\Actions\a92615d6-9df3-49ba-a8c9-6ecb0e8b956b .
  2. Create an XML file (of any name) containing the XML from the above PFEPing.XML. Place this in the newly created folder. You may want to change the Display Name, Mnemonic Display Name and Description to something more appropriate for your environment.
  3. Create a .VBS file using the PFEPing.vbs code from above. Replace <Site Server> with the FQDN of your site server and <Site Code> with your three character site code. Place the script inside of the folder created in step 1.
  4. If your console is open, close it out and open it back up.
  5. Right click on any collection and execute the extension.

 

Troubleshooting and Caution:

To trouble shoot console extension issues see the SMSAdminUI.log.

I would discourage the creation of any extensions directly on a site server, rather install the Configuration Manager console on another machine and create them there.

 
Video Demonstration: