ServiceInstall 資料表

ServiceInstall 資料表是用來安裝服務，並具有下列資料行。

資料行	類型	答案	Nullable
ServiceInstall	識別碼	Y	N
名稱	格式 化	N	N
DisplayName	格式 化	N	Y
ServiceType	DoubleInteger	N	N
StartType	DoubleInteger	N	N
ErrorControl	DoubleInteger	N	N
LoadOrderGroup	格式 化	N	Y
相依性	格式 化	N	Y
StartName	格式 化	N	Y
密碼	格式 化	N	Y
引數	格式 化	N	Y
元件_	識別碼	N	N
Description	格式 化	N	Y

 

資料行

ServiceInstall

這是資料表的主鍵。

名字

此資料行是提供要安裝之服務名稱的字串。 字串的長度上限為 256 個字元。 服務控制管理員資料庫會保留服務名稱中的字元大小寫，但服務名稱的比較不區分大小寫。 正斜線 (/) 和反斜線 (\) 不正確服務名稱字元。

DisplayName

此資料行是使用者介面程式用來識別服務的可當地語系化字串。 字串的長度上限為 256 個字元。 服務控制管理員會保留顯示名稱的大小寫，但顯示名稱比較不區分大小寫。

ServiceType

此資料行是一組指定服務類型的位旗標。 必須在此資料行中指定下列其中一個服務類型。

服務類型	值	Description
SERVICE_WIN32_OWN_PROCESS	0x00000010	執行其本身進程的 Microsoft Win32 服務。
SERVICE_WIN32_SHARE_PROCESS	0x00000020	共用進程的 Win32 服務。
SERVICE_INTERACTIVE_PROCESS	0x00000100	與桌面互動的 Win32 服務。 這個值不能單獨使用，而且必須加入至上述兩種類型之一。使用這個旗標時，StartName 資料行必須設定為 LocalSystem 或 null。

 

不支援下列類型的服務。

服務類型	值	Description
SERVICE_KERNEL_DRIVER	0x00000001	驅動程式服務。
SERVICE_FILE_SYSTEM_DRIVER	0x00000002	檔案系統驅動程式服務。

 

StartType

此資料行是一組位旗標，可指定何時啟動服務。 下列其中一種服務啟動類型必須在此資料行中指定。

服務啟動類型	值	Description
SERVICE_AUTO_START	0x00000002	在啟動系統期間啟動服務。
SERVICE_DEMAND_START	0x00000003	服務控制管理員呼叫 StartService 函式時啟動服務。
SERVICE_DISABLED	0x00000004	指定無法再啟動的服務。

 

Windows Installer 無法使用SERVICE_BOOT_START和SERVICE_SYSTEM_START選項。

ErrorControl

如果服務無法在啟動期間啟動，此資料行會指定啟動程式所採取的動作。 這些值會影響已安裝服務的 ServiceControl StartService 事件。 必須在此資料行中指定下列其中一個錯誤控制旗標。

將常數 msidbServiceInstallErrorControlVital (值 = 0x08000) 新增至下表中的旗標，指定如果無法將服務安裝到系統中，整體安裝應該會失敗。

錯誤控制旗標	值	啟動程式的動作
SERVICE_ERROR_IGNORE	0x00000000	記錄錯誤，並繼續啟動作業。
SERVICE_ERROR_NORMAL	0x00000001	記錄錯誤，顯示訊息方塊並繼續啟動作業。
SERVICE_ERROR_CRITICAL	0x00000003	如果可能，而且系統已重新開機，且已知最後一個設定良好，則會記錄錯誤。 如果啟動最後一個已知良好的組態，啟動作業就會失敗。

 

LoadOrderGroup

此資料行包含字串，此字串會命名此服務所屬的載入順序群組。 如果服務不屬於群組，請指定 null 或空字串。

依賴

此資料行是服務名稱的清單，或載入排序群組的清單，系統必須在此服務之前啟動。 以 Null 分隔清單中的名稱。 如果服務沒有相依性，請指定 Null 或空字串。 使用語法 [~] 插入 Null。 群組的相依性表示，如果嘗試啟動群組的所有成員之後，至少有一個群組成員正在執行，則此服務可以執行。

