Win32_TSSessionSetting クラス

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

Win32_TSSessionSetting WMI クラスは、制限時間、切断操作、再接続アクションなど、Win32_Terminal クラスの構成設定を定義します。

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

構文

[dynamic, provider("Win32_WIN32_TSSESSIONSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSSessionSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ActiveSessionLimit;
  uint32   BrokenConnectionAction;
  uint32   BrokenConnectionPolicy;
  uint32   DisconnectedSessionLimit;
  uint32   IdleSessionLimit;
  uint32   PolicySourceActiveSessionLimit;
  uint32   PolicySourceBrokenConnectionAction;
  uint32   PolicySourceDisconnectedSessionLimit;
  uint32   PolicySourceIdleSessionLimit;
  uint32   PolicySourceReconnectionPolicy;
  uint32   ReconnectionPolicy;
  uint32   TimeLimitPolicy;
  uint32   EnableTimeoutWarning;
};

メンバー

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

メソッド
プロパティ

メソッド

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

メソッド	説明
BrokenConnection	このクラスに含まれる壊れた接続プロパティを設定します。
Timelimit	このクラスに含まれる時間制限プロパティを設定します。

プロパティ

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

ActiveSessionLimit

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

アクティブなセッションに割り当てられる最大時間 (ミリ秒単位)。値 0 は、無限の時間を指定します。

BrokenConnectionAction

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

ネットワークの損失または制限時間を超えて接続が切断された場合にサーバーがセッションに対して実行するアクション。

切断 (0)

ユーザーがセッションから切断されています。

Terminate (1)

セッションはサーバーから完全に削除されます。

BrokenConnectionPolicy

データ型: uint32
アクセスの種類: 読み取り/書き込み

ネットワークの損失または制限時間を超えたために、サーバーが接続を中断するタイミングを決定するためにサーバーが使用するポリシー。

サーバーオーバーライド (1)

ユーザーの切断ポリシー設定は、サーバーによってオーバーライドされます。

ユーザーごと (0)

ユーザーの切断ポリシー設定が有効です。

Caption

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

オブジェクトの短い説明 (1 行文字列)。

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

説明

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

オブジェクトの説明。

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

DisconnectedSessionLimit

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

切断されたセッションが終了するまでの時間間隔 (ミリ秒単位)。値 0 は、無限の時間を指定します。

EnableTimeoutWarning

データ型: uint32
アクセスの種類: 読み取り/書き込み

タイムアウト警告を有効にします。

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008: このプロパティは使用できません。

IdleSessionLimit

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

アイドル状態のセッションが終了するまでの時間間隔 (ミリ秒単位)。値 0 は、無限の時間を指定します。

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: マッピング文字列 ("MIF.DMTF|ComponentID|001.5")

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

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

名前

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

オブジェクトの名前。

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

PolicySourceActiveSessionLimit

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

ActiveSessionLimit プロパティがサーバー、グループポリシー、または既定で構成されているかどうかを示します。

サーバー

グループポリシー

Default

PolicySourceBrokenConnectionAction

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

BrokenConnectionAction プロパティがサーバー、グループポリシー、または既定で構成されているかどうかを示します。

サーバー

グループポリシー

Default

PolicySourceDisconnectedSessionLimit

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

DisconnectedSessionLimit プロパティがサーバー、グループポリシー、または既定で構成されているかどうかを示します。

サーバー

グループポリシー

Default

PolicySourceIdleSessionLimit

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

IdleSessionLimit プロパティがサーバー、グループポリシー、または既定で構成されているかどうかを示します。

サーバー

グループポリシー

Default

PolicySourceReconnectionPolicy

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

ReconnectPolicy プロパティがサーバー、グループポリシー、または既定で構成されているかどうかを示します。

サーバー

グループポリシー

Default

ReconnectionPolicy

データ型: uint32
アクセスの種類: 読み取り/書き込み

切断されたセッションに再接続するために、ユーザーが前のクライアントを使用する必要があるかどうかを指定します。

Any Client (0)

すべてのクライアントが再接続に使用されます。

以前のクライアント (1)

接続で使用された以前のクライアントは、再接続に使用されます。

状態

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

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

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

("OK")

("Error")

("Degraded")

("不明")

("Pred Fail")

("Starting")

("Stopping")

("Service")

TerminalName

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

ターミナルの名前。

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

TimeLimitPolicy

データ型: uint32
アクセスの種類: 読み取り/書き込み

サーバーがユーザーセッションの時間制限を決定するために使用するポリシー。

ユーザーごと (0)

ユーザーの制限時間ポリシー設定は有効です。

サーバーのオーバーライド (1)

ユーザーの制限時間ポリシー設定は、サーバーによってオーバーライドされます。

注釈

コンソールセッションに関連付けられている 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	TSCfgWmi.mof
[DLL]	TSCfgWmi.dll

こちらもご覧ください

Win32_TerminalSetting
CIM_Setting

次の方法で共有

Win32_TSSessionSetting クラス

構文

メンバー

メソッド

プロパティ

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース