Win32_TSClientSetting クラス

[アーティクル]
06/13/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 クラスには、これらのメソッドがあります。

メソッド	説明
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: このプロパティは、R2 とWindows 8.1をWindows Server 2012する前には使用できません。

FALSE (0)

高度なグラフィックスは無効になっています。

TRUE (1)

高度なグラフィックスが有効になっています。

AllowDwm

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

このプロパティは使用できません。

**Windows 7 および Windows Server 2008 R2: **

リモートデスクトップコンポジションを有効または無効にするかどうかを指定します。 0 はリモートデスクトップコンポジションを無効にし、0 以外の値を指定すると有効になります。

このプロパティを変更するには 、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)

Caption

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

オブジェクトの簡単な説明 (1 行文字列)。

このプロパティは、 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)

ユーザーの接続設定が有効です。

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

ユーザーの接続設定は、サーバーによってオーバーライドされます。

ConnectPrinterAtLogon

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

ログオンプロセス中に、クライアントのすべてのマップされたローカルプリンターを自動的に接続するかどうかを指定します。

FALSE (0)

ローカルプリンターは自動的に接続されません。

TRUE (1)

ローカルプリンターが自動的に接続されます。

DefaultToClientPrinter

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

印刷ジョブをクライアントのローカルプリンターに自動的に送信するかどうかを指定します。

FALSE (0)

印刷ジョブは、クライアントのローカルプリンターに自動的に送信されません。

TRUE (1)

印刷ジョブは、クライアントのローカルプリンターに自動的に送信されます。

説明

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

オブジェクトの説明。

このプロパティは、 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より前には使用できません。

lossless (1)

high (2)

medium (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
アクセスの種類: 読み取り専用
修飾子: Mappingstrings ("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 より前は使用できません。

名前

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

オブジェクトの名前。

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

PNPRedirection

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

プラグアンドプレイリダイレクトを許可するかどうかを指定します。

FALSE (0)

プラグアンドプレイリダイレクトを許可します。

TRUE (1)

プラグアンドプレイリダイレクトを許可しないでください。

PolicyAdvancedRemoteAppGraphics

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

AdvancedRemoteAppGraphics プロパティがサーバーまたはグループポリシーによって構成されているかどうかを示します。

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)

Default

PolicySourceAvc444ModePreferred

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

AVC444ModePreferredis プロパティの構成方法を示します。

サーバー

グループポリシー

PolicySourceClipboardMapping

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

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

0 (0x0)

サーバー

1 (0x1)

グループポリシー

2 (0x2)

Default

PolicySourceColorDepth

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

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

0 (0x0)

サーバー

1 (0x1)

グループポリシー

2 (0x2)

Default

PolicySourceColorDepthPolicy

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

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

0 (0x0)

サーバー

1 (0x1)

グループポリシー

2 (0x2)

Default

PolicySourceCOMPortMapping

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

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

0 (0x0)

サーバー

1 (0x1)

グループポリシー

2 (0x2)

Default

PolicySourceDefaultToClientPrinter

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

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

0 (0x0)

サーバー

1 (0x1)

グループポリシー

2 (0x2)

Default

PolicySourceDriveMapping

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

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

0 (0x0)

サーバー

1 (0x1)

グループポリシー

2 (0x2)

Default

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)

Default

PolicySourceMaxMonitors

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

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

0 (0x0)

サーバー

1 (0x1)

グループポリシー

2 (0x2)

Default

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)

Default

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)

Default

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 を使用します。

状態

データ型: 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から継承されます。

VideoPlaybackRedir

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

ビデオ再生リダイレクトを許可するかどうかを指定します。

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

FALSE (0)

TRUE (1)

WindowsPrinterMapping

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

クライアントのウィンドウに対してプリンターマッピングを無効にするか、有効にするかを指定します。

FALSE (0)

プリンターマッピングが有効になっています。

TRUE (1)

プリンターマッピングが無効になっています。

解説

コンソールセッションに関連付けられているウィンドウステーションは、このクラスのメソッドとプロパティにアクセスできないことに注意してください。 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_TSClientSetting クラス

構文

メンバー

メソッド

プロパティ

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース