New-SCSMWorkflow
在 Service Manager 中建立新工作流程。
Syntax
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>]
Description
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 資料存取服務執行所在的電腦名稱。 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 資料存取服務執行所在伺服器的認證。 指定的使用者帳戶必須具有該伺服器的存取權限。
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 不會產生任何輸出。