Win32_TerminalService クラス

[アーティクル]
06/12/2023

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 クラスには、これらのメソッドがあります。

メソッド	説明
変更	サービスを変更します。
ChangeStartMode	サービスの開始モードを変更します。
作成	新しいサービスを作成します。
削除	既存のサービスを削除します。
GetSecurityDescriptor	サービスへのアクセスを制御するセキュリティ記述子を返します。
InterrogateService	サービスの状態をサービスマネージャーに更新するよう要求します。
PauseService	サービスを一時停止状態にしようとします。
ResumeService	再開された状態でサービスを配置しようとします。
SetSecurityDescriptor	サービスへのアクセスを制御する更新バージョンのセキュリティ記述子を書き込みます。
StartService	サービスをスタートアップ状態にしようとします。
Stopservice	サービスを停止状態にします。
UserControlService	ユーザー定義のコントロールコードをサービスに送信しようとします。

プロパティ

Win32_TerminalService クラスには、これらのプロパティがあります。

AcceptPause

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_PAUSE_CONTINUE") 、DisplayName ("Service Accepts Pause")

サービスを一時停止できるかどうかを示します。

このプロパティは、 Win32_BaseServiceから継承されます。

AcceptStop

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_STOP") 、DisplayName ("Service Accepts Stop")

サービスを停止できるかどうかを示します。

このプロパティは、 Win32_BaseServiceから継承されます。

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)、 DisplayName ("Caption")

サービスの 1 行文字列の簡単な説明。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

チェックポイント

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwCheckPoint"),DisplayName ("Check Point Count")

サービスが定期的にインクリメントして、長時間の開始、停止、一時停止、または続行の操作中に進行状況を報告する値。たとえば、サービスは起動時に初期化の各ステップを完了すると、この値をインクリメントします。サービスで操作を呼び出すユーザーインターフェイスプログラムは、この値を使用して、長い操作中のサービスの進行状況を追跡します。この値は無効であり、サービスに開始、停止、一時停止、または続行操作が保留中でない場合は 0 にする必要があります。

このプロパティは、 Win32_Serviceから継承されます。

CreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: 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から継承されます。

説明

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Description")

オブジェクトの説明。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

DesktopInteract

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|dwServiceType|SERVICE_INTERACTIVE_PROCESS") 、DisplayName ("Interacts with Desktop")

サービスがデスクトップ上のウィンドウを作成または通信し、ユーザーと何らかの方法で対話できるかどうかを示します。対話型サービスは、ローカルシステムアカウントで実行する必要があります。ほとんどのサービスは対話型ではありません。つまり、ユーザーと何らかの方法で通信することはありません。

このプロパティは、 Win32_BaseServiceから継承されます。

DisconnectedSessions

データ型: uint32
アクセスの種類: 読み取り専用

現在のサーバーで切断されたセッションの数。これらのセッションは、サーバーリソースをアクティブに使用している可能性がありますが、現在、クライアントとのネットワーク接続はありません。

DisplayName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Display Name")

サービススナップインに表示されるサービスの名前。この文字列の長さは最大 256 文字です。表示名とサービス名 (レジストリに格納されている) は常に同じではないことに注意してください。たとえば、DHCP クライアントサービスのサービス名は Dhcp ですが、表示名は DHCP クライアントです。名前は Service Control Manager で大文字と小文字が区別されます。ただし、 DisplayName 比較では常に大文字と小文字が区別されません。

制約: Name プロパティと同じ値を受け入れます。

例: "Atdisk"

このプロパティは、 Win32_BaseServiceから継承されます。

ErrorControl

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("起動エラーの重大度")

起動時にこのサービスの起動に失敗した場合のエラーの重大度。値は、障害が発生した場合にスタートアッププログラムによって実行されるアクションを示します。すべてのエラーは、コンピューターシステムによって記録されます。

Ignore ("Ignore")

ユーザーへの通知が行われません。

Normal ("Normal")

ユーザーへの通知が行われます。通常、これは問題をユーザーに通知するメッセージボックス表示になります。

重大 ("Severe")

システムは最後の正しい構成で再起動されます。

Critical ("Critical")

正しい構成でシステムの再起動が試行されます。サービスが 2 回目の開始に失敗した場合、スタートアップは失敗します。

不明 ("不明")

エラーの重大度が不明です。

