Msvm_TerminalService クラス

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

特定のホストへのすべてのリモートターミナル接続を管理します。サービスは、構成可能なポートを使用して、すべてのターミナル接続を開始します。

次の構文は、簡略化されたマネージドオブジェクト形式 (MOF) コードであり、継承されたすべてのプロパティが含まれています。

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_TerminalService : CIM_Service
{
  string   InstanceID;
  string   Caption = "Hyper-V Terminal Service";
  string   Description = "Microsoft Virtual Terminal Service";
  string   ElementName = "Hyper-V Terminal Service";
  datetime InstallDate;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "The virtual terminal connection management service is fully operational" };
  string   Status = "OK";
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   Name = "termsvc";
  string   CreationClassName = "Msvm_TerminalService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started;
};

メンバー

Msvm_TerminalService クラスには、次の種類のメンバーがあります。

メソッド
プロパティ

メソッド

Msvm_TerminalService クラスには、これらのメソッドがあります。

メソッド	説明
GetInteractiveSessionACL	仮想マシンの対話型セッションへのアクセスを制御する現在の DACL を取得します。
GrantInteractiveSessionAccess	指定されたトラスティの一覧への仮想マシンの対話型セッションへのアクセスを許可します。
ModifyServiceSettings	サービスの設定データを変更します。
RequestStateChange	状態の変更を要求します。
RevokeInteractiveSessionAccess	指定したトラスティの一覧から仮想マシンの対話型セッションへのアクセスを取り消します。
StartService	サービスを開始します。
Stopservice	サービスを停止します。

プロパティ

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

AvailableRequestedStates

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

RequestStateChange メソッドの RequestedState パラメーターに指定できる値を示します。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

Caption

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

オブジェクトの簡単な説明。このプロパティは、 CIM_ManagedElementから継承されます。

CommunicationStatus

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

基になるマネージド要素と通信するインストルメンテーションの機能を示します。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは、 CIM_ManagedSystemElementから継承されます。

不明 (0)
使用できません (1)
通信 OK (2)
失われた通信 (3)
連絡先なし (4)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

CreationClassName

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

インスタンスの作成で使用されるクラスまたはサブクラスの名前。このプロパティは 、CIM_Serviceから継承されます。

説明

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

オブジェクトの説明。このプロパティは、 CIM_ManagedElementから継承されます。

DetailedStatus

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

PrimaryStatus プロパティに追加の状態の詳細を補完します。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは、 CIM_ManagedSystemElementから継承されます。

使用できません (0)
追加情報なし (1)
ストレス ( 2)
予測エラー (3)
回復できないエラー (4)
エラーのサポートエンティティ (5)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

ElementName

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

オブジェクトの表示名。このプロパティは、 CIM_ManagedElementから継承されます。

EnabledDefault

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

要素の有効な状態に対する管理者の既定の構成またはスタートアップ構成。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

EnabledState

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

要素の有効および無効の状態。また、これらの要求された状態間の遷移を示すこともできます。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

HealthState

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

要素の現在の正常性。この属性は、この要素の正常性を表しますが、必ずしもサブコンポーネントの正常性を表すわけではありません。指定できる値は 0 ~ 30 で、5 は要素が完全に正常であることを意味し、30 は要素が完全に非機能であることを意味します。このプロパティは 、CIM_ManagedSystemElementから継承されます。

InstallDate

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

仮想マシンの構成が作成された日時。このプロパティは 、CIM_ManagedSystemElementから継承されます。

InstanceID

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

このクラスのインスタンスを一意に識別します。このプロパティは CIM_ManagedElementから継承され、常に Null に設定 されます。

Name

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

オブジェクトが認識されるラベル。このプロパティは、 CIM_Serviceから継承されます。

OperatingStatus

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

要素の操作条件の現在の状態情報を提供し、 EnabledState プロパティの値に関してより詳細な情報を提供するために使用できます。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは 、CIM_ManagedSystemElementから継承されます。

不明 (0)
使用できません (1)
サービス (2)
開始 (3)
停止中 (4)
停止 ( 5)
中止 ( 6)
休止状態 (7)
完了 (8)
移行 ( 9)
Emigrating (10)
未移行 (11)
スナップショット処理 (12)
シャットダウン (13)
In Test (14)
移行中 (15)
In Service (16)
DMTF 予約済み (..)
ベンダー予約 済み (0x8000.. )

OperationalStatus

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

オブジェクトの現在の状態。このプロパティは 、CIM_ManagedSystemElementから継承されます。

OtherEnabledState

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

EnabledState プロパティが 1 (Other) に設定されている場合の要素の有効または無効の状態を表す文字列。 EnabledState が 1 以外の値である場合、このプロパティは Null に設定する必要があります。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

PrimaryOwnerContact

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

サービスのプライマリ所有者に到達する方法 (電話番号、電子メールアドレスなど) に関する情報を提供する値。このプロパティは、 CIM_Serviceから継承されます。

PrimaryOwnerName

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

サービスのプライマリ所有者の名前 (定義されている場合)。プライマリ所有者は、サービスの最初のサポート連絡先です。このプロパティは、 CIM_Serviceから継承されます。

PrimaryStatus

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

高レベルの状態情報を提供します。このプロパティは、要素とそのサブコンポーネントの高レベルで詳細な正常性状態を提供するために 、DetailedStatus プロパティと組み合わせて使用する必要があります。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは 、CIM_ManagedSystemElementから継承されます。

不明 (0)
OK (1)
機能低下 (2)
エラー (3)
DMTF 予約済み (..)
ベンダー予約 済み (0x8000.. )

RequestedState

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

要素に対して最後に要求された状態または目的の状態。要素の実際の状態は EnabledState で表されます。このプロパティは、最後に要求された状態と現在有効または無効になっている状態を比較するために提供されます。 CIM_EnabledLogicalElementの特定のインスタンスが RequestStateChange メソッドをサポートしていない場合があります。これが発生した場合は、値 12 (該当なし) が使用されます。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

Started

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

サービスが現在実行されているかどうかを示します。このプロパティは、 CIM_Serviceから継承されます。

StartMode

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

サービスがシステム、オペレーティングシステム、または要求時にのみ開始されるかどうかを示す文字列値。このプロパティは、 CIM_Serviceから継承されます。

状態

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

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

StatusDescriptions

データ型: 文字列 配列
アクセスの種類: 読み取り専用

さまざまな OperationalStatus 配列値を記述する文字列。このプロパティは 、CIM_ManagedSystemElementから継承されます。

SystemCreationClassName

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

スコープシステムの作成クラス名。このプロパティは、 CIM_Serviceから継承されます。

Systemname

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

ホスティングコンピューターシステムの名前。このプロパティは、 CIM_Serviceから継承されます。

TimeOfLastStateChange

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

要素の有効な状態が最後に変更された日時。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

TransitioningToState

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

インスタンスが遷移しているターゲットの状態を示します。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

注釈

MSVM_TERMINALSERVICE クラスへのアクセスは、UAC フィルター処理によって制限される場合があります。詳細については、「ユーザーアカウント制御と WMI」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
名前空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
[DLL]	Vmms.exe

こちらもご覧ください

CIM_Service

次の方法で共有