Win32_TSAccount-Klasse
Die Win32_TSAccount WMI-Klasse ermöglicht das Löschen eines Kontos, das auf der Win32_Terminal vorhanden ist, und das Ändern vorhandener Berechtigungen.
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, overwrite, provider("Win32_WIN32_TSACCOUNT_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSAccount : Win32_TerminalSetting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string TerminalName;
string AccountName;
uint32 AuditFail;
uint32 AuditSuccess;
uint32 PermissionsAllowed;
uint32 PermissionsDenied;
string SID;
};
Member
Die Win32_TSAccount-Klasse verfügt über folgende Membertypen:
Methoden
Die Win32_TSAccount-Klasse verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| Löschen | Löscht das angegebene Benutzer-, Gruppen- oder Computerkonto. |
| ModifyAuditPermissions | Ändert die Granularität der Überwachungsberechtigungen des angegebenen Kontos. |
| ModifyPermissions | Legt einen präziseren Berechtigungssatz auf das angegebene Konto fest. |
Eigenschaften
Die Win32_TSAccount-Klasse verfügt über diese Eigenschaften.
-
AccountName
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schlüssel
Der aktuelle Name des Kontos. Der Domänenname ist enthalten.
-
-
AuditFail
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt die Berechtigungen für Remotedesktopsitzungshostdienste an, die auf eine Fehlerbedingung überwacht werden. Der Wert dieser Eigenschaft ist eine Bitmaske, die auf mindestens einen der Werte der PermissionsAllowed-Eigenschaft festgelegt werden kann.
-
-
WINSTATION_QUERY=0x1 (0)
-
WINSTATION_SET=0x2 (1)
-
WINSTATION_LOGOFF=0x4 (2)
-
WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED = 0xF008 (3)
-
WINSTATION_SHADOW=0x10 (4)
-
WINSTATION_LOGON=0x20 (5)
-
WINSTATION_MSG=0x80 (6)
-
WINSTATION_CONNECT=0x100 (7)
-
WINSTATION_DISCONNECT=0x200 (8)
AuditSuccess
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt die serverspezifischen Berechtigungen des RD-Sitzungshosts an, die auf eine Erfolgreiche Bedingung überwacht werden. Der Wert dieser Eigenschaft ist eine Bitmaske, die auf mindestens einen der Werte der PermissionsAllowed-Eigenschaft festgelegt werden kann.
WINSTATION_QUERY=0x1 (0)
WINSTATION_SET=0x2 (1)
WINSTATION_LOGOFF=0x4WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED = 0xF008 (2)
WINSTATION_SHADOW=0x10 (3)
WINSTATION_LOGON=0x20 (4)
WINSTATION_MSG=0x80 (5)
WINSTATION_CONNECT=0x100 (6)
WINSTATION_DISCONNECT=0x200 (7)
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.
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.
Name
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Name des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
BerechtigungenAllowed
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt die Berechtigungen für Remotedesktopdienste an, die für das Konto zulässig sind. Der Wert dieser Eigenschaft ist eine Bitmaske, die auf einen oder mehrere der folgenden Werte festgelegt werden kann.
WINSTATION_QUERY=0x1 (1)
Berechtigung zum Abfragen von Informationen zu einer Sitzung.
WINSTATION_SET (2)
Berechtigung zum Ändern von Verbindungsparametern.
WINSTATION_RESET (64)
Berechtigung zum Zurücksetzen oder Beenden einer Sitzung oder Verbindung.
WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED (983048)
Berechtigung zur Verwendung virtueller Kanäle. Virtuelle Kanäle ermöglichen den Zugriff von einem Serverprogramm auf Clientgeräte.
WINSTATION_SHADOW (16)
Berechtigung, die Sitzung eines anderen Benutzers zu überschatten oder remote zu steuern.
WINSTATION_LOGON (32)
Berechtigung zum Anmelden bei einer Sitzung auf dem Server.
WINSTATION_LOGOFF (4)
Berechtigung zum Abmelden eines Benutzers von einer Sitzung.
WINSTATION_MSG (128)
Berechtigung zum Senden einer Nachricht an die Sitzung eines anderen Benutzers.
WINSTATION_CONNECT (256)
Berechtigung zum Herstellen einer Verbindung mit einer anderen Sitzung.
WINSTATION_DISCONNECT (512)
Berechtigung zum Trennen einer Sitzung.
BerechtigungenEinzugen
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt die serverspezifischen Berechtigungen des RD-Sitzungshosts an, die für das Konto nicht zulässig sind. Der Wert dieser Eigenschaft ist eine Bitmaske, die auf einen oder mehrere der Werte der PermissionsAllowed-Eigenschaft festgelegt werden kann.
WINSTATION_QUERY=0x1 (0)
WINSTATION_SET=0x2 (1)
WINSTATION_LOGOFF=0x4 (2)
WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED = 0xF008 (3)
WINSTATION_SHADOW=0x10 (4)
WINSTATION_LOGON=0x20 (5)
WINSTATION_MSG=0x80 (6)
WINSTATION_CONNECT=0x100 (7)
WINSTATION_DISCONNECT=0x200 (8)
SID
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Gibt die Sicherheits-IDs des Kontos an.
Status
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10)
Aktuelle status des Objekts. Es können verschiedene betriebsbezogene und nicht operative Status definiert werden. Zu den Betriebsstatus gehören: "OK", "Heruntergestuft" und "Pred Fail" (ein Element, z. B. eine SMART-fähige Festplatte, funktioniert möglicherweise ordnungsgemäß, sagt aber in naher Zukunft einen Fehler voraus). Zu den nicht betriebsbereiten Status gehören: "Fehler", "Wird gestartet", "Wird beendet" und "Dienst". Letzteres, "Dienst", kann beim Spiegel-Resilvering eines Datenträgers, beim Erneutladen einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben 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")
("Heruntergestuft")
("Unbekannt")
("Pred Fail")
("Wird gestartet")
("Wird beendet")
("Dienst")
TerminalName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Der Name des Terminals.
Diese Eigenschaft wird von Win32_TerminalSetting geerbt.
Bemerkungen
Um eine Verbindung mit dem Namespace \root\CIMV2\TerminalServices herzustellen, muss die Authentifizierungsebene den Paketschutz enthalten. Bei C/C++-Aufrufen wäre dies eine Authentifizierungsebene von RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Bei Visual Basic- und Skriptaufrufen wäre 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 der Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMv2\TerminalServices |
| MOF |
|
| DLL |
|