Service Manager 撰寫工具工作流程活動參考

發行項
03/07/2024

重要

此版本的 Service Manager 已達到終止支援。建議您升級至 Service Manager 2022。

本文提供資訊技術 (IT) 開發人員的指引，讓他們能夠建立自定義的 Windows Workflow Foundation (WF) 活動，IT 專業人員可用來建置 IT 程式專屬的 WF 工作流程。自定義 WF 活動會擴充活動連結庫—使用 Service Manager 撰寫工具散發的活動。本文件的<工作流程活動參考資料>一節提供活動程式庫中預設 WF 活動的詳細資料。這些資訊的目的在於協助開發人員 (或擔任開發人員的 IT 專業人員) 根據需求建立自訂 WF 活動。

如需如何使用 WF 活動和 WF 工作流程搭配 Service Manager 的資訊，請參閱使用工作流程將 IT 程序自動化。

Active Directory 活動

使用 Active Directory 網域服務 (AD DS) 活動，讓 Active Directory 在 Service Manager 中運作工作流程的一部分。

Service Manager 撰寫工具會在 [活動工具箱] 窗格的 [Active Directory 活動] 群組中提供兩個預設 Service Manager 活動。本文中的各節說明這些活動。

將 AD DS 電腦新增至群組活動

此活動會將電腦新增至 Service Manager 中 Active Directory 網域服務 (AD DS) 中的安全組。計算機和群組必須屬於相同的網域，而且會搜尋網域中的所有容器。

設計時間必要條件	運行時間必要條件
無	當您使用此活動時，請確定 Service Manager 工作流程帳戶有足夠的許可權可修改 AD DS 中的安全組。

屬性

將AD DS 電腦新增至群組活動會使用下表所述的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
電腦網域	ComputerDomain	字串	是	計算機所在的完整 DNS 功能變數名稱 (例如，contoso.com) 。
電腦名稱	FullyQualifiedComputerName	字串	是	電腦的名稱。
群組名稱	FullyQualifiedGroupName	字串	是	Active Directory 網域服務群組的名稱。

將 AD DS 電腦新增至群組活動會產生下表所述的輸出。

顯示名稱	內部名稱	類型	Description
輸出	輸出	Boolean	作業的結果：如果加法成功，則為 True ; 如果失敗，則為 False。

錯誤和例外狀況	備註	範例
無	無	無

將 AD DS 使用者新增至群組活動

此活動會將使用者新增至 Service Manager 中 Active Directory 網域服務 (AD DS) 中的安全組。使用者和群組必須屬於相同網域，且網域中的所有容器中都能被搜尋。

設計時間必要條件	運行時間必要條件
無	當您使用此活動時，請確定 Service Manager 工作流程帳戶有足夠的許可權可修改 AD DS 中的安全組。

屬性

將 AD DS 使用者新增至群組活動會使用下表所列的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
使用者網域	UserDomain	字串	是	使用者完整的網域名稱 (FQDN)。
使用者名稱	使用者名稱	字串	是	使用者的登入名稱。
群組名稱	FullyQualifiedGroupName	字串	是	群組的 FQDN。

將 AD DS 使用者新增至群組活動會產生下表所述的輸出。

顯示名稱	內部名稱	類型	Description
輸出	輸出	Boolean	作業的結果：如果加法成功，則為 True ，如果失敗則為 False 。

錯誤和例外狀況	備註	範例
無	無	無

控制流程活動

使用控制流程活動，為您的工作流程提供 Service Manager 中的結構—分支、迴圈或定時器延遲。

撰寫工具會在 [活動工具箱] 窗格的 [控制流程] 群組中，提供四個預設的控制流程活動。

延遲活動

此活動會在工作流程中引進 Service Manager 中的活動之間的延遲。 Delay 活動衍生自 Microsoft .NET Framework DelayActivity 類別。

設計時間必要條件	運行時間必要條件
無	無

屬性

Delay 活動會使用下表所列的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
初始化 TimeoutDuration	InitializeTimeoutDuration		內部	指定要初始化 TimeoutDuration 屬性的處理程式。
TimeoutDuration	TimeoutDuration	Timespan	Yes	延遲的持續時間。

Delay 活動不會產生輸出屬性。

錯誤和例外狀況	備註	範例
無	如需此活動的詳細資訊，請參閱 .NET Framework 類別庫中的 DelayActivity 類別。	無

針對每個循環活動

