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 将不生成任何输出。