Win32_TSNetworkAdapterSetting-Klasse
Die Win32_TSNetworkAdapterSetting WMI-Klasse definiert verschiedene Konfigurationseinstellungen für die Win32_Terminal-Klasse , einschließlich Eigenschaften im Zusammenhang mit dem Netzwerkadapter und der maximal zulässigen Anzahl von Verbindungen.
Die folgende Syntax wird vom MOF-Code vereinfacht und enthält alle definierten und geerbten Eigenschaften in alphabetischer Reihenfolge. Referenzinformationen zu Methoden finden Sie in der Tabelle der Methoden weiter unten in diesem Thema.
Syntax
[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;
};
Member
Die Win32_TSNetworkAdapterSetting-Klasse verfügt über die folgenden Membertypen:
Methoden
Die Win32_TSNetworkAdapterSetting-Klasse verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| SelectAllNetworkAdapters | Wählt alle Netzwerkadapter aus. |
| SelectNetworkAdapterIP | Wählt einen Netzwerkadapter basierend auf der IP-Adresse des Adapters aus. |
| SetNetworkAdapterLanaID | Gibt die Nummer des festzulegenden Netzwerkadapters (NetBIOS Local Area Network Adapter, LANA) an. |
Eigenschaften
Die Win32_TSNetworkAdapterSetting-Klasse verfügt über diese Eigenschaften.
-
Caption
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64)
Kurze Beschreibung (einzeilige Zeichenfolge) des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
-
-
Beschreibung
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Eine Beschreibung des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
-
-
DeviceIDList
-
-
Datentyp: Zeichenfolgenarray
-
Zugriffstyp: Schreibgeschützt
Zeichenfolgenarray der verfügbaren Geräte-IDs, die in der Reihenfolge der physischen Netzwerkadapter zurückgegeben werden, die im NetworkAdapterList-Eigenschaftsarray zurückgegeben werden. Der Geräte-ID-Wert ist die DeviceID-Eigenschaft in Win32_NetworkAdapter
-
-
InstallDate
-
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Mappingstrings ("MIF. DMTF| ComponentID|001.5")
Das Datum der Installation des Objekts. Ein Fehlender Wert bedeutet nicht, dass das Objekt nicht installiert ist.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
-
-
MaximumConnections
-
-
Datentyp: uint32
-
Zugriffstyp: Lese-/Schreibzugriff
Die maximal zulässige Anzahl von Verbindungen. Der Wert MAXINT gibt eine unbegrenzte Anzahl von Verbindungen an.
-
-
Name
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Name des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
-
-
NetworkAdapterID
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Die GUID, die die ID des festzulegenden Netzwerkadapters darstellt. Eine GUID , die aus allen Nullen besteht, kennzeichnet alle Netzwerkadapter.
-
-
NetworkAdapterLanaID
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
NetBIOS Local Area Network Adapter (LANA) nummer des Netzwerkadapters, der verwendet wird, um den dem Terminal zugewiesenen Netzwerkadapter zu identifizieren.
-
-
NetworkAdapterList
-
-
Datentyp: Zeichenfolgenarray
-
Zugriffstyp: Schreibgeschützt
Zeichenfolgenarray der verfügbaren physischen Netzwerkadapter und der entsprechenden Geräte-IDs. Die Geräte-IDs sind die DeviceID-Eigenschaft in Win32_NetworkAdapter.
-
-
NetworkAdapterName
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Beschreibung des festzulegenden Netzwerkadapters. Dieser Wert befindet sich in Win32_NetworkAdapterConfiguration.
-
-
PolicySourceMaximumConnections
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die MaximumConnections-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert ist.
-
-
0
-
Server
-
1
-
Gruppenrichtlinie
-
2
-
Standard
Status
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10)
Aktuelle status des Objekts. Es können verschiedene betriebs- und nicht-operative Status definiert werden. Zu den Betriebsstatus gehören: "OK", "Degraded" und "Pred Fail" (ein Element, z. B. ein SMART-fähiges Festplattenlaufwerk, funktioniert möglicherweise ordnungsgemäß, sagt aber einen Fehler in naher Zukunft voraus). Zu den nicht betriebsrelevanten Status zählen : "Error", "Starting", "Stop" und "Service". Letzteres, "Dienst", kann während Spiegel-Resilvering eines Datenträgers, beim Erneutladen einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten gelten. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
("OK")
("Fehler")
("Beeinträchtigt")
("Unbekannt")
("Pred Fail")
("Start")
("Beenden")
("Dienst")
TerminalName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Name des Terminals.
Diese Eigenschaft wird von Win32_TerminalSetting geerbt.
Bemerkungen
Beachten Sie, dass winstations, die der Konsolensitzung zugeordnet sind, nicht auf die Methoden und Eigenschaften dieser Klasse zugreifen können. Wenn versucht wird, dies zu tun, indem "Console" als Wert der TerminalName-Eigenschaft angegeben wird, geben die Methoden dieses Objekts WBEM_E_NOT_SUPPORTED zurück. Dieser Fehlercode wird auch zurückgegeben, wenn eine Fensterstation versucht, Methoden dieses Objekts aufzurufen, um die Sicherheitseigenschaften der Konten LocalSystem, LocalService oder NetworkService hinzuzufügen oder zu ändern.
Um eine Verbindung mit dem Namespace "Root\CIMV2\TerminalServices" herzustellen, muss die Authentifizierungsebene den Schutz des Pakets enthalten. Bei C/C++-Aufrufen ist dies eine Authentifizierungsebene von RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Für Visual Basic- und Skriptaufrufe ist dies eine Authentifizierungsebene von WbemAuthenticationLevelPktPrivacy oder "pktPrivacy" mit dem Wert 6. Das folgende Visual Basic Scripting Edition (VBScript)-Beispiel zeigt, wie Sie eine Verbindung mit einem Remotecomputer mit Paketschutz herstellen.
strComputer = "RemoteServer1"
Set objServices = GetObject( _
"winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")
MOF-Dateien (Managed Object Format) enthalten die Definitionen für WMI-Klassen (Windows Management Instrumentation). MOF-Dateien werden nicht als Teil des Microsoft Windows Software Development Kit (SDK) installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mithilfe des Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Verwaltetes Objektformat (MOF).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMv2\TerminalServices |
| MOF |
|
| DLL |
|