For Each 循環活動會接受數位 (集合) 物件的輸入，並針對集合中的每個物件重複迴圈內的活動集合。例如，如果輸入集合有五個物件，迴圈會逐一查看五次。如果集合是空的，迴圈就不會逐一查看。集合中的物件數目沒有上限。 For Each 循環活動一律會在工作流程執行所在的計算機上執行。

For Each 循環活動是具有兩個活動容器的複合活動：

輸入容器：此活動會設定迴圈並定義輸入集合。您可以使用此角色中的 取得事件 或 取得虛擬機 活動。
迴圈容器：名為 ForEachChildActivity，此活動包含循環活動。您在此容器中放置的大部分 Windows Workflow Foundation (WF) 活動都有兩個額外的屬性：目前要系結的項目和屬性。針對迴圈容器內的每個活動，設定這些內容如下：
1. 將 [目前專案] 設定為 ForEach 活動的 [迴圈容器] 活動的 [目前專案] 屬性。如果此活動是 For Each 循環 活動中的第一個活動， 則會自動設定目前專案 。
2. 將 Property 的值設定 為 Bind 屬性的值，設定為使用 目前專案 值之目前活動的屬性值。

兩種類型的活動不會取得 Current Item 和 Property to Bind 屬性，因此無法使用輸入集合中的物件：

腳本活動，例如 Windows PowerShell 腳本活動。
自定義活動或其他未繼承自 WorkflowActivityBase 類別的活動。這類活動包括以活動基類為基礎的活動，例如原生Visual Studio活動。

設計時間必要條件	運行時間必要條件
無	無

屬性

For Each 循環活動會使用下表所述的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
輸入集合	InputCollection	陣列/物件	N/A	要一次傳遞一個物件集合至 For Each 循環活動內的活動。如果位於輸入容器中的活動產生物件的陣列做為其輸出屬性，則 Input Collection 會自動設定為該屬性。若要檢視此屬性的目前值，請以滑鼠右鍵按兩下迴圈容器，然後選取 [ 屬性]。
目前項目	CurrentItem	Object	N/A	輸入集合中的索引，迴圈內的活動可以使用做為輸入屬性。對於迴圈容器中的第一個活動，會自動設定這個屬性。

錯誤和例外狀況	備註	範例
For Each 循環活動會使用 Service Manager 提供的自定義追蹤服務，來記錄活動執行時的錯誤和例外狀況。在下列情況下，活動會產生錯誤或例外狀況︰ - 如果 ForEachLoop 活動中發生任何錯誤，且該錯誤與子活動不一樣，工作流程就會終止。 - 如果子活動內發生任何錯誤，除非 ContinueOnError=true，否則工作流程會終止。 - 如果任何輸入屬性為 Null。活動不會逐一查看。 For Each 循環活動內的每個活動都必須將自己的錯誤或例外狀況寫入自定義追蹤服務。 For Each 循環活動本身不會這麼做。	無	無

IfElse 活動

此活動可根據布林值 (True/False) 條件控制工作流程內的活動序列。您可以使用前面活動 (例如指令碼活動) 的結果作為條件。

IfElse 活動是使用規則和條件的Visual Studio活動。如需在 Windows Workflow Foundation 中使用規則和條件的詳細資訊， (WF) ，請參閱 MSDN Library 中的教學課程：在 WF 中使用規則和條件。

設計時間必要條件	運行時間必要條件
無	無

屬性

無。

錯誤和例外狀況	備註	範例
無	如需 IfElse 活動的詳細資訊，請參閱 .NET Framework 4 類別庫中的 IfElseActivity 類別。	無

平行活動

此活動可將活動順序分成兩個同時進行的活動序列分支。平行活動是Visual Studio活動。如需 ParallelActivity 類別的詳細資訊，請參閱 .NET Framework 類別庫中的 ParallelActivity 類別。

設計時間必要條件	運行時間必要條件
無	無

屬性

無。

錯誤和例外狀況	備註	範例
無	無	無

Virtual Machine Manager 活動

使用 Service Manager 中的虛擬機管理活動來建置工作流程，以允許建立和更新虛擬機。虛擬機管理活動支援 System Center Virtual Machine Manager。

Service Manager 撰寫工具會在 [活動工具箱] 窗格的 [VMM 活動] 群組中提供下列五個預設虛擬機管理活動。

取得 VM 活動