このプロパティは、 Win32_BaseServiceから継承されます。

ExitCode

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Exit Code")

サービスの開始または停止で発生したエラーを定義する Windows エラーコード。このクラスによって表される サービスに対 してエラーが一意であり、エラーに関する情報が ServiceSpecificExitCode プロパティで使用できる場合、このプロパティは ERROR_SERVICE_SPECIFIC_ERROR (1066) に設定されます。サービスは、この値を実行中 にNO_ERROR に設定し、通常の終了時に再度設定します。

このプロパティは、 Win32_BaseServiceから継承されます。

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")

Date オブジェクトがインストールされています。このプロパティでは、オブジェクトがインストールされていることを示す値は必要ありません。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

名前

データ型: string
アクセスの種類: 読み取り専用
修飾子: キー

管理されている機能を示すサービスの一意識別子。この機能については、オブジェクトの Description プロパティで説明されています。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

PathName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("ファイルパス名")

サービスを実装するサービスバイナリファイルへの完全修飾パス。

例: "\SystemRoot\System32\drivers\afd.sys"

このプロパティは、 Win32_BaseServiceから継承されます。

ProcessId

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS_PROCESS|dwProcessId"), DisplayName ("プロセス ID")

サービスのプロセス識別子。

例: 324

このプロパティは、 Win32_Serviceから継承されます。

ServiceSpecificExitCode

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("サーバー固有の終了コード")

サービスの開始または停止中に発生するエラーのサービス固有のエラーコード。終了コードは、このクラスによって表されるサービスによって定義されます。この値は、 ExitCode プロパティの値が ERROR_SERVICE_SPECIFIC_ERROR (1066) の場合にのみ設定されます。

このプロパティは、 Win32_BaseServiceから継承されます。

ServiceType

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("サービスの種類")

呼び出し側プロセスに提供されるサービスの種類です。

値は次のとおりです。

カーネルドライバー ("カーネルドライバー")

ファイルシステムドライバー ("ファイルシステムドライバー")

アダプター ("Adapter")

Recognizer Driver ("Recognizer Driver")

独自のプロセス ("独自のプロセス")

プロセスの共有 ("プロセスの共有")

対話型プロセス ("対話型プロセス")

このプロパティは、 Win32_BaseServiceから継承されます。

Started

データ型: boolean
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Started")

サービスが開始されているかどうかを示します。

このプロパティは 、CIM_Serviceから継承されます。

StartMode

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("開始モード")

Windows 基本サービスの開始モード。

ブート ("Boot")

オペレーティングシステムローダーによって開始されたデバイスドライバー (ドライバーサービスに対してのみ有効)。

システム ("System")

オペレーティングシステムの初期化プロセスによって開始されたデバイスドライバー。この値は、ドライバーサービスに対してのみ指定できます。

Auto ("Auto")

システムの起動時にサービスコントロールマネージャーによって自動的に開始されるサービスです。ユーザーがログオンしなくても、自動サービスが開始されます。

Manual ("Manual")

プロセスが StartService メソッドを呼び出したときに、サービスコントロールマネージャーによって開始されるサービス。ユーザーがログオンして起動しない限り、これらのサービスは開始されません。

Disabled ("Disabled")

StartMode が Auto または Manual に変更されるまで開始できないサービス。

このプロパティは 、CIM_Serviceから継承されます。

StartName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Starting Account Name")

サービスを実行するアカウント名。サービスの種類によっては、アカウント名が "DomainName\Username" または UPN 形式 ("Username@DomainName") の形式である場合があります。サービスプロセスは、実行時にこれら 2 つの形式のいずれかを使用してログに記録されます。アカウントが組み込みドメインに属している場合は、".\Username" を指定できます。カーネルレベルまたはシステムレベルのドライバーの場合、 StartName には、I/O システムがデバイスドライバーの読み込みに使用するドライバーオブジェクト名 ("\FileSystem\Rdr" または "\Driver\Xns") が含まれます。さらに、 NULL が 指定されている場合、ドライバーは、サービス名に基づいて I/O システムによって作成された既定のオブジェクト名で実行されます。

例: "DWDOM\管理"

このプロパティは、 Win32_BaseServiceから継承されます。

State

データ型: string
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

基本サービスの現在の状態。

値は次のとおりです。

停止 ( "Stopped")

