共用方式為

Win32_SystemDriver類別

  • 發行項

Win32_SystemDriver WMI 類別代表基底服務的系統驅動程式。

下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。 屬性和方法依字母順序，而不是MOF順序。

語法

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4C5-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SystemDriver : Win32_BaseService
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

成員

Win32_SystemDriver 類別具有下列類型的成員：

方法

Win32_SystemDriver類別具有這些方法。

方法 描述
變更 修改服務的類別方法。
ChangeStartMode 修改服務啟動模式的類別方法。
建立 建立新服務的類別方法。
刪除 刪除現有服務的類別方法。
InterrogateService 要求服務將狀態更新為 Service Manager 的類別方法。
PauseService 嘗試將服務置於暫停狀態的類別方法。
ResumeService 嘗試將服務置於繼續狀態的類別方法。
StartService 嘗試將服務置於其啟動狀態的類別方法。
StopService 將服務置於已停止狀態的類別方法。
UserControlService 嘗試將使用者定義控制項程式代碼傳送至服務的類別方法。

 

屬性

Win32_SystemDriver類別具有這些屬性。

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。

CreationClassName

數據類型： 字串

存取類型：唯讀

限定符：CIM_Key DisplayName （“類別名稱”）

要出現在實例建立時所用繼承鏈結中之第一個具體類別的名稱。 搭配 類別的其他索引鍵屬性使用時，這個屬性允許唯一識別此類別及其子類別的所有實例。

此屬性繼承自 CIM_Service。

說明

數據類型： 字串

存取類型：唯讀

限定符： DisplayName （“Description”）

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

DesktopInteract

數據類型： 布爾值

存取類型：唯讀

限定符：MappingStrings （“Win32API|服務結構|QUERY_SERVICE_CONFIG|dwServiceType|SERVICE_INTERACTIVE_PROCESS），DisplayName （“與桌面互動”）

此服務可以建立或與桌面上的窗口通訊。

此屬性繼承自 Win32_BaseService。

DisplayName

數據類型： 字串

存取類型：唯讀

限定符：MappingStrings （“Win32API|服務結構|QUERY_SERVICE_CONFIG|lpDisplayName“），DisplayName （”顯示名稱“）

服務的顯示名稱。 此字串的長度上限為 256 個字元。 名稱會保留於服務控制管理員中。 DisplayName 比較一律不區分大小寫。

條件約束：接受與 Name 屬性相同的值。

範例：“Atdisk”

此屬性繼承自 Win32_BaseService。

ErrorControl

數據類型： 字串

存取類型：唯讀

限定符：MappingStrings （“Win32API|服務結構|QUERY_SERVICE_CONFIG|dwErrorControl“），DisplayName （”啟動失敗的嚴重性“）

如果此服務在啟動期間無法啟動，則錯誤的嚴重性。 這個值表示啟動程式在發生失敗時所採取的動作。 所有錯誤都會由計算機系統記錄。

此屬性繼承自 Win32_BaseService。

忽略 （“Ignore”）

使用者未收到通知。

標準 （“正常 ”）

使用者會收到通知。

嚴重 （“嚴重 ”）

系統會使用最後一個已知良好的組態重新啟動。

重大 （“重大 ”）

系統嘗試以良好的設定重新啟動。

未知 （“未知”）

失敗的原因未知。

ExitCode

數據類型： uint32

存取類型：唯讀

限定符：MappingStrings （“Win32API|服務結構|SERVICE_STATUS|dwWin32ExitCode“），DisplayName （”Exit Code“）

定義啟動或停止服務時遇到的任何問題的 Windows 錯誤碼。 當錯誤對於此類別所代表的服務而言是唯一時，此屬性會設定為 [ERROR_SERVICE_SPECIFIC_ERROR] \(1066)，此錯誤的相關資訊可見於 ServiceSpecificExitCode 屬性。 服務會將此值設定為 在執行時NO_ERROR ，並在正常終止時再次設定此值。

此屬性繼承自 Win32_BaseService。

InstallDate

數據類型： datetime

存取類型：唯讀

限定符： MappingStrings （“MIF.DMTF|ComponentID|001.5“）， DisplayName （”安裝日期“）

已安裝物件。 這個屬性不需要值來指出對象已安裝。

此屬性繼承自 CIM_ManagedSystemElement。

名稱

數據類型： 字串

存取類型：唯讀

限定符： 索引鍵

服務的唯一標識碼，提供所管理之功能的指示。 在物件 Description 屬性中會更詳細地描述這項功能。

此屬性繼承自 CIM_Service。

PathName

數據類型： 字串

存取類型：唯讀

限定符：MappingStrings （“Win32API|服務結構|QUERY_SERVICE_CONFIG|lpBinaryPathName“），DisplayName （”檔名“）

實作服務之服務二進位檔的完整路徑。

範例：“\SystemRoot\System32\drivers\afd.sys”

此屬性繼承自 Win32_BaseService。

ServiceSpecificExitCode

數據類型： uint32

存取類型：唯讀

限定符：MappingStrings （“Win32API|服務結構|SERVICE_STATUS|dwServiceSpecificExitCode“），DisplayName （”伺服器特定結束代碼“）

服務特定的錯誤碼，適用於服務啟動或停止時所發生的錯誤。 結束代碼是由這個類別所代表的服務所定義。 只有在 ExitCode 屬性值ERROR_SERVICE_SPECIFIC_ERROR （1066） 時，才會設定此值。

此屬性繼承自 Win32_BaseService。

ServiceType

數據類型： 字串

存取類型：唯讀

限定符：MappingStrings （“Win32API|服務結構|QUERY_SERVICE_CONFIG|dwServiceType“），DisplayName （”服務類型“）