Service Manager 中的此活動會從 Virtual Machine Manager (VMM) 連結庫擷取一或多個虛擬機標識碼的清單。

設計時間必要條件	運行時間必要條件
無	- Virtual Machine Manager 控制台和 Service Manager 必須同時安裝在相同的伺服器上。 - 請確定 Service Manager 工作流程帳戶具有足夠的許可權，可修改 Active Directory 網域服務 (AD DS) 中的安全組。 - Virtual Machine Manager 控制台和 Service Manager 必須同時安裝在相同的伺服器上。 - 請確定 Service Manager 工作流程帳戶具有足夠的許可權，可修改 Active Directory 網域服務 (AD DS) 中的安全組。

屬性

取得 VM 活動使用下表中的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
參數集	ParameterSet	字串	不;預設值為 Connection。	指定針對特定用途所組織的參數子集。針對取得 VM 活動，您可以選取下列其中一個參數集： - 所有：搜尋所有可用的虛擬機。 - Id：搜尋具有已知標識碼的虛擬機。 - 連接：搜尋連線到 Virtual Machine Manager 的虛擬機， (VMM) 伺服器，該伺服器是由 VMMServer 屬性所指定。 - VMHostGroup：搜尋連線到 VM 主機屬性所指定虛擬機主機的虛擬機。
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設值為 True。)	決定此活動失敗時，工作流程是否應該繼續執行。
發生錯誤	HasError		N/A	指定此活動是否有錯誤集。 (唯讀)
全部	全部	Boolean	否。 (預設值為 True。)	如果參數集全部可用。如果設定為 True，取得 VM 活動會傳回所有可用虛擬機的虛擬機標識符清單。
識別碼	識別碼	String	如果參數集是標識碼，則為必要項。	如果參數集是標識碼，則為可用。如果設定為 True，取得 VM 活動會傳回所有虛擬機標識碼的清單，其虛擬機標識碼符合指定標識碼值的所有或部分。
管理群組	ManagementGroup	String	No	指定將執行此活動的管理群組。設定為 localhost。 (唯讀)
指令碼伺服器	目標	字串	是	指定執行 Service Manager 主控台之伺服器的網域名稱系統 (DNS) 名稱。請勿使用 localhost。
指令碼時間限制	TimeoutSeconds	整數	不可以。 (預設設定為 300 秒。)	指定允許執行活動的秒數上限。
VM 主機	VMHost	字串	如果參數集是 VMHostGroup，則需要	如果參數集是 VMHostGroup，則可用。如果選取此參數集，取得 VM 活動會傳回指定主機上執行之所有虛擬機的虛擬機標識符清單。
虛擬機器名稱	VMName	String	No	指定要搜尋之虛擬機器的名稱或部分名稱。如果字串是名稱的一部分，活動會擷取包含字串之所有虛擬機的標識符。
VMMServer	VMMServer	字串	是	指定管理虛擬機器的 System Center Virtual Machine Manager (VMM) 伺服器名稱。

取得 VM 活動會產生下表所述的輸出。

顯示名稱	內部名稱	類型	註解
VM 識別碼	VMIDList	字串陣列	指定符合 VM 名稱字串之所有或部分名稱的虛擬機識別碼清單。

錯誤和例外狀況	備註	範例
取得 VM 活動會使用由 Service Manager 提供的自訂追蹤服務，來記錄活動執行時的錯誤和例外狀況。如果無法解析任何腳本屬性，活動就會產生適當的錯誤或例外狀況。	無	無

移動 VM 活動

Service Manager 中的此活動會將虛擬機從 Virtual Machine Manager (VMM) 連結庫移至維護主機。

設計時間必要條件	運行時間必要條件
無	- Virtual Machine Manager 控制台和 Service Manager 必須同時安裝在相同的伺服器上。 - 請確定 Service Manager 工作流程帳戶具有足夠的許可權，可修改 Active Directory 網域服務 (AD DS) 中的安全組。

屬性

