Win32_Terminal クラス
WIN32_TERMINAL WMI クラスはターミナルを表します。
次の構文は MOF コードから簡略化され、定義および継承されたすべてのプロパティがアルファベット順に含まれています。 メソッドのリファレンス情報については、このトピックで後述するメソッドの表を参照してください。
構文
[dynamic, overwrite, provider("Win32_WIN32_TERMINAL_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_Terminal : CIM_LogicalElement
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
uint32 fEnableTerminal;
uint32 LoggedOnUsers;
string TerminalName;
};
メンバー
Win32_Terminal クラスには、次の種類のメンバーがあります。
メソッド
Win32_Terminal クラスには、これらのメソッドがあります。
メソッド | 説明 |
---|---|
作成 |
Win32_TerminalSetting クラスのプロパティとメソッドを使用してカスタマイズできる既定の設定でターミナルを作成します。 |
削除 | 指定したターミナルを削除します。 |
有効にする | ターミナルを無効または有効にします。 |
名前の変更 | ターミナルの名前を変更します。 |
プロパティ
Win32_Terminal クラスには、これらのプロパティがあります。
-
Caption
-
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (64)
オブジェクトの短い説明 (1 行文字列)。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
-
-
説明
-
-
データ型: string
-
アクセスの種類: 読み取り専用
オブジェクトの説明。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
-
-
fEnableTerminal
-
-
データ型: uint32
-
アクセスの種類: 読み取り専用
指定したターミナルを無効にするか、有効にするかを指定します。
-
-
FALSE (0)
-
ターミナルが無効になっています。
-
TRUE (1)
-
ターミナルが有効になっています。
InstallDate
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: マッピング文字列 ("MIF.DMTF|ComponentID|001.5")
オブジェクトがインストールされた日付。 値がない場合、オブジェクトがインストールされていないことを示すわけではありません。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
LoggedOnUsers
-
データ型: uint32
-
アクセスの種類: 読み取り専用
ターミナルのログオン セッションの数。
名前
-
データ型: string
-
アクセスの種類: 読み取り専用
オブジェクトの名前。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
状態
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (10)
オブジェクトの現在の状態。 さまざまな操作状態と非操作状態を定義できます。 運用状態には、"OK"、"Degraded"、"Pred Fail" (SMART 対応ハード ディスク ドライブなどの要素が正常に機能している可能性がありますが、近い将来に障害が予測される可能性があります) が含まれます。 非操作状態には、"Error"、"Starting"、"Stopping"、および "Service" が含まれます。 後者の "サービス" は、ディスクのミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用される可能性があります。 このような作業がすべてオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
("OK")
("Error")
("Degraded")
("Unknown")
("Pred Fail")
("Starting")
("Stopping")
("Service")
TerminalName
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: キー
ターミナルのインスタンスを識別する一意の名前。
注釈
Win32_Terminal は、 Win32_TerminalTerminalSetting 関連付けの Element プロパティとして Win32_TerminalSetting に関連付けられます。
Win32_Terminal クラスのサブクラスは、Win32_TSGeneralSetting、Win32_TSLogonSetting、Win32_TSSessionSetting、Win32_TSEnvironmentSetting、Win32_TSRemoteControlSetting、Win32_TSClientSetting、Win32_TSNetworkAdapterSetting、Win32_TSNetworkAdapterListSetting、Win32_TSPermissionsSetting、Win32_TSAccountです。
コンソール セッションに関連付けられている Winstation は、このクラスのメソッドとプロパティにアクセスできないことに注意してください。 TerminalName プロパティの値として "Console" を指定して試行した場合、このオブジェクトのメソッドはWBEM_E_NOT_SUPPORTEDを返します。 このエラー コードは、ウィンドウ ステーションがこのオブジェクトのメソッドを呼び出して LocalSystem、LocalService、または NetworkService アカウントのセキュリティ プロパティを追加または変更しようとした場合にも返されます。
\root\CIMV2\TerminalServices 名前空間に接続するには、認証レベルにパケット プライバシーを含める必要があります。 C/C++ 呼び出しの場合、これは RPC_C_AUTHN_LEVEL_PKT_PRIVACYの認証レベルです。 Visual Basic 呼び出しとスクリプト呼び出しの場合、これは WbemAuthenticationLevelPktPrivacy または "pktPrivacy" の認証レベルであり、値は 6 です。 次の Visual Basic Scripting Edition (VBScript) の例は、パケット プライバシーを使用してリモート コンピューターに接続する方法を示しています。
strComputer = "RemoteServer1"
Set objServices = GetObject( _
"winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")
マネージド オブジェクト形式 (MOF) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Microsoft Windows ソフトウェア開発キット (SDK) の一部としてインストールされません。 サーバー マネージャーを使用して関連付けられたロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「 マネージド オブジェクト形式 (MOF)」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista |
サポートされている最小のサーバー |
Windows Server 2008 |
名前空間 |
Root\CIMv2\TerminalServices |
MOF |
|
[DLL] |
|