Win32_TerminalService 類別
Win32_TerminalService WMI 類別是Win32_Service類別的子類別。 Win32_TerminalService代表Win32_TerminalServiceToSetting關聯的Element屬性。
下列語法會從 MOF 程式碼簡化,並依字母順序包含所有已定義和繼承的屬性。
語法
[dynamic, provider("Win32_WIN32_TERMINALSERVICE_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TerminalService : Win32_Service
{
boolean AcceptPause;
boolean AcceptStop;
string Caption;
uint32 CheckPoint;
string CreationClassName;
boolean DelayedAutoStart;
string Description;
boolean DesktopInteract;
string DisplayName;
string ErrorControl;
uint32 ExitCode;
datetime InstallDate;
string Name;
string PathName;
uint32 ProcessId;
uint32 ServiceSpecificExitCode;
string ServiceType;
boolean Started;
string StartMode;
string StartName;
string State;
string Status;
string SystemCreationClassName;
string SystemName;
uint32 TagId;
uint32 WaitHint;
uint32 DisconnectedSessions;
uint32 TotalSessions;
};
成員
Win32_TerminalService類別具有下列類型的成員:
方法
Win32_TerminalService類別具有這些方法。
方法 | Description |
---|---|
改變 | 修改服務。 |
ChangeStartMode | 修改服務的啟動模式。 |
建立 | 建立新的服務。 |
刪除 | 刪除現有的服務。 |
GetSecurityDescriptor | 傳回控制服務存取權的安全性描述項。 |
InterrogateService | 要求服務將其狀態更新為服務管理員。 |
PauseService | 嘗試將服務置於暫停狀態。 |
ResumeService | 嘗試將服務置於繼續狀態。 |
SetSecurityDescriptor | 寫入可控制服務存取權之安全性描述項的更新版本。 |
StartService | 嘗試將服務置於啟動狀態。 |
StopService | 將服務置於停止狀態。 |
UserControlService | 嘗試將使用者定義控制項程式碼傳送至服務。 |
屬性
Win32_TerminalService類別具有這些屬性。
-
AcceptPause
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_PAUSE_CONTINUE「) , DisplayName (「服務接受暫停」)
指出服務是否可以暫停。
此屬性繼承自 Win32_BaseService。
-
-
AcceptStop
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_STOP「) , DisplayName (」Service Accepts Stop「)
指出是否可以停止服務。
此屬性繼承自 Win32_BaseService。
-
-
標題
-
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MaxLen (64) 、 DisplayName (「Caption」)
服務一行字串的簡短描述。
此屬性繼承自 CIM_ManagedSystemElement。
-
-
檢查站
-
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞:MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwCheckPoint「) ,DisplayName (」Check Point Count「)
服務會定期遞增,以在長時間啟動、停止、暫停或繼續作業期間報告其進度。 例如,當服務啟動時完成初始化的每個步驟時,服務就會遞增此值。 在服務上叫用作業的使用者介面程式會使用這個值,在冗長的作業期間追蹤服務的進度。 這個值無效,當服務沒有啟動、停止、暫停或繼續作業擱置時,應該為零。
此屬性繼承自 Win32_Service。
-
-
CreationClassName
-
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: CIM_Key、 DisplayName (「類別名稱」)
要出現在實例建立時所使用之繼承鏈結中之第一個具體類別的名稱。 與 類別的其他索引鍵屬性搭配使用時,這個屬性允許唯一識別此類別及其子類別的所有實例。
此屬性繼承自 CIM_Service。
-
-
DelayedAutoStart
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|SERVICE_DELAYED_AUTO_START_INFO|fDelayedAutostart「) , DisplayName (」Delayed Auto-Start「)
如果 為 True,則服務會在啟動其他自動啟動服務之後啟動,加上短暫的延遲。
Windows Server 2012 R2、Windows 8.1、Windows Server 2012、Windows 8、Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista:Windows Server 2016和Windows 10之前不支援此屬性.
此屬性繼承自 Win32_Service。
-
-
說明
-
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: DisplayName (「Description」)
物件的描述。
此屬性繼承自 CIM_ManagedSystemElement。
-
-
DesktopInteract
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|dwServiceType|SERVICE_INTERACTIVE_PROCESS「) , DisplayName (」與桌面互動「)
指出服務是否可以在桌面上建立或與視窗通訊,因此會以某種方式與使用者互動。 互動式服務必須在本機系統帳戶下執行。 大部分的服務都不是互動式服務;也就是說,他們不會以任何方式與使用者通訊。
此屬性繼承自 Win32_BaseService。
-
-
DisconnectedSessions
-
-
資料類型: uint32
-
存取類型:唯讀
目前伺服器上的中斷連線會話數目。 這些會話可能仍在主動取用伺服器資源,不過它們目前沒有與用戶端的網路連線。
-
-
DisplayName
-
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|lpDisplayName「) , DisplayName (」顯示名稱「)
服務嵌入式管理單元中所檢視的服務名稱。 這個字串的最大長度為 256 個字元。 請注意,儲存在登錄) 中的顯示名稱和服務名稱 (不一定相同。 例如,DHCP 用戶端服務具有服務名稱 Dhcp,但顯示名稱 DHCP 用戶端。 名稱會在服務控制管理員中保留大小寫。 不過, DisplayName 比較一律不區分大小寫。
條件約束:接受與 Name 屬性相同的值。
範例:「Atdisk」
此屬性繼承自 Win32_BaseService。
-
-
ErrorControl
-
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|dwErrorControl「) , DisplayName (「啟動失敗嚴重性」)
如果此服務在啟動期間無法啟動,則錯誤嚴重性。 如果發生失敗,此值表示啟動程式所採取的動作。 電腦系統會記錄所有錯誤。
-
-
忽略 (「Ignore」)
-
不通知使用者。
-
標準 (「Normal」)
-
通知使用者。 這通常是訊息方塊顯示,通知使用者發生問題。
-
嚴重 (「嚴重」)
-
使用上次的正確組態重新啟動系統。
-
重大 (「重大」)
-
系統嘗試以正確的組態重新啟動。 如果服務第二次無法啟動,啟動就會失敗。
-
未知 (「未知」)
-
錯誤的嚴重性未知。
此屬性繼承自 Win32_BaseService。
ExitCode
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwWin32ExitCode「) , DisplayName (」結束代碼「)
定義啟動或停止服務時所發生錯誤的 Windows 錯誤碼。 這個屬性設定為 ERROR_SERVICE_SPECIFIC_ERROR (1066) 這個類別所代表的服務唯一錯誤,而且 ServiceSpecificExitCode 屬性中提供錯誤的相關資訊。 服務會將此值設定為 在執行時NO_ERROR ,並在正常終止時再次設定此值。
此屬性繼承自 Win32_BaseService。
InstallDate
-
資料類型: datetime
-
存取類型:唯讀
-
限定詞: MappingStrings (「MIF。DMTF|ComponentID|001.5「) , DisplayName (」Install Date「)
已安裝 Date 物件。 這個屬性不需要值來指出已安裝物件。
此屬性繼承自 CIM_ManagedSystemElement。
名稱
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: 金鑰
服務的唯一識別碼,可提供受管理之功能的指示。 這項功能會在 物件的 Description 屬性中描述。
此屬性繼承自 CIM_ManagedSystemElement。
PathName
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|lpBinaryPathName「) , DisplayName (」檔案名「)
實作服務之服務二進位檔案的完整路徑。
範例:「\SystemRoot\System32\drivers\afd.sys」
此屬性繼承自 Win32_BaseService。
ProcessId
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|SERVICE_STATUS_PROCESS|dwProcessId「) , DisplayName (」Process Id「)
服務的進程識別碼。
範例:324
此屬性繼承自 Win32_Service。
ServiceSpecificExitCode
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwServiceSpecificExitCode「) , DisplayName (」伺服器特定結束代碼「)
服務啟動或停止時所發生之錯誤的服務特定錯誤碼。 結束代碼是由這個類別所代表的服務所定義。 只有當 ExitCode 屬性值 ERROR_SERVICE_SPECIFIC_ERROR (1066) 時,才會設定此值。
此屬性繼承自 Win32_BaseService。
ServiceType
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|dwServiceType「) , DisplayName (」Service Type「)
為呼叫處理序所提供的服務類型。
值如下:
核心驅動程式 (「核心驅動程式」)
檔案系統驅動程式 (「檔案系統驅動程式」)
配接 器 (「配接器」)
辨識器驅動程式 (「辨識器驅動程式」)
自有進程 (「擁有進程」)
共用進程 (「共用進程」)
互動式進程 (「互動式進程」)
此屬性繼承自 Win32_BaseService。
Started
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: DisplayName (「Started」)
指出服務是否已啟動。
此屬性繼承自 CIM_Service。
StartMode
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: DisplayName (「開始模式」)
Windows 基底服務的啟動模式。
開機 (「開機 」)
作業系統載入器啟動的裝置驅動程式 (僅適用于驅動程式服務) 。
系統 (「System」)
作業系統初始化程式啟動的裝置驅動程式。 這個值只適用於驅動程式服務。
自動 (「自動」)
要由服務控制管理員在系統啟動期間自動啟動的服務。 即使使用者未登入,也會啟動自動服務。
手動 (「Manual」)
當進程呼叫 StartService 方法時,服務控制管理員要啟動的服務。 除非使用者登入並啟動這些服務,否則不會啟動這些服務。
已停用 (「已停用」)
在 StartMode 變更為 [自動] 或 [手動] 之前無法啟動的服務。
此屬性繼承自 CIM_Service。
StartName
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|lpServiceStartName「) , DisplayName (」Starting Account Name「)
服務執行所在的帳戶名稱。 視服務類型而定,帳戶名稱的格式可能是 「DomainName\Username」 或 UPN 格式, (「Username@DomainName」) 。 服務進程會在執行時,使用這兩種形式之一來記錄。 如果帳戶屬於內建網域,則可以指定 「.\Username」。 針對核心或系統層級驅動程式, StartName 包含驅動程式物件名稱 (,也就是 「\FileSystem\Rdr」 或 「\Driver\Xns」) I/O 系統用來載入設備磁碟機。 此外,如果指定 Null ,驅動程式會根據服務名稱,以 I/O 系統所建立的預設物件名稱執行。
範例:「DWDOM\管理員」
此屬性繼承自 Win32_BaseService。
State
-
資料類型: 字串
-
存取類型:讀取/寫入
-
限定詞: MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwCurrentState 「) , DisplayName (」State「)
基底服務的目前狀態。
值如下:
已停止 (「已停止」)
啟動擱 置 (「開始擱置中」)
停止擱 置 (「停止暫止」)
執行 (「執行中」)
繼續暫止 (「繼續暫止」)
暫停暫止 (「暫停暫止」)
暫停 (「Paused」)
未知 (「未知」)
Windows Server 2008 和 Windows Vista: 此屬性在 Windows 7 和 Windows Server 2008 R2 之前是唯讀的。
此屬性繼承自 Win32_BaseService。
狀態
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MaxLen (10) 、 DisplayName (「Status」)
物件的目前狀態。 您可以定義各種操作和非操作狀態。 作業狀態包括:「確定」、「降級」和「預先失敗」 (啟用智慧型硬碟等元素,可能會正常運作,但預測近期的失敗) 。 非操作狀態包括:「Error」、「Starting」、「Stopping」 和 「Service」。 後者的「服務」可能會在磁片的鏡像重新儲存期間套用、重載使用者權限清單或其他系統管理工作。 並非所有這類工作都已上線,但 Managed 元素既不是「確定」,也不是在其他其中一種狀態中。
值如下:
確定 (「確定」)
錯誤 (「錯誤」)
降級 (「降級」)
未知 (「未知」)
Pred Fail (「預先失敗」)
starting (「Starting」)
停止 (「停止」)
服務 (「Service」)
壓力 (「壓力」)
NonRecover (「NonRecover」)
無連絡人 (「無連絡人」)
Lost Comm (「Lost Comm」)
此屬性繼承自 CIM_ManagedSystemElement。
SystemCreationClassName
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞:傳播 (「CIM_System。CreationClassName「) 、CIM_Key、DisplayName (」System Class Name「)
裝載此服務的系統類型名稱。
此屬性繼承自 CIM_Service。
SystemName
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: 傳播 (「CIM_System。Name「) , CIM_Key, DisplayName (」System Name「)
裝載此服務的系統名稱。
此屬性繼承自 CIM_Service。
TagId
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|dwTagId「) , DisplayName (」標記識別項「)
群組中此服務的唯一標籤值。 值 0 (零) 表示服務沒有標記。 標記可用來在載入順序群組內排序服務啟動,方法是在登錄中指定位於下列位置的標籤順序向量:
\ HKEY_LOCAL_MACHINE系統\CurrentControlSet\控制\ GroupOrderList
標記只會針對具有開機模式或系統啟動模式的核心驅動程式和檔案系統驅動程式啟動類型服務進行評估。
此屬性繼承自 Win32_BaseService。
TotalSessions
-
資料類型: uint32
-
存取類型:唯讀
目前伺服器上的會話總數。 這包括已連線和已中斷連線的會話。
WaitHint
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwWaitHint「) , DisplayName (」Estimated Wait Time「)
暫止開始、停止、暫停或繼續作業所需的估計時間,以毫秒為單位。 經過指定的時間之後,服務會使用遞增的 CheckPoint值或CurrentState中的變更,對SetServiceStatus方法進行下一次呼叫。 如果 WaitHint 傳遞所指定的時間量,且 CheckPoint 尚未遞增,或 CurrentState 尚未變更,服務控制管理員或服務控制程式會假設發生錯誤。
此屬性繼承自 Win32_Service。
備註
因為 Win32_TerminalService 類別是 Win32_Service 類別的子類別,所以類別會繼承 Win32_Service的所有屬性和方法。
Win32_TerminalServiceSetting與Win32_TerminalService相關聯,做為Win32_TerminalServiceToSetting關聯的Setting屬性。
Win32_TSSessionDirectory與Win32_TerminalService相關聯,做為Win32_TSSessionDirectorySetting關聯之Setting屬性。
Managed 物件格式 (MOF) 檔案包含 Windows Management Instrumentation (WMI) 類別的定義。 MOF 檔案不會安裝為 Microsoft Windows 軟體發展工具組 (SDK) 的一部分。 當您使用 伺服器管理員 新增相關聯的角色時,它們會安裝在伺服器上。 如需 MOF 檔案的詳細資訊,請參閱 Managed 物件格式 (MOF) 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
命名空間 |
Root\CIMv2 |
MOF |
|
DLL |
|