Move VM 活動使用下表中的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設值為 True。)	決定此活動失敗時，工作流程是否應該繼續執行。
發生錯誤	HasError		N/A	指定此活動是否有錯誤集。 (唯讀)
主機忙碌時封鎖 LM	BlockLMIfHostBusy	Boolean	否。 (預設值為 False。)	如果 Hyper-V 即時移轉因為來源主機或目的主機已經參與其他即時移轉而失敗，則封鎖重試該移轉。
作業群組	JobGroup	Guid (字串)	No	指定一系列命令的識別碼，這些命令會以集合的方式執行。
作業變數	JobVariable	String	No	指定追蹤工作進度，並將工作進度存放在這個參數命名的變數中。
管理群組	ManagementGroup	String	No	指定將執行此活動的管理群組。設定為 localhost。 (唯讀)
路徑	路徑	String	No	指定維護主機上虛擬機器的目的地。
PROTipID	PROTipID	Guid	No	指定觸發此動作的效能與資源最佳化 (PRO) 提示識別碼。允許 PRO 提示的未來稽核。
以非同步方式執行	RunAsynchronously	Boolean	否。 (預設值為 False。)	指定工作以非同步的方式執行，讓控制權立即交還命令殼層。
指令碼伺服器	目標	字串	是	指定執行 Service Manager 主控台之伺服器的網域名稱系統 (DNS) 名稱。請勿使用 localhost。
指令碼時間限制	TimeoutSeconds	整數	不可以。 (預設設定為 300 秒。)	指定允許執行活動的秒數上限。
在目標上啟動 VM	StartVMOnTarget	Boolean	否。 (預設值為 False。)	指定虛擬機器抵達其目的主機時立即啟動。
使用叢集	UseCluster	Boolean	否。 (預設值為 False。)	不論叢集是否支援 Hyper-V 即時移轉，皆強制使用 Windows Server 2008 叢集移轉，將處於儲存狀態的虛擬機器轉移到主機。
使用 LAN	UseLan	Boolean	否。 (預設值為 False。)	強制透過區域網路 (LAN) 轉移，即使可以使用更快速的方法，例如存放區域網路 (SAN) 轉移。
VM 主機	VMHostName	字串	是	指定虛擬機器將要移至的維護主機名稱。
VM 識別碼	VMID	字串	是	指定要移動之虛擬機器的唯一識別碼。
VMM 伺服器	VMMServer	字串	是	指定管理虛擬機器的 System Center Virtual Machine Manager (VMM) 伺服器名稱。

Move VM 活動會產生下表所述的輸出。

顯示名稱	內部名稱	類型	註解
VM 識別碼	VMID	字串	指定已移動之虛擬機器的唯一識別碼。除非活動找不到符合輸入 VM 識別碼的虛擬機標識碼，否則輸入 VM 識別碼和輸出 VM 識別碼相等。在此情況下，輸出 VM 識別碼會設定為 Null。

錯誤和例外狀況	備註	範例
移動 VM 活動會使用由 Service Manager 提供的自訂追蹤服務，來記錄活動執行時的錯誤和例外狀況。如果無法解析任何腳本屬性，活動就會產生適當的錯誤或例外狀況。	無	無

關機 VM 活動

此活動 Service Manager 關閉虛擬機上的客體作業系統。

只有在虛擬機上安裝虛擬化客體服務時，才能在 Windows 主機上的虛擬機上使用 關機 VM 活動， (Hyper-V 主機或虛擬伺服器主機) 。對於部署在 Hyper-V 主機上的虛擬機器，虛擬化來賓服務稱為「整合元件」。對於部署在 Virtual Server 主機上的虛擬機器，虛擬化來賓服務稱為 Virtual Machine Additions。

設計時間必要條件	運行時間必要條件
無	- Virtual Machine Manager 控制台和 Service Manager 必須同時安裝在相同的伺服器上。 - 請確定 Service Manager 工作流程帳戶具有足夠的許可權，可修改 Active Directory 網域服務 (AD DS) 中的安全組。

屬性

關機 VM 活動使用下表所述的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設值為 True。)	決定此活動失敗時，工作流程是否應該繼續執行。
發生錯誤	HasError		N/A	指定此活動是否有錯誤集。 (唯讀)
作業變數	JobVariable	String	No	指定追蹤工作進度，並將工作進度存放在這個參數命名的變數中。
管理群組	ManagementGroup	String	No	指定將執行此活動的管理群組。設定為 localhost。 (唯讀)
PROTipID	PROTipID	Guid	No	指定觸發此動作的效能與資源最佳化 (PRO) 提示識別碼。允許 PRO 提示的未來稽核。
以非同步方式執行	RunAsynchronously	Boolean	否。 (預設值為 False。)	指定工作以非同步的方式執行，讓控制權立即交還命令殼層。
指令碼伺服器	目標	字串	是	指定執行 Service Manager 主控台之伺服器的網域名稱系統 (DNS) 名稱。請勿使用 Localhost。
指令碼時間限制	TimeoutSeconds	整數	不可以。 (預設設定為 300 秒。)	指定允許執行活動的秒數上限。
VM 識別碼	VMID	字串	是	指定要關閉之虛擬機器的唯一識別碼。
VMMServer	VMMServer	字串	是	指定管理虛擬機器的 System Center Virtual Machine Manager (VMM) 伺服器名稱。