Start Pending ("Start Pending")

保留中の停止 ("保留中の停止")

実行中 ("Running")

Continue Pending ("Continue Pending")

保留中の一時停止 ("保留中の一時停止")

一時停止 ("一時停止")

不明 ("不明")

Windows Server 2008 と Windows Vista: このプロパティは、Windows 7 および Windows Server 2008 R2 より前の読み取り専用です。

このプロパティは、 Win32_BaseServiceから継承されます。

状態

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態。さまざまな操作状態と非操作状態を定義できます。運用状態には、"OK"、"低下"、"事前失敗" (SMART 対応ハードディスクドライブなどの要素が正常に機能している可能性がありますが、近い将来に障害が予測される可能性があります) が含まれます。非運用状態には、"Error"、"Starting"、"Stopping"、および "Service" が含まれます。後者の "サービス" は、ディスクのミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用される可能性があります。このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。

値は次のとおりです。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始 ("開始")

停止中 ("停止中")

サービス ("Service")

ストレス ( "ストレス")

NonRecover ("NonRecover")

連絡先なし ("連絡先なし")

Lost Comm ("Lost Comm")

このプロパティは、 CIM_ManagedSystemElementから継承されます。

SystemCreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: 伝達 ( "CIM_System。CreationClassName")、 CIM_Key、 DisplayName ("System Class Name")

このサービスをホストするシステムの名前を入力します。

このプロパティは 、CIM_Serviceから継承されます。

Systemname

データ型: string
アクセスの種類: 読み取り専用
修飾子: 伝達 ( "CIM_System。Name")、 CIM_Key、 DisplayName ("System Name")

このサービスをホストするシステムの名前。

このプロパティは 、CIM_Serviceから継承されます。

TagId

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("Tag Id")

グループ内のこのサービスの一意のタグ値。値 0 (ゼロ) は、サービスにタグがないことを示します。タグは、次の場所にあるレジストリでタグ順序ベクトルを指定することで、読み込み順序グループ内でサービスのスタートアップを注文するために使用できます。

Hkey_local_machine\システム\CurrentControlSet\コントロール\ GroupOrderList

タグは、ブートモードまたはシステム起動モードを持つカーネルドライバーおよびファイルシステムドライバーの開始の種類のサービスに対してのみ評価されます。

このプロパティは、 Win32_BaseServiceから継承されます。

TotalSessions

データ型: uint32
アクセスの種類: 読み取り専用

現在のサーバー上のセッションの合計数。これには、接続されたセッションと切断されたセッションの両方が含まれます。

WaitHint

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwWaitHint"), DisplayName ("推定待機時間")

保留中の開始、停止、一時停止、または続行操作に必要な推定時間 (ミリ秒単位)。指定した時間が経過すると、サービスは、増加した CheckPoint 値または CurrentState の変更を使用して SetServiceStatus メソッドを次に呼び出します。 WaitHint で指定された時間が経過し、CheckPoint がインクリメントされていない場合、または CurrentState が変更されていない場合、サービスコントロールマネージャーまたはサービス制御プログラムはエラーが発生したと見なします。

このプロパティは、 Win32_Serviceから継承されます。

注釈

Win32_TerminalService クラスは Win32_Service クラスのサブクラスであるため、クラスは Win32_Service のすべてのプロパティとメソッドを継承します。

Win32_TerminalServiceSetting は、 Win32_TerminalServiceToSetting 関連付けの Setting プロパティとして Win32_TerminalService に関連付けられます。

Win32_TSSessionDirectory は、 Win32_TSSessionDirectorySetting 関連付けの Setting プロパティとして Win32_TerminalService に関連付けられます。

マネージドオブジェクト形式 (MOF) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Microsoft Windows ソフトウェア開発キット (SDK) の一部としてインストールされません。サーバーマネージャーを使用して関連付けられたロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「マネージドオブジェクト形式 (MOF)」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMv2
MOF	TSCfgWmi.mof
[DLL]	TSCfgWmi.dll

こちらもご覧ください

Win32_Service
Win32_TerminalServiceToSetting
Win32_TSSessionDirectory
Win32_BaseService
CIM_Service

Win32_TerminalService クラス

構文

メンバー

メソッド

プロパティ

注釈

要件

こちらもご覧ください

フィードバック

フィードバック

その他のリソース