共用方式為

Win32_TSNetworkAdapterSetting 類別

  • 發行項

Win32_TSNetworkAdapterSetting WMI 類別會定義Win32_Terminal類別的各種組態設定，包括與網路介面卡相關的屬性，以及允許的連線數目上限。

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

語法

[dynamic, provider("Win32_WIN32_TSNETWORKADAPTERSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSNetworkAdapterSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  string   DeviceIDList[];
  uint32   MaximumConnections;
  string   NetworkAdapterID;
  uint32   NetworkAdapterLanaID;
  string   NetworkAdapterList[];
  string   NetworkAdapterName;
  uint32   PolicySourceMaximumConnections;
};

成員

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

方法

Win32_TSNetworkAdapterSetting類別具有這些方法。

方法 Description
SelectAllNetworkAdapters 選取所有網路介面卡。
SelectNetworkAdapterIP 根據介面卡的 IP 位址選取網路介面卡。
SetNetworkAdapterLanaID 指定要設定之網路介面卡的 NetBIOS 區域網路卡 (LANA) 數目。

屬性

Win32_TSNetworkAdapterSetting類別具有這些屬性。

標題

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (64)

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

此屬性繼承自 CIM_ManagedSystemElement。

說明

資料類型： 字串

存取類型：唯讀

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

DeviceIDList

資料類型： 字串 陣列

存取類型：唯讀

以 NetworkAdapterList 屬性陣列中傳回的實體網路介面卡順序傳回的可用裝置識別碼字串陣列。 裝置識別碼值是Win32_NetworkAdapter中的DeviceID屬性

InstallDate

資料類型： datetime

存取類型：唯讀

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

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

此屬性繼承自 CIM_ManagedSystemElement。

MaximumConnections

資料類型： uint32

存取類型：讀取/寫入

允許的連線數目上限。 MAXINT 值表示不限數目的連線。

名稱

資料類型： 字串

存取類型：唯讀

物件的名稱。

此屬性繼承自 CIM_ManagedSystemElement。

NetworkAdapterID

資料類型： 字串

存取類型：唯讀

GUID，表示要設定之網路介面卡的識別碼。 包含所有零的 GUID 表示所有網路介面卡。

NetworkAdapterLanaID

資料類型： uint32

存取類型：唯讀

NetBIOS 區域網路卡 (LANA) 用來識別指派給終端機之網路介面卡的網路介面卡數目。

NetworkAdapterList

資料類型： 字串 陣列

存取類型：唯讀

可用實體網路介面卡和對應裝置識別碼的字串陣列。 裝置識別碼是Win32_NetworkAdapter中的DeviceID屬性。

NetworkAdapterName

資料類型： 字串

存取類型：唯讀

要設定的網路介面卡描述。 此值在 Win32_NetworkAdapterConfiguration中。

PolicySourceMaximumConnections

資料類型： uint32

存取類型：唯讀

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

0

伺服器

1

群組原則

2

預設

狀態

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (10)

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

此屬性繼承自 CIM_ManagedSystemElement。

(「OK」)

(「Error」)

(「降級」)

(「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_NetworkAdapter

Win32_NetworkAdapterConfiguration

Win32_TerminalSetting

Win32_TSNetworkAdapterListSetting