Win32_TSSessionDirectory 類別

發行項
06/13/2023

定義 Win32_TSSessionDirectorySetting 類別的遠端桌面連線代理人 (RD 連線代理人 ) 組態設定。

注意

在 Windows Server 2008 R2 中，終端機服務會話代理人的名稱 (TS 會話代理人) 已變更為 RD 連線代理人。除非另有說明，否則這些屬性會套用至所有支援的作業系統。

下列語法會從 MOF 程式碼簡化，並依字母順序包含所有已定義和繼承的屬性。如需方法的參考資訊，請參閱本主題稍後的方法資料表。

語法

[dynamic, provider("Win32_WIN32_TSSESSIONDIRECTORY_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TSSessionDirectory : CIM_Setting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   SessionDirectoryLocation;
  uint32   PolicySourceSessionDirectoryLocation;
  uint32   SessionDirectoryActive;
  uint32   PolicySourceSessionDirectoryActive;
  uint32   SessionDirectoryExposeServerIP;
  uint32   PolicySourceSessionDirectoryExposeServerIP;
  string   SessionDirectoryClusterName;
  uint32   PolicySourceLoadBalancing;
  uint32   GetLoadBalancingState;
  uint32   GetServerWeight;
  uint32   PolicySourceSessionDirectoryClusterName;
  string   SessionDirectoryIPAddress;
  uint32   GetTSRedirectorMode;
  uint32   PolicySourceTSRedirectorMode;
};

成員

Win32_TSSessionDirectory類別具有下列類型的成員：

方法
屬性

方法

Win32_TSSessionDirectory類別具有這些方法。

方法	Description
CreateUserDiskTemplate	建立使用者磁片範本。
DisableUserVhd	停用使用者設定檔 VHD。
EnableUserVhd	在 RDSH 伺服器上啟用使用者設定檔 VHD。
GetCurrentRedirectableAddresses	取得目前設定的 DNS 合格地址清單，以及重新導向類型。
GetRedirectableAddresses	取得 DNS 合格位址的完整清單。
PingSessionDirectory	檢查 RD 連線代理人伺服器是否可用。
SetCurrentRedirectableAddresses	設定 DNS 合格位址和重新導向類型的已設定清單。
SetLoadBalancingState	設定值，指出伺服器是否會參與 RD 連線代理人負載平衡。
SetServerWeight	設定 RD 連線代理人負載平衡的伺服器權數值。
SetSessionDirectoryActive	停用並啟用 RD 連線代理人。
SetSessionDirectoryExposeServerIP	設定 SessionDirectoryExposeServerIP 屬性。
SetSessionDirectoryProperty	設定 SessionDirectoryLocation 屬性或 SessionDirectoryClusterName 屬性。
SetTSRedirectorMode	這個方法無法使用。

屬性

Win32_TSSessionDirectory類別具有這些屬性。

標題

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (64)

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

此屬性繼承自 CIM_ManagedSystemElement。

說明

資料類型：字串
存取類型：唯讀

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

GetLoadBalancingState

資料類型： uint32
存取類型：唯讀

指出伺服器是否已設定為參與 RD 連線代理人負載平衡。

0

伺服器未設定為參與 RD 連線代理人負載平衡。

1

伺服器已設定為參與 RD 連線代理人負載平衡。

GetServerWeight

資料類型： uint32
存取類型：唯讀

擷取 RD 連線代理人負載平衡中使用的伺服器權數值。

GetTSRedirectorMode

資料類型： uint32
存取類型：唯讀

指出伺服器是否設定為做為遠端桌面服務重新導向器。

伺服器設定為做為遠端桌面服務重新導向器。

伺服器未設定為做為遠端桌面服務重新導向器。

Windows Server 2008： 此屬性無法使用。

InstallDate

資料類型： datetime
存取類型：唯讀
限定詞： 對應字串 (「MIF。DMTF|ComponentID|001.5「)

安裝物件的日期。缺少值並不表示未安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

名稱

資料類型：字串
存取類型：唯讀

物件的名稱。

此屬性繼承自 CIM_ManagedSystemElement。

PolicySourceLoadBalancing

資料類型： uint32
存取類型：唯讀

指出伺服器或群組原則是否已設定 GetLoadBalancingState 屬性。

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceSessionDirectoryActive

資料類型： uint32
存取類型：唯讀

指出 SessionDirectoryActive 屬性是由伺服器或群組原則所設定。

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceSessionDirectoryClusterName

資料類型： uint32
存取類型：唯讀

指出伺服器或群組原則是否已設定 SessionDirectoryClusterName 屬性。

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceSessionDirectoryExposeServerIP

資料類型： uint32
存取類型：唯讀

指出伺服器或群組原則是否已設定 SessionDirectoryExposeServerIP 屬性。

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceSessionDirectoryLocation

資料類型： uint32
存取類型：唯讀

指出 SessionDirectoryLocation 屬性是由伺服器或群組原則所設定。

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceTSRedirectorMode

資料類型： uint32
存取類型：唯讀

此屬性無法使用。

Windows Server 2008 R2： 指出 GetTSRedirectorMode 屬性是由伺服器或群組原則所設定。

0 (0x0)

伺服器

1 (0x1)

群組原則

SessionDirectoryActive

資料類型： uint32
存取類型：唯讀
限定詞： 索引鍵

指定遠端桌面服務是否參與 RD 連線代理人。

FALSE (0)

已停用遠端桌面服務參與 RD 連線代理人。

TRUE (1)

已啟用遠端桌面服務參與 RD 連線代理人。

SessionDirectoryClusterName

資料類型：字串
存取類型：唯讀

RD 工作階段主機伺服器所屬叢集的虛擬 IP 位址。

SessionDirectoryExposeServerIP

資料類型： uint32
存取類型：唯讀

指定是否允許擷取 RD 連線代理人的 IP 位址。

FALSE (0)

擷取遭到拒絕。

TRUE (1)

允許擷取。

SessionDirectoryIPAddress

資料類型：字串
存取類型：讀取/寫入

會話目錄所使用的 LAN 介面卡 IP 位址。

SessionDirectoryLocation

資料類型：字串
存取類型：唯讀

執行 RD 連線代理人服務之伺服器的網路 DNS 名稱或 IP 位址。

狀態

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (10)

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

此屬性繼承自 CIM_ManagedSystemElement。

(「OK」)

(「Error」)

(「降級」)

(「Unknown」)

(「預先失敗」)

(「Starting」)

(「Stopping」)

(「Service」)

備註

若要連線到 \\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")

在 Windows Server 2008 中，終端機服務會話目錄功能的名稱已變更為終端機服務會話代理人。

在 Windows Server 2008 R2 中，終端機服務會話代理人功能的名稱已變更為遠端桌面連線代理人。

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

規格需求

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

另請參閱

CIM_Setting
Win32_TSSessionDirectorySetting

共用方式為

Win32_TSSessionDirectory 類別

語法

成員

方法

屬性

備註

規格需求

另請參閱

意見反應

其他資源