Start-WorkflowInstance: return GUID of created WorkflowInstance

Author: James May

Commands/Workflows/StartWorkflowInstance.cs

@@ -1,15 +1,20 @@
-using System.Management.Automation;
+using System;
+using System.Collections.Generic;
+using System.Management.Automation;
+
 using Microsoft.SharePoint.Client;
+using Microsoft.SharePoint.Client.WorkflowServices;
+
 using PnP.PowerShell.CmdletHelpAttributes;
 using PnP.PowerShell.Commands.Base.PipeBinds;
-using Microsoft.SharePoint.Client.WorkflowServices;
-using System.Collections.Generic;
 
 namespace PnP.PowerShell.Commands.Workflows
 {
     [Cmdlet(VerbsLifecycle.Start, "PnPWorkflowInstance")]
     [CmdletHelp("Starts a SharePoint 2010/2013 workflow instance on a list item",
         DetailedDescription = "Allows starting a SharePoint 2010/2013 workflow on a list item in a list",
+        OutputType = typeof(Guid),
+        OutputTypeDescription = "Returns the GUID of the new workflow instance",
         Category = CmdletHelpCategory.Workflows,
         SupportedPlatform = CmdletSupportedPlatform.All)]
     [CmdletExample(
@@ -56,11 +61,16 @@ protected override void ExecuteCmdlet()
 
             var inputParameters = new Dictionary<string, object>();
 
+
+
             WorkflowServicesManager workflowServicesManager = new WorkflowServicesManager(ClientContext, SelectedWeb);
             WorkflowInstanceService instanceService = workflowServicesManager.GetWorkflowInstanceService();
 
-            instanceService.StartWorkflowOnListItem(subscription, ListItemID, inputParameters);
+            var instanceResult = instanceService.StartWorkflowOnListItem(subscription, ListItemID, inputParameters);
+
             ClientContext.ExecuteQueryRetry();
+
+            WriteObject(instanceResult.Value);
         }
     }
 }