New-SCSMWorkflow

Specifies the name of the class that will start the workflow when it changes. This can be one of the following values: Configuration, Change, Incident, ManualActivity, ReviewActivity, and DeploymentActivity.

Specifies the name of the computer on which the System Center Data Access service is running.

Specifies the credential to use when connecting to the System Center Data Access service. If this is not provided or null, the current user context will be used.

Specifies an object that represents criteria to restrict the result set.

Provides a unique descriptive text for the workflow.

Specifies the name of the workflow to create.

Enables the workflow.

Enables or disables notifications from the workflow. Specify $true to enable notifications, or $false to disable them.

Specifies the condition under which the workflow will be started. Specify Create or Update.

Specifies the management pack in which to store the new workflow. If the specified management pack is sealed, a terminating error of InvalidOperation is generated.

Specifies a hash table of users and templates to be used for notifications from the workflow.

Specifies the output object that represents the new workflow object. This output object can be passed to other cmdlets.

Specifies an object that represents a session to a Service Manager management server.

Specifies the template to be applied to the objects which are affected by the workflow.

Prompts you for confirmation before executing the command.

Describes what would happen if you executed the command without actually executing the command.

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

This command creates a new workflow which can be used when a manual activity is created. Because no criteria is provided, this workflow applies to any creation of a manual activity.

PS C:\>$arguments = @{
>>  DisplayName = "My new manual activity workflow"
>>  Description = "This is a description"
>>  Event = "Create"
>>  Enable = $true
>>  Class = "ManualActivity"
>>  Template = Get-SCSMObjectTemplate -name DefaultManualActivityTemplate
>>  Notification = @{ 
>>          User = "Reviewers"
>>          Template = Get-SCSMObjectTemplate -name AssignedToUserNotificationTemplate
>>      },@{ 
>>          User = "Affected User"
>>          Template = Get-SCSMObjectTemplate -name DefaultReviewActivityTemplate 
>>      }
>>  }
PS C:\>New-SCSMWorkflow @arguments

This command creates a new workflow which can be used when a manual activity is created. First, criteria is defined for the manual activity to select only those manual activities that were created by the user "Haven Ford".

PS C:\>$criteriaString = @'
>>  <Criteria>
>>   <Expression>
>>    <SimpleExpression>
>>     <ValueExpression>
>>      <Property State="Post">
>>  $Context/$Path[Relationship='System.WorkItem.Library!System.WorkItemCreatedByUser' TypeConstraint='System!System.Domain.User']/Property[Type='System!System.Domain.User']/UserName$
>>      </Property>
>>     </ValueExpression>
>>     <Operator>Equal</Operator>
>>     <ValueExpression>
>>      <Value>Haven Ford</Value>
>>     </ValueExpression>
>>    </SimpleExpression>
>>   </Expression>
>>  </Criteria>
>>  '@
PS C:\>$mp = Get-SCSMManagementPack -name MyWorkflows

PS C:\> $arguments = @{
>>  DisplayName = "My new manual activity workflow"
>>  Description = "This is a description"
>>  Event = "Create"
>>  Enable = $false
>>  Criteria = $CriteriaString
>>  Class = "ManualActivity"
>>  ManagementPack = $mp
>>  Template = Get-SCSMObjectTemplate -name DefaultManualActivityTemplate
>>  Notification = @{ 
>>          User = "Reviewers"
>>          Template = Get-SCSMObjectTemplate -name AssignedToUserNotificationTemplate
>>      },@{ 
>>          User = "Affected User"
>>          Template = Get-SCSMObjectTemplate -name DefaultReviewActivityTemplate 
>>      }
>>  }
PS C:\>New-SCSMWorkflow @arguments