關機 VM 活動會產生下表所述的輸出。

顯示名稱	內部名稱	類型	註解
VM 識別碼	VMID	字串	指定已關閉之虛擬機器的唯一識別碼。除非活動找不到符合輸入 VM 識別碼的 VM 識別碼的虛擬機，否則輸入 VM 識別碼和輸出 VM 識別碼相等。在此情況下，輸出 VM 識別碼會設定為 Null。

錯誤和例外狀況	備註	範例
關機 VM 活動會使用 Service Manager 提供的自訂追蹤服務，來記錄活動執行時的錯誤和例外狀況。如果無法解析任何腳本屬性，活動就會視情況產生錯誤或例外狀況。	無	無

啟動 VM 活動

Service Manager 中的此活動會啟動已停止或暫停的虛擬機。

設計時間必要條件	運行時間必要條件
無	無

屬性

啟動 VM 活動會使用下表中的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設值為 True。)	決定此活動失敗時，工作流程是否應該繼續執行。
發生錯誤	HasError		N/A	指定此活動是否有錯誤集。 (唯讀)
作業變數	JobVariable	String	No	指定追蹤工作進度，並將工作進度存放在這個參數命名的變數中。
管理群組	ManagementGroup	String	No	將執行此活動的管理群組。設定為 localhost。 (唯讀)
PROTipID	PROTipID	Guid	No	指定觸發此動作的效能與資源最佳化 (PRO) 提示識別碼。允許 PRO 提示的未來稽核。
以非同步方式執行	RunAsynchronously	Boolean	否。 (預設值為 False。)	指定工作以非同步的方式執行，讓控制權立即交還命令殼層。
指令碼伺服器	目標	字串	是	指定執行 Service Manager 主控台之伺服器的網域名稱系統 (DNS) 名稱。請勿使用 localhost。
指令碼時間限制	TimeoutSeconds	整數	不可以。 (預設設定為 300 秒。)	指定允許執行活動的秒數上限。
VM 識別碼	VMID	字串	是	指定要啟動之虛擬機器的唯一識別碼。
VMMServer	VMMServer	字串	是	指定管理虛擬機器的 System Center Virtual Machine Manager (VMM) 伺服器名稱。

[啟動 VM] 活動會產生下表所述的輸出。

顯示名稱	內部名稱	類型	註解
VM 識別碼	VMID	字串	指定已啟動之虛擬機器的唯一識別碼。除非活動找不到符合輸入 VM 識別碼的虛擬機標識碼，否則輸入 VM 識別碼和輸出 VM 識別碼相等。在此情況下，輸出 VM 識別碼會設定為 Null。

錯誤和例外狀況	備註	範例
啟動 VM 活動會使用由 Service Manager 提供的自訂追蹤服務，在活動執行時記錄錯誤和例外狀況。如果無法解析任何腳本屬性，活動就會產生錯誤或例外狀況。	無	無

儲存狀態 VM 活動

此活動 Service Manager 儲存虛擬機的狀態，然後停止虛擬機。

設計時間必要條件	運行時間必要條件
無	- Virtual Machine Manager 控制台和 Service Manager 必須同時安裝在相同的伺服器上。 - 請確定 Service Manager 工作流程帳戶具有足夠的許可權，可修改 #D3F4E2F69B0E249A5B283C7EBC7F04CB2 (AD DS) 中的安全組。

屬性

