Win32_TSAccount クラス

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

Win32_TSAccount WMI クラスを使用すると、Win32_Terminalに存在するアカウントを削除したり、既存のアクセス許可を変更したりできます。

次の構文は MOF コードから簡略化され、定義および継承されたすべてのプロパティがアルファベット順に含まれています。メソッドのリファレンス情報については、このトピックで後述するメソッドの表を参照してください。

構文

[dynamic, overwrite, provider("Win32_WIN32_TSACCOUNT_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSAccount : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  string   AccountName;
  uint32   AuditFail;
  uint32   AuditSuccess;
  uint32   PermissionsAllowed;
  uint32   PermissionsDenied;
  string   SID;
};

メンバー

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

メソッド
プロパティ

メソッド

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

メソッド	説明
削除	指定したユーザー、グループ、またはコンピューターアカウントを削除します。
ModifyAuditPermissions	指定したアカウントの監査アクセス許可のセットの粒度を変更します。
ModifyPermissions	より詳細なアクセス許可セットを指定されたアカウントに設定します。

プロパティ

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

AccountName

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

アカウントの現在の名前。ドメイン名が含まれています。

AuditFail

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

エラー状態に対して監査されるリモートデスクトップセッションホストサービスのアクセス許可を指定します。このプロパティの値はビットマスクであり、 PermissionsAllowed プロパティの 1 つ以上の値に設定できます。

WINSTATION_QUERY=0x1 (0)

WINSTATION_SET=0x2 (1)

WINSTATION_LOGOFF=0x4 (2)

WINSTATION_VIRTUAL |STANDARD_RIGHTS_REQUIRED = 0xF008 (3)

WINSTATION_SHADOW=0x10 (4)

WINSTATION_LOGON=0x20 (5)

WINSTATION_MSG=0x80 (6)

WINSTATION_CONNECT=0x100 (7)

WINSTATION_DISCONNECT=0x200 (8)

AuditSuccess

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

成功条件について監査される RD セッションホストサーバー固有のアクセス許可を指定します。このプロパティの値はビットマスクであり、 PermissionsAllowed プロパティの 1 つ以上の値に設定できます。

WINSTATION_QUERY=0x1 (0)

WINSTATION_SET=0x2 (1)

WINSTATION_LOGOFF=0x4WINSTATION_VIRTUAL |STANDARD_RIGHTS_REQUIRED = 0xF008 (2)

WINSTATION_SHADOW=0x10 (3)

WINSTATION_LOGON=0x20 (4)

WINSTATION_MSG=0x80 (5)

WINSTATION_CONNECT=0x100 (6)

WINSTATION_DISCONNECT=0x200 (7)

Caption

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

オブジェクトの簡単な説明 (1 行文字列)。

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

説明

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

オブジェクトの説明。

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

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: Mappingstrings ("MIF.DMTF|ComponentID|001.5")

オブジェクトがインストールされた日付。値がない場合、オブジェクトがインストールされていないことを示すわけではありません。

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

名前

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

オブジェクトの名前。

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

PermissionsAllowed

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

アカウントに対して許可されるリモートデスクトップサービスのアクセス許可を指定します。このプロパティの値はビットマスクであり、次の値の 1 つ以上に設定できます。

WINSTATION_QUERY=0x1 (1)

セッションに関する情報を照会するアクセス許可。

WINSTATION_SET (2)

接続パラメーターを変更するアクセス許可。

WINSTATION_RESET (64)

セッションまたは接続をリセットまたは終了するアクセス許可。

WINSTATION_VIRTUAL |STANDARD_RIGHTS_REQUIRED (983048)

仮想チャネルを使用するためのアクセス許可。仮想チャネルは、サーバープログラムからクライアントデバイスへのアクセスを提供します。

WINSTATION_SHADOW (16)

別のユーザーのセッションをシャドウまたはリモートで制御するためのアクセス許可。

WINSTATION_LOGON (32)

サーバー上のセッションにログオンするためのアクセス許可。

WINSTATION_LOGOFF (4)

セッションからユーザーをログオフするアクセス許可。

WINSTATION_MSG (128)

別のユーザーのセッションにメッセージを送信するアクセス許可。

WINSTATION_CONNECT (256)

別のセッションに接続するためのアクセス許可。

WINSTATION_DISCONNECT (512)

セッションを切断するアクセス許可。

PermissionsDenied

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

アカウントに対して許可されていない RD セッションホストサーバー固有のアクセス許可を指定します。このプロパティの値はビットマスクであり、 PermissionsAllowed プロパティの 1 つ以上の値に設定できます。

WINSTATION_QUERY=0x1 (0)

WINSTATION_SET=0x2 (1)

WINSTATION_LOGOFF=0x4 (2)

WINSTATION_VIRTUAL |STANDARD_RIGHTS_REQUIRED = 0xF008 (3)

WINSTATION_SHADOW=0x10 (4)

WINSTATION_LOGON=0x20 (5)

WINSTATION_MSG=0x80 (6)

WINSTATION_CONNECT=0x100 (7)

WINSTATION_DISCONNECT=0x200 (8)

SID

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

アカウントのセキュリティ識別子を指定します。

状態

データ型: 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_TerminalSettingから継承されます。

注釈

\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	TSCfgWmi.mof
[DLL]	TSCfgWmi.dll

こちらもご覧ください

Win32_TerminalSetting

次の方法で共有

Win32_TSAccount クラス

構文

メンバー

メソッド

プロパティ

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース