New-SCSMWorkflow

在 Service Manager 中创建新工作流。

语法

New-SCSMWorkflow
   -Class <String>
   [-DisplayName] <String>
   [-Description <String>]
   [-Enable <Boolean>]
   [-Event <WorkflowEvent>]
   [-ManagementPack <ManagementPack>]
   [-Criteria <String>]
   [-Template <ManagementPackObjectTemplate>]
   [-EnableNotification <Boolean>]
   [-Notification <Hashtable[]>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-SCSMWorkflow cmdlet 在 Service Manager 中创建工作流。

示例

示例 1:创建手动创建活动的工作流

PS C:\>$Template = Get-SCSMObjectTemplate -Name "DefaultManualActivityTemplate"
PS C:\> $Notification = @{ User = "Reviewers"; Template = Get-SCSMObjectTemplate -Name "AssignedToUserNotificationTemplate" },@{ User = "Affected User"; Template = Get-SCSMObjectTemplate -Name DefaultReviewActivityTemplate }
PS C:\> New-SCSMWorkflow -DisplayName "Manual activity workflow 07" -Class "ManualActivity" -Description "Contoso workflow 07." -Enable $True -Event Create -Notification $Notification -Template $Template

第一个命令使用 Get-SCSMObjectTemplate cmdlet 获取名为 DefaultManualActivityTemplate 的模板。 命令将模板存储在 $Template 变量中。

第二个命令创建一个通知数组作为哈希表,并将其存储在 $Notification 变量中。

最后一个命令创建可在创建手动活动时使用的工作流。 由于脚本未指定任何条件,因此此工作流适用于手动活动的任何创建。

示例 2:为用户创建手动活动创建工作流

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>Evan Narvaez</Value>
>>     </ValueExpression>
>>    </SimpleExpression>
>>   </Expression>
>>  </Criteria>
>>  '@
PS C:\> $ManagementPack = Get-SCSMManagementPack -Name "Workflows"
PS C:\> $Template = Get-SCSMObjectTemplate -Name "DefaultManualActivityTemplate"
PS C:\> $Notification = @{ User = "Reviewers"; Template = Get-SCSMObjectTemplate -Name AssignedToUserNotificationTemplate },@{ User = "Affected User"; Template = Get-SCSMObjectTemplate -Name DefaultReviewActivityTemplate }
PS C:\> New-SCSMWorkflow -DisplayName "Manual activity workflow 09" -Class "ManualActivity" -Criteria $CriteriaString -Description "Contoso workflow 09." -Enable $False -Event Create -ManagementPack $ManagementPack -Template $Template

第一个命令创建为手动活动定义的条件字符串,以仅选择用户 Evan Narvaez 创建的手动活动。 命令将这些条件存储在 $CriteriaString 变量中。

第二个命令使用 Get-SCSMManagementPack cmdlet 获取名为 Workflows 的管理包,然后将其存储在 $ManagementPack 变量中。 后续命令使用此值指定工作流的保存位置。 这不能是密封的管理包。

第三个命令使用 Get-SCSMObjectTemplate cmdlet 获取名为 DefaultManualActivityTemplate 的模板。 命令将模板存储在 $Template 变量中。

第四个命令创建通知数组作为哈希表,并将其存储在 $Notification 变量中。

最后一个命令创建可在创建手动活动时使用的工作流。

参数

-Class

指定在工作流更改时启动工作流的类的名称。 有效值为:

  • 配置
  • 更改
  • 事件
  • ManualActivity
  • ReviewActivity
  • DeploymentActivity
Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

指定运行 System Center Data Access 服务的计算机的名称。 Credential 参数中指定的用户帐户必须具有对指定计算机的访问权限。

Type:System.String[]
Position:Named
Default value:Localhost
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

指定此 cmdlet 用于连接到运行 System Center Data Access 服务的服务器的凭据。 指定用户帐户必须具有对该服务器的访问权限。

Type:System.Management.Automation.PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Criteria

指定表示用于限制结果集的条件的对象。

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

指定工作流的说明。

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

指定要创建的工作流的名称。

Type:System.String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Enable

指示此 cmdlet 是启用或禁用工作流。

Type:System.Boolean
Position:Named
Default value:True
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableNotification

指示此 cmdlet 是启用或禁用工作流中的通知。

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Event

指定工作流启动的条件。 有效值为:

  • 创建
  • 更新
Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Workflows.WorkflowEvent
Accepted values:Create, Update
Position:Named
Default value:Created
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementPack

指定要在其中存储工作流的管理包。 不要指定密封的管理包。

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Position:Named
Default value:The default management pack
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Notification

指定要用于来自工作流的通知的用户和模板的哈希表。

Type:System.Collections.Hashtable[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

指示此 cmdlet 返回此 cmdlet 创建的工作流。 可以将此对象传递给其他 cmdlet。

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

指定表示与 Service Manager 管理服务器的会话的对象。

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Template

指定要应用于工作流影响的对象的模板。

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

None.

不能通过管道将输入传递给此 cmdlet。

输出

None.

此 cmdlet 将不生成任何输出。