例如，若要要求系統啟動 service1 和 service2，在啟動 ServiceInstall 資料行中列出的服務之前，請在 [相依性] 資料行中輸入 service1[~]service2[~][~]。 識別碼 service1 和 service2 必須發生在資料表的主鍵中，或是已安裝的服務名稱。

您必須使用 + 來前置組名，才能區分它們與服務名稱。 若要要求系統啟動 service1 和至少一個排序群組 MyGroup 成員，再啟動 ServiceInstall 資料行中列出的服務，請輸入 service1[~]+MyGroup[~][~]。

StartName

服務會以這個資料行中的字串所指定的名稱登入。 如果服務類型SERVICE_WIN32_OWN_PROCESS請使用帳戶名稱格式：DomainName\UserName。 如果帳戶屬於內建網域，則允許指定 .\UserName。 如果服務類型SERVICE_WIN32_SHARE_PROCESS或SERVICE_INTERACTIVE_PROCESS，則必須使用 LocalSystem 帳戶。 如果 StartName 指定為 null， 則 CreateService 函式會使用 LocalSystem 帳戶，因此大部分服務都會將此資料行保留空白。

密碼

此字串是 StartName 資料行中指定的帳號名稱密碼。 請注意，使用者必須具有以服務身分登入的許可權。 如果 StartName 為 null 或空字串，則服務沒有密碼。 LocalSystem 的 Startname 為 null，因此此實例中的密碼為 Null，因此大部分服務會將此資料行保留空白。

請注意，刪除已安裝使用者名稱和密碼的服務之後，安裝程式必須先使用自訂動作來取得密碼，就無法復原服務。 安裝程式可以取得服務的所有必要資訊，但密碼是儲存在系統受保護部分。 自訂動作會提示使用者、從資料庫讀取屬性或讀取檔案，以取得密碼。 然後，自訂動作必須呼叫 ChangeServiceConfig，才能提供密碼，再重新安裝服務。

Windows Installer 不會將輸入的值寫入記錄檔的 [密碼] 欄位中。

參數

此資料行包含執行服務所需的任何命令列引數或屬性。

元件_

元件資料表第一欄的外部索引鍵。 請注意，若要使用 InstallService 資料表安裝此服務，此元件的 KeyPath 必須是服務的可執行檔。

描述

此資料行包含所設定服務的可當地語系化描述。 如果此資料行保留空白，則安裝程式會在有服務時使用服務的現有描述。 如需詳細資訊，請參閱 Microsoft Windows 軟體發展工具組 (SDK) 中的SERVICE_DESCRIPTION。 若要清除現有描述，請在此資料行中輸入 「[~]」。 這會導致新服務或現有服務的空白描述。

備註

循序資料表中的InstallServices巨集指令會處理此資料表中的資訊。 如需使用 時序表的詳細資訊，請參閱 使用序列資料表。

此資料表具有 Win32 CreateService 函式的大部分參數。

雖然可以使用使用者介面來指定服務安裝為從來源執行，但安裝程式實際上不支援這種類型的安裝。 必須安裝以本機系統許可權等級執行的服務，才能從本機硬碟執行。 請避免安裝模擬特定使用者許可權的服務，因為這可能會將安全性資料寫入記錄或系統登錄。 這可能會在系統重新開機時建立安全性問題、密碼衝突或遺失組態資料。

若要在卸載期間刪除服務， ServiceControl 資料表 中的服務必須有對應的記錄， msidbServiceControlEventUninstallDelete 旗標必須出現在 [事件] 資料行中。 安裝程式不會在卸載期間刪除 ServiceInstall 資料表中的服務，而不需要 ServiceControl 資料表中的這個專案。

如需如何保護服務的資訊，請參閱 MsiLockPermissionsEx 資料表。

驗證

ICE03
ICE06
ICE32
ICE45
ICE46
ICE66
ICE69