儲存狀態 VM 活動會使用下表所述的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設值為 True。)	決定此活動失敗時，工作流程是否應該繼續執行。
發生錯誤	HasError		N/A	指定此活動是否有錯誤集。 (唯讀)
作業變數	JobVariable	String	No	指定追蹤工作進度，並將工作進度存放在這個參數命名的變數中。
管理群組	ManagementGroup	String	No	指定將執行此活動的管理群組。設定為 localhost。 (唯讀)
PROTipID	PROTipID	Guid	No	指定觸發此動作的效能與資源最佳化 (PRO) 提示識別碼。允許 PRO 提示的未來稽核。
以非同步方式執行	RunAsynchronously	Boolean	否。 (預設值為 False。)	指定工作以非同步的方式執行，讓控制權立即交還命令殼層。
指令碼伺服器	目標	字串	是	指定執行 Service Manager 主控台之伺服器的網域名稱系統 (DNS) 名稱。請勿使用 localhost。
指令碼時間限制	TimeoutSeconds	整數	不可以。 (預設設定為 300 秒。)	指定允許執行活動的秒數上限。
VM 識別碼	VMID	字串	是	指定要儲存之虛擬機器的唯一識別碼。
VMM 伺服器	VMMServer	字串	是	指定管理虛擬機器的 System Center Virtual Machine Manager (VMM) 伺服器名稱。

儲存 狀態 VM 活動會產生下表所述的輸出。

顯示名稱	內部名稱	類型	註解
VM 識別碼	VMID	字串	指定已儲存之虛擬機器的唯一識別碼。除非活動找不到符合輸入 VM 識別碼的 VM 識別碼的虛擬機，否則輸入 VM 識別碼和輸出 VM 識別碼相等。在此情況下，輸出 VM 識別碼會設定為 Null。

錯誤和例外狀況	備註	範例
儲存狀態 VM 活動會使用 Service Manager 提供的自訂追蹤服務，來記錄活動執行時的錯誤和例外狀況。如果無法解析任何腳本屬性，活動就會視情況產生錯誤或例外狀況。	無	無

腳本活動

使用 Service Manager 中的腳本活動，在工作流程中執行腳本。

指令碼活動會以獨立於工作流程的個別程序執行，不過，它們也是在 Service Manager 工作流程帳戶的安全性內容下執行。

Service Manager 撰寫工具會在 [活動工具箱] 窗格的 [腳本活動] 群組的 [一般腳本活動] 子群組中，提供下列三個預設腳本活動。

命令腳本活動

此活動可執行命令列指令碼作為 Windows Workflow Foundation (WF) 工作流程的一部分。

設計時間必要條件	運行時間必要條件
無	無

屬性

命令文本活動會使用下表所述的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設值為 True。)	決定此活動失敗時，工作流程是否應該繼續執行。
發生錯誤	HasError		N/A	指定此活動是否有錯誤集。 (唯讀)
管理群組	ManagementGroupName	String	No	指定指令碼伺服器所屬的管理群組。根據預設，這會設定為 localhost。 (唯讀)
指令碼參數	參數	<字典字串，字串>	Yes	指定在指令碼執行時要傳遞至指令碼的命令列參數或參數/值組。
指令碼主體	ScriptBody	字串	是	指定指令碼本身的文字。
指令碼伺服器	目標	String	No	指定執行 Service Manager 主控台之伺服器的網域名稱系統 (DNS) 名稱。請勿使用 localhost。
指令碼時間限制	TimeoutSeconds	整數	不可以。 (預設設定為 300 秒。)	指定允許執行指令碼的秒數上限。

錯誤和例外狀況	備註	範例
命令文本活動會使用 Service Manager 提供的自定義追蹤服務，來記錄活動執行時的錯誤和例外狀況。如果無法解析任何腳本屬性，活動就會視情況產生錯誤或例外狀況。	無	無

Windows PowerShell 腳本活動

Service Manager 中的這個活動會在 Windows Workflow Foundation (WF) 工作流程中執行 Windows PowerShell 腳本。

設計時間必要條件	運行時間必要條件
Windows PowerShell 文稿活動取決於設計時間的下列必要條件： - Windows PowerShell 2.0	Windows PowerShell 2.0

屬性

