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 |
|
DLL |
|