Win32_TSClientSetting 類別

發行項
06/12/2023

Win32_TSClientSetting WMI 類別會定義與連線原則相關的Win32_Terminal類別組態設定。

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

語法

[dynamic, provider("Win32_WIN32_TSCLIENTSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSClientSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ConnectionPolicy;
  uint32   ConnectClientDrivesAtLogon;
  uint32   ConnectPrinterAtLogon;
  uint32   DefaultToClientPrinter;
  uint32   PolicySourceDefaultToClientPrinter;
  uint32   WindowsPrinterMapping;
  uint32   PolicySourceWindowsPrinterMapping;
  uint32   LPTPortMapping;
  uint32   PolicySourceLPTPortMapping;
  uint32   COMPortMapping;
  uint32   PolicySourceCOMPortMapping;
  uint32   DriveMapping;
  uint32   PolicySourceDriveMapping;
  uint32   AudioMapping;
  uint32   PolicySourceAudioMapping;
  uint32   ClipboardMapping;
  uint32   PolicySourceClipboardMapping;
  uint32   ColorDepthPolicy;
  uint32   PolicySourceColorDepthPolicy;
  uint32   ColorDepth;
  uint32   PolicySourceColorDepth;
  uint32   MaxMonitors;
  uint32   MaxXResolution;
  uint32   MaxYResolution;
  uint32   PolicySourceMaxMonitors;
  uint32   PolicySourceMaxResolution;
  uint32   PNPRedirection;
  uint32   PolicySourcePNPRedirection;
  uint32   AudioCaptureRedir;
  uint32   PolicySourceAudioCaptureRedir;
  uint32   VideoPlaybackRedir;
  uint32   PolicySourceVideoPlaybackRedir;
  uint32   AllowDwm;
  uint32   PolicySourceAllowDwm;
  uint32   PolicyAdvancedRemoteAppGraphics;
  uint32   AdvancedRemoteAppGraphics;
  uint32   RemoteSessionProfile;
  uint32   PolicySourceRemoteSessionProfile;
  uint32   AVC444ModePreferred;
  uint32   PolicySourceAvc444ModePreferred;
  uint32   EncodeImageQuality;
  uint32   PolicySourceEncodeImageQuality;
  uint32   HardwareGraphicsAdapter;
  uint32   PolicySourceHardwareGraphicsAdapter;
  uint32   SelectTransport;
  uint32   PolicySourceSelectTransport;
  uint32   SelectNetworkDetect;
  uint32   PolicySourceSelectNetworkDetect;
};

成員

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

方法
屬性

方法

Win32_TSClientSetting類別具有這些方法。

方法	Description
ConnectionSettings	設定這個類別的 ConnectClientDrivesAtLogon、 ConnectPrinterAtLogon和 DefaultToClientPrinter 屬性。
SetAllowDwm	不支援。 Windows 7 和 Windows Server 2008 R2：設定 AllowDwm 屬性。
SetClientProperty	設定LPTPortMapping、COMPortMapping、AudioMapping、ClipboardMapping、DriveMapping或WindowsPrinterMapping屬性。
SetColorDepth	設定 ColorDepth 屬性。
SetColorDepthPolicy	設定 ColorDepthPolicy 屬性。
SetMaxMonitors	設定 MaxMonitors 屬性。
SetMaxXResolution	設定 MaxXResolution 屬性。
SetMaxYResolution	設定 MaxYResolution 屬性。

屬性

Win32_TSClientSetting類別具有這些屬性。

AdvancedRemoteAppGraphics

資料類型： uint32
存取類型：讀取/寫入

指定是否啟用 RemoteApp 的進階 RemoteFX 圖形。

Windows Server 2012、Windows 8、Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista：此屬性在 Windows Server 2012 R2 和 Windows 8.1 之前無法使用。

FALSE (0)

進階圖形已停用。

TRUE (1)

已啟用進階圖形。

AllowDwm

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

此屬性無法使用。

**Windows 7 和 Windows Server 2008 R2： **

指定是否要啟用或停用遠端桌面組合。零會停用遠端桌面組合，且非零值會啟用它。

使用 SetAllowDwm 方法來修改此屬性。

AudioCaptureRedir

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

指定是否允許音訊擷取重新導向。

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

FALSE (0)

TRUE (1)

AudioMapping

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

指定是否停用或啟用音訊對應。

FALSE (0)

已啟用音訊對應。

TRUE (1)

音訊對應已停用。

AVC444ModePreferred

資料類型： uint32
存取類型：讀取/寫入

指定是否偏好 AVC444 模式。

Windows 8.1、Windows Server 2012 R2、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 10之前無法使用或Windows Server 2016。

FALSE (0)

TRUE (1)

標題

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

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

此屬性繼承自 CIM_ManagedSystemElement。

ClipboardMapping

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

指定是否停用或啟用剪貼簿對應。

FALSE (0)

已啟用剪貼簿對應。

TRUE (1)

剪貼簿對應已停用。

ColorDepth

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

指定色彩深度。如需可能的值，請參閱 SetColorDepth 方法。

8 位 (1)

15 位 (2)

16 位 (3)

24 位 (4)

32 位 (5)

ColorDepthPolicy

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

指定是否要覆寫使用者的最大色彩設定。

FALSE (0)

請勿覆寫使用者的原則。

TRUE (1)

覆寫使用者的原則。

COMPortMapping

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

指定是否停用或啟用 COM 埠對應。

FALSE (0)

已啟用 COM 埠對應。

TRUE (1)

COM 埠對應已停用。

ConnectClientDrivesAtLogon

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

指定用戶端的磁片磁碟機是否會在登入程式期間自動連線。

FALSE (0)

磁片磁碟機不會自動連線。

TRUE (1)

磁片磁碟機會自動連線。

ConnectionPolicy

資料類型： uint32
存取類型：讀取/寫入

伺服器用來擷取使用者連線設定的原則。

每位使用者 (0)

使用者的連線設定已生效。

Server-Override (1)

伺服器的連線設定會覆寫使用者的連線設定。

ConnectPrinterAtLogon

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

指定用戶端的所有對應本機印表機是否會在登入程式期間自動連線。

FALSE (0)

本機印表機不會自動連線。

TRUE (1)

本機印表機會自動連線。

DefaultToClientPrinter

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

指定是否會自動將列印工作傳送至用戶端的本機印表機。

FALSE (0)

列印工作不會自動傳送至用戶端的本機印表機。

TRUE (1)

列印工作會自動傳送至用戶端的本機印表機。

說明

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

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

DriveMapping

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

指定磁片磁碟機對應已停用或啟用。

FALSE (0)

已啟用磁片磁碟機對應。

TRUE (1)

磁片磁碟機對應已停用。

EncodeImageQuality

資料類型： uint32
存取類型：讀取/寫入

指定 RDP 體驗的影像品質。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 8或Windows Server 2012之前無法使用。

無遺失 (1)

high (2)

中 (3)

HardwareGraphicsAdapter

資料類型： uint32
存取類型：讀取/寫入

指定 RD 工作階段主機伺服器是否使用硬體圖形轉譯器作為預設介面卡。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 8或Windows Server 2012之前無法使用。

FALSE (0)

TRUE (1)

InstallDate

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

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

此屬性繼承自 CIM_ManagedSystemElement。

LPTPortMapping

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

指定是否停用或啟用 LPT 埠對應。

FALSE (0)

已啟用 LPT 埠對應。

TRUE (1)

LPT 埠對應已停用。

MaxMonitors

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

伺服器支援的監視數目上限。使用 SetMaxMonitors 方法來修改此屬性。

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

MaxXResolution

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

伺服器支援的 X 解析度上限。使用 SetMaxXResolution 方法來修改這個屬性。

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

MaxYResolution

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

伺服器支援的最大 Y 解析度。使用 SetMaxYResolution 方法來修改這個屬性。

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

名稱

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

物件的名稱。

此屬性繼承自 CIM_ManagedSystemElement。

PNPRedirection

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

指定是否允許重新導向隨插即用。

FALSE (0)

允許重新導向隨插即用。

TRUE (1)

不允許隨插即用重新導向。

PolicyAdvancedRemoteAppGraphics

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

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

Windows Server 2012、Windows 8、Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista：此屬性在 Windows Server 2012 R2 和 Windows 8.1之前無法使用。

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceAllowDwm

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

此屬性無法使用。

**Windows 7 和 Windows Server 2008 R2： **

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceAudioCaptureRedir

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

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceAudioMapping

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

PolicySourceAvc444ModePreferred

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

指出 如何設定 AVC444ModePreferredis 屬性。

伺服器

群組原則

PolicySourceClipboardMapping

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

指出 剪貼簿Mapping 屬性是由伺服器、群組原則或預設設定。

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

PolicySourceColorDepth

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

PolicySourceColorDepthPolicy

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

PolicySourceCOMPortMapping

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

PolicySourceDefaultToClientPrinter

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

PolicySourceDriveMapping

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

PolicySourceEncodeImageQuality

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

指出 EncodeImageQualityi 的設定方式。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 8或Windows Server 2012之前無法使用。

伺服器

群組原則

PolicySourceHardwareGraphicsAdapter

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

指出 HardwareGraphicsAdapter 的設定方式。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 8或Windows Server 2012之前無法使用。

伺服器

群組原則

PolicySourceLPTPortMapping

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

PolicySourceMaxMonitors

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

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

PolicySourceMaxResolution

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

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

PolicySourcePNPRedirection

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceRemoteSessionProfile

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

指出 RemoteSessionProfile 的設定方式。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 8或Windows Server 2012之前無法使用。

伺服器

群組原則

PolicySourceSelectNetworkDetect

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

指出 SelectNetworkDetect 屬性的設定方式。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 8或Windows Server 2012之前無法使用。

伺服器

群組原則

PolicySourceSelectTransport

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

指出 SelectTransport 屬性的設定方式。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 8或Windows Server 2012之前無法使用。

伺服器

群組原則

PolicySourceVideoPlaybackRedir

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

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

PolicySourceWindowsPrinterMapping

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

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

0 (0x0)

伺服器

1 (0x1)

群組原則

2 (0x2)

預設

RemoteSessionProfile

資料類型： uint32
存取類型：讀取/寫入

指定 RDP 體驗的設定檔。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 8或Windows Server 2012之前無法使用。

scale (1)

體驗 (2)

頻寬 (3)

SelectNetworkDetect

資料類型： uint32
存取類型：讀取/寫入

指定是否使用網路偵測。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 8或Windows Server 2012之前無法使用。

用於連線時間且處於穩定狀態。

在連線時間停用

處於穩定狀態的停用

在連線時間和處於穩定狀態時停用。

SelectTransport

資料類型： uint32
存取類型：讀取/寫入

指定哪些傳輸通訊協定可用於對伺服器的 RDP 存取。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此屬性在Windows 8或Windows Server 2012之前無法使用。

同時使用 UDP 和 TCP。

僅使用 TCP。

使用 UDP 或 TCP。

狀態

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

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

此屬性繼承自 CIM_ManagedSystemElement。

(「OK」)

(「錯誤」)

(「降級」)

(「Unknown」)

(「預先失敗」)

(「Starting」)

(「停止」)

(「Service」)

TerminalName

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

終端機的名稱。

此屬性繼承自 Win32_TerminalSetting。

VideoPlaybackRedir

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

指定是否允許視訊播放重新導向。

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

FALSE (0)

TRUE (1)

WindowsPrinterMapping

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

指定是否停用或啟用用戶端視窗的印表機對應。

FALSE (0)

已啟用印表機對應。

TRUE (1)

印表機對應已停用。

備註

請注意，與主控台會話相關聯的視窗月臺無法存取這個類別的方法和屬性。如果嘗試執行此動作，方法是將「Console」指定為 TerminalName 屬性的值，則這個物件的方法會傳回 WBEM_E_NOT_SUPPORTED。如果視窗月臺嘗試呼叫這個物件的方法，以新增或修改 LocalSystem、LocalService 或 NetworkService 帳戶的安全性屬性，也會傳回這個錯誤碼。

若要連線到 \root\CIMV2\TerminalServices 命名空間，驗證層級必須包含封包隱私權。針對 C/C++ 呼叫，這是 RPC_C_AUTHN_LEVEL_PKT_PRIVACY的驗證層級。針對 Visual Basic 和腳本呼叫，這是 WbemAuthenticationLevelPktPrivacy 或「pktPrivacy」的驗證層級，值為六。

下列 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_Terminal
Win32_TerminalSetting
CIM_Setting

共用方式為

Win32_TSClientSetting 類別

語法

成員

方法

屬性

備註

規格需求

另請參閱

意見反應

其他資源