Windows PowerShell 文稿活動會使用下表所述的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設值為 True。)	決定此活動失敗時，工作流程是否應該繼續執行。
發生錯誤	HasError		N/A	指定此活動是否有錯誤集。 (唯讀)
管理群組	ManagementGroupName	String	No	指定指令碼伺服器所屬的管理群組。根據預設，這會設定為 localhost。 (唯讀)
指令碼參數	參數	<字典字串，字串>	Yes	指定在指令碼執行時要傳遞至指令碼的參數名稱/值清單。您可以將參數值設定為下列任何管理組件參考︰ - $Target/...$ - $MPElement[...] - $Data/...$。 $Data 參考只會於執行階段在參數中解析 (而不在指令碼本身中)。使用其中一個參考做為參數的唯一值，會將該參數設定為 XML 字串，代表 GetItemXML) 的輸入數據項 (。
指令碼主體	ScriptBody	字串	是	指定指令碼本身的文字。
嵌入式管理單元	SnapIns	String	No	清單 Windows PowerShell 嵌入式管理單元，以預先載入 Runspace。
指令碼伺服器	目標	String	No	指定執行 Service Manager 主控台之伺服器的網域名稱系統 (DNS) 名稱。請勿使用 localhost。
指令碼時間限制	TimeoutSeconds	整數	不可以。 (預設設定為 300 秒。)	指定允許執行指令碼的秒數上限。

錯誤和例外狀況	備註	範例
Windows PowerShell 文稿活動會使用由 Service Manager 提供的自定義追蹤服務，來記錄活動執行時的錯誤和例外狀況。如果無法解析任何腳本屬性，活動就會產生適當的錯誤或例外狀況。	如需 Windows PowerShell 的詳細資訊，請參閱 Windows PowerShell。	無

VBScript 腳本活動

Service Manager 中的這個活動會在 Windows Workflow Foundation (WF) 工作流程中執行 VBScript 腳本。

設計時間必要條件	運行時間必要條件
VBScript 腳本活動取決於設計時間的下列必要條件：無。	無

屬性

VBScript 腳本活動會使用下表所述的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設值為 True。)	決定此活動失敗時，工作流程是否應該繼續執行。
發生錯誤	HasError		N/A	指定此活動是否有錯誤集。 (唯讀)
管理群組	ManagementGroupName	String	No	指定指令碼伺服器所屬的管理群組。 (根據預設，這會設定為 localhost) (唯讀)
指令碼參數	參數	<字典字串，字串>	Yes	標準參數以及此指令碼執行時所使用之任何相關值的清單。
指令碼主體	ScriptBody	字串	是	指定指令碼本身的文字。
指令碼伺服器	目標	String	No	指定執行 Service Manager 主控台之伺服器的網域名稱系統 (DNS) 名稱。請勿使用 localhost。
指令碼時間限制	TimeoutSeconds	整數	不可以。 (預設設定為 300 秒。)	指定允許執行指令碼的秒數上限。

錯誤和例外狀況	備註	範例
VBScript 腳本活動會使用 Service Manager 提供的自定義追蹤服務，來記錄活動執行時的錯誤和例外狀況。如果無法解析任何腳本屬性，活動就會視情況產生錯誤或例外狀況。	無	無

Service Manager 活動

使用 Service Manager中的 Service Manager 活動，讓 Service Manager 函式成為工作流程的一部分。

Service Manager 撰寫工具會在 [活動工具箱] 窗格的 SM 活動群組中提供下列四個預設 Service Manager 活動。

建立事件活動

此活動會在 Service Manager 中建立並填入事件。

設計時間必要條件	運行時間必要條件
無	無

屬性

建立事件活動會使用下表所列的輸入屬性。

顯示名稱	內部名稱	類型	必要	註解
事件識別碼	IncidentID	字串	是	指定為 Incident 物件產生的唯一識別碼。
動作記錄註解	ActionLogComment	字串	是	指定要包含在 Incident 物件的動作記錄檔中的批注。
受影響的使用者網域	AffectedUserDomain	字串	是	指定受此事件影響之主要使用者的網域名稱系統 (DNS) 網域名稱。
受影響的使用者名稱	AffectedUserName	字串	是	指定受此事件影響之主要使用者的使用者名稱。
類別	類別	整數	是	指定事件類型，例如網路或列印。值是列舉的標識碼。 (類別 -列舉數據欄位)
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設值為 True。)	決定此活動失敗時，工作流程是否應該繼續執行。
影響	影響	整數	是	指定此事件對受影響的使用者的影響。值是列舉的標識碼。 (Impact -enum 數據類型)
Source	Source	整數	否	指定事件的相關信息來源，例如電話或電子郵件。值是列舉的標識碼。 (Source -enum 數據類型字段)
摘要	摘要	字串	是	指定描述事件的摘要文字。
急迫性	急迫性	整數	是	指定解決事件的急迫性。值是列舉的標識碼。 (急迫性 -列舉數據類型字段)

建立事件活動會產生下表所述的輸出。

