共用方式為

Win32_TSLogonSetting 類別

  • 發行項

Win32_TSLogonSetting WMI 類別會定義與用戶端登入相關的Win32_Terminal類別組態設定。

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

語法

[dynamic, provider("Win32_WIN32_TSLOGONSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSLogonSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ClientLogonInfoPolicy;
  string   Domain;
  string   Password;
  uint32   PolicySourceDomain;
  uint32   PolicySourcePromptForPassword;
  uint32   PolicySourceUserName;
  uint32   PromptForPassword;
  string   UserName;
};

成員

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

方法

Win32_TSLogonSetting類別具有這些方法。

方法 Description
ExplicitLogon 設定 UserName、Password 和網域驗證認證。
SetPromptForPassword 設定 PromptForPassword 屬性。

屬性

Win32_TSLogonSetting類別具有這些屬性。

標題

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (64)

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

此屬性繼承自 CIM_ManagedSystemElement。

ClientLogonInfoPolicy

資料類型： uint32

存取類型：讀取/寫入

伺服器用來判斷連線設定的原則。

每個使用者 (0)

個別使用者連線設定生效。

Server-Override (1)

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

說明

資料類型： 字串

存取類型：唯讀

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

網域

資料類型： 字串

存取類型：唯讀

使用者的網域登入驗證認證。 這是使用者電腦所在的網域。 此屬性不能超過 17 個字元。

InstallDate

資料類型： datetime

存取類型：唯讀

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

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

此屬性繼承自 CIM_ManagedSystemElement。

名稱

資料類型： 字串

存取類型：唯讀

物件的名稱。

此屬性繼承自 CIM_ManagedSystemElement。

密碼

資料類型： 字串

存取類型：唯讀

使用者的密碼登入驗證認證。 這個屬性不能超過 14 個字元。 如果您查詢此屬性，建議您將安全性層級設定為封包隱私權 (wbemAuthenticationLevelPktPrivacy = 6) 。 這是因為密碼不會在連線上加密，而不會有此安全性層級。 如需設定安全性層級的詳細資訊，請參閱 WMI SDK 檔中的 設定用戶端應用程式進程安全性 。

PolicySourceDomain

資料類型： uint32

存取類型：唯讀

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

0

伺服器

1

群組原則

2

預設

PolicySourcePromptForPassword

資料類型： uint32

存取類型：唯讀

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

0

伺服器

1

群組原則

2

預設

PolicySourceUserName

資料類型： uint32

存取類型：唯讀

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

0

伺服器

1

群組原則

2

預設

PromptForPassword

資料類型： uint32

存取類型：唯讀

指定登入伺服器時，是否一律提示使用者輸入密碼。

FALSE (0)

系統不會提示使用者輸入密碼。

TRUE (1)

使用者會被提示輸入密碼。

狀態

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (10)

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

此屬性繼承自 CIM_ManagedSystemElement。

(「OK」)

(「錯誤」)

(「降級」)

(「Unknown」)

(「預先失敗」)

(「Starting」)

(「停止」)

(「Service」)

TerminalName

資料類型： 字串

存取類型：唯讀

終端機的名稱。

此屬性繼承自 Win32_TerminalSetting。

使用者名稱

資料類型： 字串

存取類型：唯讀

使用者的使用者名稱登入驗證認證。 這個屬性不能超過 20 個字元。

備註

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

Win32_TerminalSetting