為呼叫處理序所提供的服務類型。

此屬性繼承自 Win32_BaseService。

值如下：

核心驅動程式 （“Kernel Driver ”）

檔案系統驅動程式 （“檔案系統驅動程式”）

配接器 （“配接 器”）

辨識器驅動程式 （“辨識器驅動程式”）

自己的行程 （“自己的進程”）

共用行程 （“共享行程”）

互動式程式 （“互動式進程”）

Started

數據類型： 布爾值

存取類型：唯讀

限定符： DisplayName （“Started”）

服務已啟動。

此屬性繼承自 CIM_Service。

StartMode

數據類型： 字串

存取類型：唯讀

限定符： DisplayName （“開始模式”）

系統驅動程序的啟動模式。

此屬性繼承自 Win32_BaseService。

開機 （“開機 ”）

由作業系統載入器啟動的裝置驅動程式（僅適用於驅動程式服務）。

系統 （“系統 ”）

由作業系統初始化程式啟動的裝置驅動程式。 此值僅適用於驅動程序服務。

Auto （“Auto ”）

服務控制管理員在系統啟動期間自動啟動的服務。

手動 （“手動 ”）

當行程呼叫 StartService 方法時，服務控制管理員所要啟動的服務 。

Disabled （“Disabled”）

無法再啟動的服務。

StartName

數據類型： 字串

存取類型：唯讀

限定符：MappingStrings （“Win32API|服務結構|QUERY_SERVICE_CONFIG|lpServiceStartName“），DisplayName （”起始帳戶名稱“）

服務執行所在的帳戶名稱。 視服務類型而定，帳戶名稱的格式可能是 DomainName\Username。 服務進程會在執行時，使用這兩種窗體的其中一個來記錄。 如果帳戶屬於內建網域，則可以指定 .\Username。 如果 指定 NULL ，服務將會以 LocalSystem 帳戶登入。 針對核心或系統層級驅動程式， StartName 包含驅動程式物件名稱（也就是 \FileSystem\Rdr 或 \Driver\Xns），而輸入和輸出系統會用來載入設備驅動器。 此外，如果 指定 NULL ，驅動程式會使用以服務名稱為基礎的 I/O 系統所建立的預設物件名稱執行。

範例：“DWDOM\管理員”

此屬性繼承自 Win32_BaseService。

州 (縣/市)

數據類型： 字串

存取類型：讀取/寫入

限定詞： MappingStrings （「Win32API|服務結構| SERVICE_STATUS|dwCurrentState 「，」 DisplayName （「State」）

基底服務的目前狀態。

此屬性繼承自 Win32_BaseService 。

值如下：

已停止 （「已停止」）

開始擱置 中 （「開始擱置中」）

停止擱置 中 （「停止擱置中」）

執行 中 （「Running」）

繼續擱置 （「繼續擱置中」）

暫停擱置 中 （「暫停擱置中」）

已暫停 （「Paused」）

未知 （「未知」）

狀態

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen （10）， DisplayName （「Status」）

物件的目前狀態。 您可以定義各種操作和非操作狀態。 作業狀態包括：「OK」、「已降級」和「Pred Fail」（智慧型硬碟等元素可能正常運作，但預測近期失敗）。 非操作狀態包括：「Error」、「Starting」、「Stopping」 和 「Service」。 後者「服務」可以在磁片的鏡像重新Silvering、重載使用者權限清單或其他系統管理工作期間套用。 並非所有這類工作都在線上，但 Managed 元素既不是「確定」，也不是在其他其中一個狀態。

此屬性繼承自 CIM_ManagedSystemElement 。

值如下：

確定 （「OK」）

錯誤 （「錯誤」）

已降級 （「已降級」）

未知 （「未知」）

Pred Fail （「Pred Fail」）

啟動 （「開始」）

停止 （「停止」）

服務 （「Service」）

壓力（「壓力」）

NonRecover （「NonRecover」）

無連絡人 （「無連絡人」）

Lost Comm （「Lost Comm」）

SystemCreationClassName

資料類型： 字串

存取類型：唯讀

限定詞： 傳播 （「 CIM_System. CreationClassName「）， CIM_Key DisplayName （」System Class Name「）

裝載此服務之系統的類型名稱。

此屬性繼承自 CIM_Service 。

SystemName

資料類型： 字串

存取類型：唯讀

限定詞： 傳播 （「 CIM_System. Name ）， CIM_Key DisplayName （「系統名稱」）

裝載此服務之系統的名稱。

此屬性繼承自 CIM_Service 。

TagId

資料類型： uint32

存取類型：唯讀

限定詞： MappingStrings （「Win32API|服務結構| QUERY_SERVICE_CONFIG|dwTagId「）， DisplayName （」標記識別項「）

群組中此服務的唯一標籤值。 值為 0 （零） 表示服務尚未指派標記。 標記可用於在載入順序群組內排序服務啟動，方法是在登錄中指定位於下列位置的標籤順序向量：

此屬性繼承自 Win32_BaseService。

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList。

標籤只會針對具有開機模式或系統啟動模式的核心驅動程式和文件系統驅動程式啟動類型服務進行評估。

備註

Win32_SystemDriver類別衍生自 Win32_BaseService。

範例

下列 PowerShell 範例會從電腦上執行中的系統驅動程式擷取一些屬性。

Get-WmiObject -Class Win32_SystemDriver | Where-Object -FilterScript {$_.State -eq "Running"} | Where-Object -FilterScript {$_.StartMode -eq "Manual"} | Format-Table -Property Name,DisplayName

需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

Win32_BaseService

作業系統類別