共用方式為

Win32_TerminalServiceSetting 類別

  • 發行項

Win32_TerminalServiceSetting WMI 類別代表遠端桌面工作階段主機 (RD 工作階段主機) 伺服器的組態。 設定包括 RD 工作階段主機伺服器模式、授權、Active Desktop、許可權、刪除暫存資料夾，以及會話臨時目錄等功能。

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

語法

[dynamic, provider("Win32_WIN32_TERMINALSERVICESETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TerminalServiceSetting : CIM_Setting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   ServerName;
  uint32   TerminalServerMode;
  uint32   GetCapabilitiesID;
  uint32   LicensingType;
  uint32   PolicySourceLicensingType;
  uint32   PossibleLicensingTypes;
  string   LicensingName;
  string   LicensingDescription;
  uint32   ActiveDesktop;
  uint32   UserPermission;
  uint32   DeleteTempFolders;
  uint32   PolicySourceDeleteTempFolders;
  uint32   UseTempFolders;
  uint32   PolicySourceUseTempFolders;
  uint32   AllowTSConnections;
  uint32   PolicySourceAllowTSConnections;
  uint32   SingleSession;
  uint32   PolicySourceSingleSession;
  string   ProfilePath;
  uint32   PolicySourceProfilePath;
  string   HomeDirectory;
  uint32   PolicySourceHomeDirectory;
  uint32   TimeZoneRedirection;
  uint32   PolicySourceTimeZoneRedirection;
  string   Logons;
  string   DirectConnectLicenseServers;
  uint32   PolicySourceDirectConnectLicenseServers;
  uint32   PolicySourceConfiguredLicenseServers;
  uint32   DisableForcibleLogoff;
  uint32   PolicySourceDisableForcibleLogoff;
  uint32   FallbackPrintDriverType;
  uint32   PolicySourceFallbackPrintDriverType;
  uint32   SessionBrokerDrainMode;
  uint32   LimitedUserSessions;
  uint32   EnableDFSS;
  uint32   PolicySourceEnableDFSS;
  uint32   EnableRemoteDesktopMSI;
  uint32   PolicySourceEnableRemoteDesktopMSI;
  uint32   EnableAutomaticReconnection;
  uint32   PolicySourceEnableAutomaticReconnection;
  uint32   UseRDEasyPrintDriver;
  uint32   PolicySourceUseRDEasyPrintDriver;
  uint32   RedirectSmartCards;
  uint32   PolicySourceRedirectSmartCards;
  uint32   EnableDiskFSS;
  uint32   EnableNetworkFSS;
  uint32   NetworkFSSUserSessionWeight;
  uint32   NetworkFSSLocalSystemWeight;
  uint32   NetworkFSSCatchAllWeight;
};

成員

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

方法

Win32_TerminalServiceSetting類別具有這些方法。

方法 Description
AddDirectConnectLicenseServer 在企業中設定新的授權伺服器。
AddLSToSpecifiedLicenseServerList 將指定的授權伺服器新增至指定授權伺服器清單的結尾。
CanAccessLicenseServer 判斷是否允許 RD 工作階段主機伺服器從遠端桌面授權伺服器要求遠端桌面服務用戶端存取授權， (RDS CAL) 。
ChangeMode 設定遠端桌面授權伺服器的授權類型。
CreateWinstation 根據接聽程式名稱和 NIC 的唯一組合，建立新的接聽程式堆疊。
DeleteDirectConnectLicenseServer 從企業刪除指定的授權伺服器。
EmptySpecifiedLicenseServerList 從指定的授權伺服器清單中移除所有授權伺服器。
FindLicenseServers 列舉所有遠端桌面授權伺服器和探索方法。
GetDomain 擷取 RD 工作階段主機伺服器所屬的網功能變數名稱稱。
GetGracePeriodDays 擷取 RD 工作階段主機伺服器的 RD 授權寬限期剩餘天數。
GetRegisteredLicenseServerList 取得已註冊的授權伺服器清單。
GetSpecifiedLicenseServerList 擷取指定授權伺服器的清單。
GetTSLanaIds 取得遠端桌面服務網路介面卡的識別碼和描述。
GetTStoLSConnectivityStatus 決定遠端桌面服務與授權伺服器之間的線上狀態。
GetWinstationDriverNames 擷取 Winstation 驅動程式名稱的清單。
PingLicenseServer Ping 授權伺服器以判斷它是否為有效的授權伺服器。
RemoveLSFromSpecifiedLicenseServerList 從指定的授權伺服器清單中移除指定的授權伺服器。
SetAllowTSConnections 設定 AllowTSConnections 屬性。
SetDisableForcibleLogoff 設定 DisableForcibleLogoff 屬性。
SetFallbackPrintDriverType 設定 FallbackPrintDriverType 屬性。
SetHomeDirectory 設定 HomeDirectory 屬性。
SetPolicyPropertyName 設定下列其中一個屬性： DeleteTempFolders 或 UseTempFolders。
SetPrimaryLicenseServer 將指定的授權伺服器設定為指定授權伺服器清單中的第一個專案。
SetProfilePath 設定 ProfilePath 屬性。
SetSingleSession 設定 SingleSession 屬性。
SetSpecifiedLicenseServerList 更新指定授權伺服器的清單，取代任何現有的指定授權伺服器。
SetTimeZoneRedirection 設定 TimeZoneRedirection 屬性。
UpdateDirectConnectLicenseServer 更新探索授權伺服器清單。

屬性

Win32_TerminalServiceSetting類別具有這些屬性。

ActiveDesktop

資料類型： uint32

存取類型：讀取/寫入

指定每個使用者會話中是否允許使用中的桌面。

TRUE (0)

每個使用者會話中都不允許使用中的桌面。

FALSE (1)

每個使用者會話都允許使用中的桌面。

AllowTSConnections

資料類型： uint32

存取類型：唯讀

指定是否允許新的遠端桌面服務連線。

FALSE (0)

不允許新的連線。

TRUE (1)

允許新的連線。

標題

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (64)

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

此屬性繼承自 CIM_ManagedSystemElement。

DeleteTempFolders

資料類型： uint32

存取類型：唯讀

指定是否在結束時刪除臨時目錄。

FALSE (0)

停用刪除臨時目錄。

TRUE (1)

已啟用刪除臨時目錄。

說明

資料類型： 字串

存取類型：唯讀

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

DirectConnectLicenseServers

資料類型： 字串

存取類型：唯讀

限定詞： 已淘汰

此屬性無法使用。

Windows Server 2008： 列舉授權伺服器的清單。

DisableForcibleLogoff

資料類型： uint32

存取類型：唯讀

判斷登入主控台的系統管理員是否可以強制登出。

0

系統管理員可以強制登出。

1

系統管理員無法強制登出。

EnableAutomaticReconnection

資料類型： uint32

存取類型：讀取/寫入

指定如果網路連結暫時遺失，是否允許遠端桌面連線用戶端自動重新連線到 RD 工作階段主機伺服器上的會話。

0 (0x0)

自動重新連線已停用。

1 (0x1)

已啟用自動重新連線。

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

EnableDFSS

資料類型： uint32

存取類型：讀取/寫入

指出是否啟用或停用動態公平共用排程 (DFSS) 。 這可以是下列其中一個值。

Windows Server 2008： 此屬性在 Windows Server 2008 R2 之前無法使用。

0

已停用 DFSS。

1

已啟用 DFSS。

EnableDiskFSS

資料類型： uint32

存取類型：讀取/寫入

指定是否啟用磁片公平共用排程。

0 (0x0)

磁片公平共用排程已停用。

1 (0x1)

已啟用磁片公平共用排程。

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

EnableNetworkFSS

資料類型： uint32

存取類型：讀取/寫入

指定是否啟用網路公平共用排程。

0 (0x0)

網路公平共用排程已停用。

1 (0x1)

已啟用網路公平共用排程。

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

EnableRemoteDesktopMSI

資料類型： uint32

存取類型：讀取/寫入

指出是否啟用或停用遠端桌面 MSI。

0 (0x0)

已停用

1 (0x1)

啟用

Windows Server 2008： 此屬性在 Windows Server 2008 R2 之前無法使用。

FallbackPrintDriverType

資料類型： uint32

存取類型：唯讀

指定要後援的印表機驅動程式。

無後援 dirvers=0 (0)

沒有後援驅動程式。

最佳猜測=1 (1)

最佳猜測。

最佳猜測，如果找不到相符專案後援到 PCL=2 (2)

最佳猜測。 如果找不到相符專案，請後援到 Hewlett-Packard印表機控制語言 (PCL) 。

最佳猜測，如果找不到相符專案後援至 PS=3 (3)

最佳猜測。 如果找不到相符專案，請後援至 Postscript (PS) 。

最佳猜測，如果找不到相符專案，則會同時顯示 PCL 和 PS 驅動程式=4 (4)

最佳猜測。 如果找不到相符專案，請同時顯示 PS 和 PCL 驅動程式。

GetCapabilitiesID

資料類型： uint32

存取類型：唯讀

提供者的功能識別碼。

HomeDirectory

資料類型： 字串

存取類型：唯讀

電腦的根目錄。

InstallDate

資料類型： datetime

存取類型：唯讀

限定詞： 對應字串 (「MIF。DMTF|ComponentID|001.5「)

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

此屬性繼承自 CIM_ManagedSystemElement。

LicensingDescription

資料類型： 字串

存取類型：唯讀

授權模式的簡短描述。

LicensingName

資料類型： 字串

存取類型：唯讀

授權模式的名稱。

LicensingType

資料類型： uint32

存取類型：唯讀

指定伺服器模式的授權類型。

個人終端機伺服器 (0)

個人 RD 工作階段主機伺服器。

( 1) 遠端桌面

用於管理的遠端桌面。

每個裝置 (2)

每部裝置。 適用于應用程式伺服器。

每位使用者 (3)

每個使用者。 適用于應用程式伺服器。

未 設定 (4)

未設定。

LimitedUserSessions

資料類型： uint32

存取類型：讀取/寫入

指出是否已啟用在 RD 工作階段主機伺服器上允許的作用中和非作用中會話數目的功能。 例如，您可能想要設定 LimitedUserSessions ，以確保安裝在 RD 工作階段主機伺服器上之特定應用程式的授權合規性。 或者，您可能想要限制負載平衡伺服器陣列中 RD 工作階段主機伺服器上的會話數目上限，以便在伺服器陣列中的另一部伺服器失敗時，伺服器將不會多載。

注意

為了管理目的，用來連線到伺服器的會話不受 LimitedUserSessions影響。

在 RD 工作階段主機伺服器陣列中，如果使用者超過會話限制，會話將會透過 RD 連線代理人負載平衡導向至另一部伺服器。 如果伺服器是獨立伺服器，使用者將無法連線。

由於為了管理目的而用來連線到伺服器的會話，以及登入週期期間強制執行會話數目的時間，因此建議您將 LimitedUserSessions 設定為稍微降低伺服器上會話數目的值。

LimitedUserSessions屬性只有在安裝 RD 工作階段主機角色服務時才有效。

0

這項功能已停用。

1 或更新版本

一或更大的值代表 RD 工作階段主機伺服器上允許的作用中和非作用中) 會話數目上限 (。

登錄

資料類型： 字串

存取類型：讀取/寫入

指定是否允許新的會話。 此設定不會影響現有的設定。

0

允許新的會話。

1

不允許新的會話。

名稱

資料類型： 字串

存取類型：唯讀

物件的名稱。

此屬性繼承自 CIM_ManagedSystemElement。

NetworkFSSCatchAllWeight

資料類型： uint32

存取類型：讀取/寫入

指定所有攔截網路流量的預設網路公平共用權數。 有效值為 1 到 9。

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

NetworkFSSLocalSystemWeight

資料類型： uint32

存取類型：讀取/寫入

指定本機系統進程的預設網路公平共用權數。 有效值為 1 到 9。

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

NetworkFSSUserSessionWeight

資料類型： uint32

存取類型：讀取/寫入

指定使用者會話的預設網路公平共用權數。 有效值為 1 到 9。

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

PolicySourceAllowTSConnections

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceConfiguredLicenseServers

資料類型： uint32

存取類型：唯讀

指出由伺服器或群組原則設定 GetSpecifiedLicenseServerList 方法所傳回的授權伺服器。

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceDeleteTempFolders

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceDirectConnectLicenseServers

資料類型： uint32

存取類型：唯讀

限定詞： 已淘汰

此屬性無法使用。

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceDisableForcibleLogoff

資料類型： uint32

存取類型：唯讀

不支援這個屬性。

Windows Server 2008： 判斷 DisableForcibleLogoff 屬性是由伺服器或群組原則所設定。

0

伺服器

1

群組原則。

PolicySourceEnableAutomaticReconnection

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

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

PolicySourceEnableDFSS

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

Windows Server 2008： 這個屬性在 Windows Server 2008 R2 之前無法使用。

PolicySourceEnableRemoteDesktopMSI

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

Windows Server 2008： 這個屬性在 Windows Server 2008 R2 之前無法使用。

PolicySourceFallbackPrintDriverType

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceHomeDirectory

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceLicensingType

資料類型： uint32

存取類型：唯讀

指出 授權類型 屬性是由伺服器或群組原則所設定。

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceProfilePath

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceRedirectSmartCards

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

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

PolicySourceSingleSession

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceTimeZoneRedirection

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceUseRDEasyPrintDriver

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

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

PolicySourceUseTempFolders

資料類型： uint32

存取類型：唯讀

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PossibleLicensingTypes

資料類型： uint32

存取類型：唯讀

限定詞： BitMap (「0」、「1」、「2」、「4」、「5」) 、 BitValues (「Personal Terminal Server」、「Remote Desktop for Administration」、「Per Device」、「Per User」、「Not Configured」)

位元遮罩，指定可用的授權類型。 這可以是下列一或多個值的組合。

1 (0x1)

支援個人 RD 工作階段主機伺服器授權。

2 (0x2)

支援遠端桌面授權。

4 (0x4)

支援每個裝置授權。

8 (0x8)

支援每個使用者授權。

ProfilePath

資料類型： 字串

存取類型：唯讀

電腦的設定檔路徑。

RedirectSmartCards

資料類型： uint32

存取類型：讀取/寫入

指定是否允許遠端會話中重新導向智慧卡裝置。

0 (0x0)

不允許智慧卡裝置重新導向。

1 (0x1)

允許智慧卡裝置重新導向。

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

ServerName

資料類型： 字串

存取類型：唯讀

限定詞： 金鑰

感興趣的 RD 工作階段主機伺服器名稱。

SessionBrokerDrainMode

資料類型： uint32

存取類型：讀取/寫入

RD 連線代理人使用者登入模式。

0

允許所有連線。

1

允許重新連線，但會防止新的登入，直到伺服器重新開機為止。

2

允許重新連線，但防止新的登入。

SingleSession

資料類型： uint32

存取類型：唯讀

指定每個使用者是否允許一或多個遠端桌面服務會話。

False (0)

每個使用者允許多個會話。

True (1)

每位使用者只允許一個會話。

狀態

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (10)

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

此屬性繼承自 CIM_ManagedSystemElement。

(「OK」)

(「錯誤」)

(「降級」)

(「Unknown」)

(「預先失敗」)

(「Starting」)

(「停止」)

(「Service」)

TerminalServerMode

資料類型： uint32

存取類型：唯讀

遠端桌面服務服務的 RD 工作階段主機伺服器作業模式。 此模式可控制適用的授權原則，以及是否啟用應用程式相容性功能。

AppServer (1)

伺服器會以應用程式伺服器的形式運作。

RemoteAdmin (0)

會話會從遠端系統管理。

TimeZoneRedirection

資料類型： uint32

存取類型：唯讀

指定用戶端電腦是否可以將其時區設定重新導向至遠端桌面服務會話。

0

重新導向已停用。

1

已啟用重新導向。

UseRDEasyPrintDriver

資料類型： uint32

存取類型：讀取/寫入

指定是否先使用遠端桌面簡易列印印表機驅動程式來安裝所有用戶端印表機。

0

RD 工作階段主機伺服器會嘗試尋找適當的印表機驅動程式來安裝用戶端印表機。 如果 RD 工作階段主機伺服器沒有符合用戶端印表機的印表機驅動程式，伺服器會嘗試使用遠端桌面簡易列印驅動程式來安裝用戶端印表機。

1

RD 工作階段主機伺服器會先嘗試使用遠端桌面簡易列印印表機驅動程式來安裝所有用戶端印表機。 如果基於任何原因而無法使用遠端桌面簡易列印印表機驅動程式，則會使用與用戶端印表機相符之 RD 工作階段主機伺服器上的印表機驅動程式。

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

UserPermission

資料類型： uint32

存取類型：讀取/寫入

指定每個使用者會話是否具有緊密或寬鬆的安全性。

FALSE (0)

安全性很緊密。

TRUE (1)

安全性已寬鬆。

UseTempFolders

資料類型： uint32

存取類型：唯讀

指定是否根據每個會話建立和刪除臨時目錄。

FALSE (0)

不會為每個會話建立和刪除臨時目錄。 一個是針對第一個會話建立的，永遠不會刪除。

TRUE (1)

系統會為每個會話建立和刪除臨時目錄。

備註

Win32_TerminalServiceSetting與Win32_TerminalService相關聯，做為Win32_TerminalServiceToSetting關聯之Setting屬性。

Win32_TerminalSetting與Win32_Terminal相關聯，做為Win32_TerminalTerminalSetting關聯之Setting屬性。

若要連線到 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 物件格式 (MOF) 。

規格需求

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

另請參閱

CIM_Setting

Win32_Terminal

Win32_TerminalService

Win32_TerminalServiceToSetting

Win32_TerminalTerminalSetting

CIM_Setting