名稱	類型	註解
SM 事件	System.WorkItem.Incident	傳回建構的事件類別執行個體。

錯誤和例外狀況	備註	範例
無	無	無

取得事件活動

此活動會擷取 Service Manager 中的一或多個事件。

設計時間必要條件	運行時間必要條件
無	無

屬性

取得事件活動會使用下表所列的輸入屬性。

顯示名稱	內部名稱	類型	必要	註解
受影響的使用者網域	AffectedUserDomain	String	No	指定受此事件影響之主要使用者的網域名稱系統 (DNS) 網域名稱。
受影響的使用者名稱	AffectedUserName	String	No	指定受此事件影響之主要使用者的使用者名稱。
類別	類別	整數	否	指定事件類型，例如網路或列印。此值是列舉的標識碼。 (Category -enum 數據欄位)
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設為 "True"。)	決定此活動失敗時，工作流程是否應該繼續執行。
事件識別碼	IncidentID	String	No	指定針對事件物件產生的唯一識別碼。
搜尋類型	SearchType	整數嗎？	No	指定與活動搭配使用的搜尋類型標題。
狀態	狀態	整數	否	指定事件的狀態。此值是列舉的標識碼。 (狀態 -列舉數據欄位)
摘要文字	SummaryText	String	No	指定描述事件的摘要文字。

取得事件活動會產生下表所述的輸出。

顯示名稱	內部名稱	類型	註解
SM 事件	SMIncidents	System.WorkItem.Incident 的陣列	指定事件物件的陣列。

錯誤和例外狀況	備註	範例
無	取得事件活動有自己的驗證程式，可對輸入屬性執行錯誤驗證。	無

更新事件活動

Service Manager 中的這個活動會將屬性變更儲存至一個 Service Manager 事件。

設計時間必要條件	運行時間必要條件
無	無

屬性

更新事件活動會使用下表所述的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
動作記錄註解	ActionLogComment	String	No	指定要包含在 Incident 物件的動作記錄檔中的批注。
受影響的使用者網域	AffectedUserDomain	String	No	指定受此事件影響之主要使用者的網域名稱系統 (DNS) 網域名稱。
受影響的使用者名稱	AffectedUserName	String	No	指定受此事件影響之主要使用者的使用者名稱。
類別	類別	整數	否	指定事件類型，例如網路或列印。值是列舉的標識碼。 (Category -enum 數據類型)
發生錯誤時仍繼續	ContinueOnError	Boolean	否。 (預設值為 True。)	決定此活動失敗時，工作流程是否應該繼續執行。
影響	影響	整數	否	指定此事件對受影響的使用者的影響。值是列舉的標識碼。 (Impact -enum 數據類型)
Source	Source	整數	否	指定事件的相關信息來源，例如電話或電子郵件。值是列舉的標識碼。 (Source -enum 數據類型)
Service Manager 事件	SMIncident	System.WorkItem.Incident	No	要更新的建構事件類別執行個體。
狀態	狀態	整數	否	指定產生活動之事件的狀態。值是列舉的標識碼。 (Status -enum 數據類型)
摘要	摘要	String	No	指定描述事件的摘要文字。
急迫性	急迫性	整數	否	指定解決事件的急迫性。值是列舉的標識碼。 (急迫性 -列舉數據類型字段)

更新事件活動會產生下表所述的輸出。

顯示名稱	內部名稱	類型	Description
SM 事件	SMIncident	System.WorkItem.Incident	傳回事件類別執行個體的更新。除非活動找不到SM事件，否則輸入SM事件和輸出SM事件相等。在此情況下，輸出 SM事件會設定為Null。

錯誤和例外狀況	備註	範例
無	無	無

將 [活動狀態] 設定為 [已完成] 活動

此活動會更新 Service Manager 中的自動化活動狀態。

設計時間必要條件	運行時間必要條件
無	無。

屬性

將 [活動狀態] 設定為 [已完成] 活動會使用下表所述的輸入屬性。

顯示名稱	內部名稱	類型	必要	Description
活動識別碼	ActivityID	字串	是	指定自動化活動物件的 Service Manager 識別碼。

錯誤和例外狀況	備註	範例
無	當您在由 Service Manager 自動化活動觸發的工作流程中使用此活動時，請輸入 $Data/BaseManagedEntityId$ 作為此屬性的值。此值適用於觸發工作流程執行之自動化活動的 [將活動狀態設定為已完成 ] 活動。	無