Win32_TSAccount クラス

  • [アーティクル]

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