{"id":15,"date":"2023-03-21T03:26:32","date_gmt":"2023-03-21T03:26:32","guid":{"rendered":"https:\/\/brunocm.azurewebsites.net\/?page_id=15"},"modified":"2025-10-09T14:00:53","modified_gmt":"2025-10-09T12:00:53","slug":"part-2-first-c-extension","status":"publish","type":"page","link":"https:\/\/brunocm.azurewebsites.net\/?page_id=15","title":{"rendered":"Part 2 – First c# extension"},"content":{"rendered":"

Build your first extension -> device info<\/h1>\n

You might wonder why creating an extension on a C# assembly instead of writing a vbs, powershell ,\u2026. Script ?<\/p>\n

I see two advantages to do so:<\/p>\n

    \n
  1. you can directly rely on the console’s connection information, no need to manage the connection on your own.<\/li>\n
  2. The external executable solution only<\/u><\/strong> works if you select a single<\/u><\/strong> object in the console meaning you can’t run an action for several objects at once.<\/li>\n<\/ol>\n

    Here I will explain how to create an extension that will show in a MessageBox all the collections a device is a member of.<\/p>\n

    Edit: starting with SCCM CB 1906, this feature will be directly implemented in the console as a tab in the detail pane. This extension will then be useless but it’s still a good example of what can be achieved with custom extensions.<\/p>\n

    First download Visual studio IDE (Community edition is enough and freely distributed by Microsoft)<\/p>\n

    Start it and create a new “Class Library” project
    \n\"\"<\/p>\n

    And chose a simple name for it
    \n\"\"<\/p>\n

    The class automatically generated is always named Class1. Just change it for a more accurate one (right-click on “Class1” then select “rename”)
    \n\"\"<\/p>\n

    Don’t forget to also rename the file or you can quickly get lost ^^
    \n\"\"<\/p>\n

    The SCCM console is only 32bits so we need to limit compilation to X86 architecture.<\/p>\n

    Open the small menu showing “Any CPU” then select configuration manager
    \n\"\"<\/p>\n

    Open “Active solution platform” and choose “<New\u2026>”
    \n\"\"<\/p>\n

    Select x86 in the first dropdown menu and click “OK”
    \n\"\"<\/p>\n

    Close the “configuration manager” window.<\/p>\n

    We require some references to SCCM console assemblies. In the left pane, in the solution explorer, right-click on “References” in your project then select “Add Reference\u2026”
    \n\"\"<\/p>\n

    Click on the “Browse” at the bottom of the “Reference Manager” windows, then browse your drive to the bin directory of the console installation folder and select “Microsoft.ConfigurationManagement.exe”. Repeat the same operation for “Microsoft.ConfigurationManagement.ManagementProvider.dll” and “AdminUI.WqlQueryEngine.dll”<\/p>\n

    Now, create the function that we will call from the console:<\/p>\n

    public static void <\/span>deviceCollections(object <\/span>sender, ScopeNode<\/span> scopenode, ActionDescription<\/span> action, IResultObject<\/span> result, PropertyDataUpdated<\/span> dataUpdatedDelegate, Status<\/span> status)\n{\n}<\/pre>\n
    And add these line on top of the file:<\/p>\n
    using <\/span>Microsoft.ConfigurationManagement.AdminConsole;\nusing <\/span>Microsoft.ConfigurationManagement.AdminConsole.Schema;\nusing <\/span>Microsoft.ConfigurationManagement.ManagementProvider;<\/pre>\n
    That’s all!! you have an assembly that can be called from within the console. For now, it does nothing so let’s retrieve target object info and connection info.<\/p>\n
    The “result” variable contains info about selected object(s). These objects can provide information about active connection but it’s safer to rely on the “scopenode” object that will always provide this information even if no object is selected.<\/p>\n
    Add this at the beginning of your function<\/p>\n
    ConsoleParentNode<\/span> consoleParentNode = scopenode as <\/span>ConsoleParentNode;\n\nConnectionManagerBase<\/span> connectionMgr = consoleParentNode.RootConnectionNode.GetConnectionManagerInstance(\"WQL\"<\/span>);<\/pre>\n
    Now we retrieve the device ResourceID and name with :<\/p>\n
    string <\/span>deviceName = result.Properties[\"Name\"<\/span>].StringValue;\n\nstring <\/span>resourceid = result.Properties[\"ResourceID\"<\/span>].StringValue;<\/pre>\n
    The next task is to query SCCM for all collection that contains this device by submitting a WQL query to the active connection.<\/p>\n
    IResultObject<\/span> collectionList = connectionMgr.QueryProcessor.ExecuteQuery(\"SELECT CollectionID FROM SMS_FullCollectionMembership where ResourceID = \"<\/span> + resourceid);<\/pre>\n
    We will only retrieve collectionIDs. Getting the collection’s names in a single query is alittle bit trickier and will be covered later.<\/p>\n
    Now prepare a message and show it to end-users!<\/p>\n
    String<\/span> msg = deviceName + \" is presently member of collections with the following IDs:\\r\\n\"<\/span>;\n\nforeach <\/span>(IResultObject<\/span> collID in <\/span>collectionList)\n{\n    msg += collID.Properties[\"CollectionID\"<\/span>].StringValue + \"\\r\\n\"<\/span>;\n}<\/pre>\n
    Finally, show our message in a messageBox. ( don\u2019t forget to add “using <\/span>System.Windows.Forms;” on top of your file and add the corresponding reference to your project)<\/p>\n
    The complete code should look like this:<\/p>\n
    using <\/span>Microsoft.ConfigurationManagement.AdminConsole;\nusing <\/span>Microsoft.ConfigurationManagement.AdminConsole.Schema;\nusing <\/span>Microsoft.ConfigurationManagement.ManagementProvider;\nusing <\/span>System;\nusing <\/span>System.Collections.Generic;\nusing <\/span>System.Linq;\nusing <\/span>System.Text;\nusing <\/span>System.Threading.Tasks;\nusing<\/span> System.Windows.Forms;\n\nnamespace<\/span> MyFirstExtension\n{\n   public class<\/span> DeviceTools<\/span>\n   {\n      public static void<\/span> deviceCollections(object<\/span> sender, ScopeNode<\/span> scopenode, ActionDescription<\/span> action, IResultObject<\/span> result, PropertyDataUpdated<\/span> dataUpdatedDelegate, Status<\/span> status)\n      {\n         ConsoleParentNode<\/span> consoleParentNode = scopenode as<\/span> ConsoleParentNode<\/span>;\n         ConnectionManagerBase<\/span> connectionMgr = consoleParentNode.RootConnectionNode.GetConnectionManagerInstance(\"WQL\"<\/span>);\n\n         string<\/span> deviceName = result.Properties[\"Name\"<\/span>].StringValue;\n         string<\/span> resourceid = result.Properties[\"ResourceID\"<\/span>].StringValue;\n\n         IResultObject collectionList = connectionMgr.QueryProcessor.ExecuteQuery(\"SELECT CollectionID FROM SMS_FullCollectionMembership where ResourceID = \"<\/span> + resourceid);\n\n         String<\/span> msg = deviceName + \" is presently member of collections with the following IDs:\\r\\n\"<\/span>;\n\n         foreach<\/span> (IResultObject<\/span> collID in<\/span> collectionList)\n         {\n            msg += collID.Properties[\"CollectionID\"<\/span>].StringValue + \"\\r\\n\"<\/span>;\n         }\n         MessageBox<\/span>.Show(msg, \"message\"<\/span>);\n      }\n   }\n}<\/pre>\n
    Switch to “Release”
    \n\"\"<\/p>\n
    and build the solution.<\/p>\n
    Browse your disk to your project folder<\/p>\n
    \"\"<\/p>\n
    And copy your Dll to a more dedicated folder (i.e: C:\\Program Files (x86)\\myCompany\\myextension)<\/p>\n
    It’s time to modify our XML file to link the console to our dll.<\/p>\n
    The Class of the ActionDescription becomes “AssemblyType” and the “Executable” section is replaced by a corresponding “ActionAssembly” section.<\/p>\n
    <ActionDescription Class=\"AssemblyType\" DisplayName=\"show collections\" MnemonicDisplayName=\"show collections\" Description=\"Shows the list of collection IDs this device is member of\">\n   <ShowOn>\n      <string>ContextMenu<\/string>\n      <string>DefaultHomeTab<\/string>\n   <\/ShowOn>\n   <ActionAssembly><\/strong><\/em>\n      <Assembly>C:\\Program Files (x86)\\myCompany\\myextension\\MyFirstExtension.dll<\/Assembly><\/strong><\/em>\n      <Type>MyFirstExtension.DeviceTools<\/Type><\/strong><\/em>\n      <Method>deviceCollections<\/Method><\/strong><\/em>\n   <\/ActionAssembly><\/strong><\/em>\n<\/ActionDescription><\/pre>\n
    Note that the “Type” item is composed of our assembly namespace followed by the class name.<\/p>\n
    As usually, save this file and copy it in the dedicated folders.<\/p>\n
    As I wrote before, this is not a C# programming course so the code is not optimal (no exception or error management …). There are a lot of good tutorials on the internet for that. With a little bit of reading and the Configuration Manager SDK code samples, I’m sure you will be able to do what you need.<\/p>\n","protected":false},"excerpt":{"rendered":"
    Build your first extension -> device info You might wonder why creating an extension on a C# assembly instead of writing a vbs, powershell ,\u2026. Script ? I see two advantages to do so: you can directly rely on the console’s connection information, no need to manage the connection on your own. The external executable … Continue reading “Part 2 – First c# extension”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_sitemap_exclude":false,"_sitemap_priority":"","_sitemap_frequency":""},"_links":{"self":[{"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/pages\/15"}],"collection":[{"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=15"}],"version-history":[{"count":4,"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/pages\/15\/revisions"}],"predecessor-version":[{"id":79,"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/pages\/15\/revisions\/79"}],"wp:attachment":[{"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=15"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}