共用方式為

Win32_TSEnvironmentSetting 類別

  • 發行項

Win32_TSEnvironmentSetting WMI 類別會定義Win32_Terminal類別的組態設定，包括初始程式原則。

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

語法

[dynamic, provider("Win32_WIN32_TSENVIRONMENTSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSEnvironmentSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ClientWallPaper;
  string   InitialProgramPath;
  uint32   InitialProgramPolicy;
  uint32   PolicySourceClientWallPaper;
  uint32   PolicySourceInitialProgramPath;
  uint32   PolicySourceStartIn;
  string   Startin;
};

成員

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

方法

Win32_TSEnvironmentSetting類別具有這些方法。

方法 Description
InitialProgram 設定這個類別中包含的啟動程式屬性。
SetClientWallPaper 設定 ClientWallPaper 屬性。

屬性

Win32_TSEnvironmentSetting類別具有這些屬性。

標題

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (64)

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

此屬性繼承自 CIM_ManagedSystemElement。

ClientWallPaper

資料類型： uint32

存取類型：唯讀

指定是否在用戶端上顯示背景圖樣影像。 不顯示背景圖樣影像可以藉由減少重新繪製螢幕所需的時間來節省系統資源。

False (0)

背景圖樣影像不會顯示在用戶端上。

True (1)

背景圖樣影像會顯示在用戶端上。

說明

資料類型： 字串

存取類型：唯讀

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

InitialProgramPath

資料類型： 字串

存取類型：唯讀

登入 RD 工作階段主機伺服器之後，使用者將會立即執行之程式的名稱和路徑。

InitialProgramPolicy

資料類型： uint32

存取類型：讀取/寫入

伺服器用來判斷啟動程式路徑和檔案名的原則，以及它所在的資料夾名稱。

每個使用者 (0)

使用者的啟動程式設定生效。

Server-Override (1)

伺服器的啟動程式設定會覆寫。

單一應用程式模式 (2)

此會話中只會執行單一應用程式。 系統會忽略啟動程式資訊。

InstallDate

資料類型： datetime

存取類型：唯讀

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

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

此屬性繼承自 CIM_ManagedSystemElement。

名稱

資料類型： 字串

存取類型：唯讀

物件的名稱。

此屬性繼承自 CIM_ManagedSystemElement。

PolicySourceClientWallPaper

資料類型： uint32

存取類型：唯讀

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

0

伺服器

1

群組原則

2

預設

PolicySourceInitialProgramPath

資料類型： uint32

存取類型：唯讀

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

0

伺服器

1

群組原則

2

預設

PolicySourceStartIn

資料類型： uint32

存取類型：唯讀

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

0

伺服器

1

群組原則

2

預設

Startin

資料類型： 字串

存取類型：唯讀

使用者登入 RD 工作階段主機伺服器之後，使用者將會立即執行之程式的工作目錄路徑。

狀態

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (10)

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

此屬性繼承自 CIM_ManagedSystemElement。

(「OK」)

(「錯誤」)

(「降級」)

(「Unknown」)

(「預先失敗」)

(「Starting」)

(「停止」)

(「Service」)

TerminalName

資料類型： 字串

存取類型：唯讀

終端機的名稱。

此屬性繼承自 Win32_TerminalSetting。

備註

請注意，與主控台會話相關聯的 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