{"id":2449,"date":"2011-07-03T11:49:53","date_gmt":"2011-07-03T09:49:53","guid":{"rendered":"http:\/\/contoso.se\/blog\/?p=2449"},"modified":"2011-07-04T21:01:33","modified_gmt":"2011-07-04T19:01:33","slug":"how-to-build-a-custom-activity-with-qik-and-powershell","status":"publish","type":"post","link":"http:\/\/contoso.se\/blog\/?p=2449","title":{"rendered":"How-to build custom activities with QIK and PowerShell"},"content":{"rendered":"

In this blog post I will show you how to build\u00c2\u00a0two custom activities based on PowerShell commands. I will be using the Orchestrator beta and Quick Integration Kit 3. The\u00c2\u00a0Quick Integration\u00c2\u00a0Kit (QIK) enables you to extend\u00c2\u00a0your library of activities, with new custom integration packs and activities. QIK features a Command Line Interface (CLI) Wizard that allows you to describe how to run Command Line Interfaces (such as Windows Commands, SSH or PowerShell) and capture their output as Published Data. The QIK CLI Wizard provides a mechanism for very rapidly producing activities without the need for programming, given the readily available libraries of PowerShell from Microsoft and other community sources.\u00c2\u00a0In this blog post we will build two activities, one for counting files in a folder and one for list all files with a specific extension (for example mp3 files) in a folder. We will use\u00c2\u00a0QIK CLI that will help us build an integration pack (IP) around in this scenario two PowerShell commands. Let\u00c2\u00b4s start with the one counting files<\/p>\n

    \n
  1. Start Opalis\u00c2\u00a0QIK CLI. After default installation of QIK there will be a shortcut on your desktop<\/li>\n
  2. Welcome to the Opalis QIK CLI, click Next<\/li>\n
  3. Assembly QIK CLI, input a name for example ContosoFileAssembly<\/li>\n
  4. Assembly QIK CLI, browse and input where the file will be created, for example C:\\TEMP\\FILEIP\\ContosoFileIPAssembly.dll<\/li>\n
  5. Assembly QIK CLI, click Next<\/li>\n
  6. Commands, click Add…<\/li>\n
  7. Add\/Edit Command, General, input\n
      \n
    1. Name: Count Files in Folder<\/li>\n
    2. Mode: Run Windows PowerShell
      \n\"\"<\/a><\/li>\n<\/ol>\n<\/li>\n
    3. Add\/Edit Command, Arguments,\n
        \n
      1. Click Add under Parameters<\/li>\n
      2. Add\/Edit Parameter, input\n
          \n
        1. Name: Folder<\/li>\n
        2. Usage mode: Command Argument<\/li>\n
        3. Display Style: Folder<\/li>\n
        4. Echo as published data: Check<\/li>\n
        5. Click OK
          \n          \"\"<\/a><\/li>\n<\/ol>\n<\/li>\n
        6. Add\/Edit Command, Arguments, input “get-childitem $(Folder) | measure-object -property length” as command line. Click OK
          \n          \"\"<\/a><\/li>\n<\/ol>\n<\/li>\n
        7. Add\/Edit Command, Published Data, click Add\n
            \n
          1. Add\/Edit Published Data, input\n
              \n
            1. Name: _Count (We use _ in front of all object-specific published data, then it is easier to see it in the list of published data when working in the console. Thanks to Robert Hearn for that tip)<\/li>\n
            2. Property: Count<\/li>\n
            3. Description: Number of files in folder<\/li>\n
            4. Click OK
              \n              \"\"<\/a><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n
            5. Add\/Edit Command, Published Data, click OK<\/li>\n
            6. Commands, click Next<\/li>\n
            7. Click Finish<\/li>\n<\/ol>\n

              We now have a dll file, a .NET assembly. We can now use the invoke .NET activity in the QIK IP to test the DLL before we build the IP. Start the System Center Orchestrator Runbook Designer and build a simple runbook to use the Invoke .NET activity and a Send Platform Event activity. To get the\u00c2\u00a0Invoke .NET activity you need to import the QIK IP. It is located at C:\\Program Files (x86)\\Opalis Software\\Quick Integration Kit 3\\Integration Packs after default QIK installation. Don’t forget to input a folder under Properties of the Invoke .NET activity. Configure the Send Platform Event activity to publish the count data from the Invoke .NET activity. Run the policy and verify that you get a result in the Send Platform Event activity.<\/p>\n

              \"\"<\/a><\/p>\n

              \"\"<\/a><\/p>\n

              \"\"<\/a><\/p>\n

              Time to add the second activity, that should list all files with a specific extension in a folder.<\/p>\n

                \n
              1. Start QIK CLI again, on the Welcome screen, click “Load from QIK CLI Assembly” and select your dll file (C:\\TEMP\\FILEIP\\ContosoFileIPAssembly.dll)<\/li>\n
              2. Assembly Details,\u00c2\u00a0click Assembly Information and raise version to 1.0.0.1. Click OK<\/li>\n
              3. Assembly Details, click Next<\/li>\n
              4. Commands, click Add…\n
                  \n
                1. Input the following settings\n
                    \n
                  1. General, Name: List specific files in folder<\/li>\n
                  2. General, Mode: Run Windows PowerShell<\/li>\n
                  3. Arguments, Parameters, add\n
                      \n
                    1. Name: Folder<\/li>\n
                    2. Usage mode: Command Argument<\/li>\n
                    3. Display Style: Folder<\/li>\n
                    4. Echo as published data: Check<\/li>\n<\/ol>\n<\/li>\n
                    5. Arguments, Parameters, add\n
                        \n
                      1. Name: File Extension<\/li>\n
                      2. Usage mode: Command Argument<\/li>\n
                      3. Display Style: Text<\/li>\n
                      4. Echo as published data: Check<\/li>\n<\/ol>\n<\/li>\n
                      5. Arguments, Command Line, input “(Get-childitem $(Folder) | where {$_.Extension -eq ‘$Extension)’})
                        \n\"\"<\/a><\/li>\n
                      6. Published Data, add\n
                          \n
                        1. Name: _Fullname<\/li>\n
                        2. Property: fullname<\/li>\n
                        3. Description: File path<\/li>\n<\/ol>\n<\/li>\n
                        4. Published Data, add\n
                            \n
                          1. Name: _Name<\/li>\n
                          2. Property: name<\/li>\n
                          3. Description: Name of the file<\/li>\n<\/ol>\n<\/li>\n
                          4. Published Data, add\n
                              \n
                            1. Name: _Length<\/li>\n
                            2. Property: Length<\/li>\n
                            3. Description: File size<\/li>\n<\/ol>\n<\/li>\n
                            4. Published Data, click OK
                              \n                              \"\"<\/a><\/li>\n<\/ol>\n<\/li>\n
                            5. Commands, click Next<\/li>\n
                            6. When the wizard complete successfully you can can test the new command in the console with the .NET Invoke activity. Else, to build the integration pack, click Build Integration Pack. It is the same wizard that you can start direct from the shortcut “QIK Wizard”<\/li>\n<\/ol>\n<\/li>\n
                            7. Opalis Quick Integration Kit Wizard, product details, input\n
                                \n
                              1. Category Name: Contoso File Management<\/li>\n
                              2. Manufacturer: Contoso<\/li>\n<\/ol>\n<\/li>\n
                              3. Opalis Quick Integration Kit Wizard, product details, click Next<\/li>\n
                              4. Opalis Quick Integration Kit Wizard, objects, click Next<\/li>\n
                              5. Opalis Quick Integration Kit Wizard, dependencies, click Next<\/li>\n
                              6. Opalis Quick Integration Kit Wizard, Opalis Integration Pack File, input where to create the IP, for example C:\\TEMP\\FILEIP\\ContosoFile.oip . Click Next<\/li>\n
                              7. Opalis Quick Integration Kit Wizard, The QIK Wizard Succeeded, click Finish<\/li>\n<\/ol>\n

                                Now, use the Deployment manager to register IP with Orchestrator Management server and deploy IP to runbook servers and runbook designers. You can then use your new integration pack and activities in runbooks \ud83d\ude42<\/p>\n

                                \"\"<\/a><\/p>\n

                                Please note that this is provided \u00e2\u20ac\u0153as is\u00e2\u20ac\u009d with no warranties at all. If you want to take a look at my demo files\u00c2\u00a0send me a e-mail, I will upload them after some extra activites has been added.\u00c2\u00a0Download QIK here<\/a>.<\/p>\n

                                 <\/p>\n","protected":false},"excerpt":{"rendered":"

                                In this blog post I will show you how to build\u00c2\u00a0two custom activities based on PowerShell commands. I will be using the Orchestrator beta and Quick Integration Kit 3. The\u00c2\u00a0Quick Integration\u00c2\u00a0Kit (QIK) enables you to extend\u00c2\u00a0your library of activities, with new custom integration packs and activities. QIK features a Command Line Interface (CLI) Wizard that … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0},"categories":[58,60],"tags":[],"_links":{"self":[{"href":"http:\/\/contoso.se\/blog\/index.php?rest_route=\/wp\/v2\/posts\/2449"}],"collection":[{"href":"http:\/\/contoso.se\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/contoso.se\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/contoso.se\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/contoso.se\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2449"}],"version-history":[{"count":23,"href":"http:\/\/contoso.se\/blog\/index.php?rest_route=\/wp\/v2\/posts\/2449\/revisions"}],"predecessor-version":[{"id":2483,"href":"http:\/\/contoso.se\/blog\/index.php?rest_route=\/wp\/v2\/posts\/2449\/revisions\/2483"}],"wp:attachment":[{"href":"http:\/\/contoso.se\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2449"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/contoso.se\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2449"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/contoso.se\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2449"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}