共用方式為

Win32_TSSessionSetting 類別

  • 發行項

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類別具有這些方法。

方法 Description
BrokenConnection 設定這個類別中包含的中斷連接屬性。
TimeLimit 設定這個類別中包含的時間限制屬性。

屬性

Win32_TSSessionSetting類別具有這些屬性。

ActiveSessionLimit

資料類型： uint32

存取類型：唯讀

配置給作用中會話的時間上限，以毫秒為單位。 值為 0 會指定無限的時間量。

BrokenConnectionAction

資料類型： uint32

存取類型：唯讀

當連線因網路遺失或超過時間限制而中斷時，伺服器在會話上所採取的動作。

中斷 連線 (0)

使用者與會話中斷連線。

終止 (1)

會話會從伺服器永久刪除。

BrokenConnectionPolicy

資料類型： uint32

存取類型：讀取/寫入

伺服器用來判斷何時因網路遺失或超過時間限制而中斷連線的原則。

Server-Override (1)

伺服器的中斷連線原則設定會被覆寫。

每個使用者 (0)

使用者的中斷連線原則設定生效。

標題

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (64)

簡短描述 (物件的單行字串) 。

此屬性繼承自 CIM_ManagedSystemElement。

說明

資料類型： 字串

存取類型：唯讀

物件的描述。

此屬性繼承自 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。

名稱

資料類型： 字串

存取類型：唯讀

物件的名稱。

此屬性繼承自 CIM_ManagedSystemElement。

PolicySourceActiveSessionLimit

資料類型： uint32

存取類型：唯讀

指出 ActiveSessionLimit 屬性是由伺服器、群組原則或預設設定。

0

伺服器

1

群組原則

2

預設

PolicySourceBrokenConnectionAction

資料類型： uint32

存取類型：唯讀

指出伺服器、群組原則或預設是否設定 BrokenConnectionAction 屬性。

0

伺服器

1

群組原則

2

預設

PolicySourceDisconnectedSessionLimit

資料類型： uint32

存取類型：唯讀

指出 Server、群組原則或預設是否設定 DisconnectedSessionLimit 屬性。

0

伺服器

1

群組原則

2

預設

PolicySourceIdleSessionLimit

資料類型： uint32

存取類型：唯讀

指出 Server、群組原則或預設是否設定 IdleSessionLimit 屬性。

0

伺服器

1

群組原則

2

預設

PolicySourceReconnectionPolicy

資料類型： uint32

存取類型：唯讀

指出是否由伺服器、群組原則或預設設定 ReconnectPolicy 屬性。

0

伺服器

1

群組原則

2

預設

ReconnectionPolicy

資料類型： uint32

存取類型：讀取/寫入

指定使用者是否必須使用先前的用戶端重新連線到已中斷連線的會話。

任何用戶端 (0)

任何用戶端都會用來重新連線。

上一個用戶端 (1)

連線中使用的先前用戶端將用來重新連線。

狀態

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (10)

物件的目前狀態。 您可以定義各種操作和非操作狀態。 作業狀態包括：「確定」、「降級」和「預先失敗」 (啟用智慧型硬碟等元素，可能會正常運作，但預測近期的失敗) 。 非操作狀態包括：「Error」、「Starting」、「Stopping」 和 「Service」。 後者的「服務」可能會在磁片的鏡像重新儲存期間套用、重載使用者權限清單或其他系統管理工作。 並非所有這類工作都是線上工作，但 Managed 元素既不是「確定」，也不是處於其他狀態之一。

此屬性繼承自 CIM_ManagedSystemElement。

(「OK」)

(「錯誤」)

(「降級」)

(「Unknown」)

(「預先失敗」)

(「Starting」)

(「停止」)

(「Service」)

TerminalName

資料類型： 字串

存取類型：唯讀

終端機的名稱。

此屬性繼承自 Win32_TerminalSetting。

TimeLimitPolicy

資料類型： uint32

存取類型：讀取/寫入

伺服器用來判斷使用者會話的時間限制原則。

每個使用者 (0)

使用者的時間限制原則設定生效。

伺服器覆寫 (1)

伺服器會覆寫使用者的時間限制原則設定。

備註

請注意，與主控台會話相關聯的 Winstations 無法存取這個類別的方法和屬性。 如果嘗試執行此動作，方法是將 「Console」 指定為 TerminalName 屬性的值，這個物件的方法會傳回 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")

Managed 物件格式 (MOF) 檔案包含 Windows Management Instrumentation (WMI) 類別的定義。 MOF 檔案不會安裝為 Microsoft Windows 軟體發展工具組的一部分， (SDK) 。 當您使用 伺服器管理員 新增相關聯的角色時，它們會安裝在伺服器上。 如需 MOF 檔案的詳細資訊，請參閱 Managed Object Format (MOF) 。

規格需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
命名空間
 Root\CIMv2\TerminalServices
MOF
TSCfgWmi.mof
DLL
TSCfgWmi.dll

另請參閱

Win32_TerminalSetting

CIM_Setting