Win32 _ TSAccount-Klasse

Die WMI-Klasse Win32 _ TSAccount ermöglicht das Löschen eines Kontos, das im Win32-Terminal _ vorhanden ist, und das Ändern vorhandener Berechtigungen.

Die folgende Syntax wird von 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 die folgenden 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 des Sets von Überwachungsberechtigungen des angegebenen Kontos.
ModifyPermissions Legt einen präziseren Berechtigungssatz für das angegebene Konto fest.

Eigenschaften

Die Win32 _ TSAccount-Klasse verfügt über diese Eigenschaften.

AccountName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Der aktuelle Name des Kontos. Der Domänenname ist enthalten.

AuditFail

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt die Remotedesktop-Sitzungshost Services-Berechtigungen an, die auf eine Fehlerbedingung überwacht werden. Der Wert dieser Eigenschaft ist eine Bitmaske, die auf einen oder mehrere 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 RD-Sitzungshost serverspezifischen Berechtigungen an, die auf eine Erfolgsbedingung überwacht werden. Der Wert dieser Eigenschaft ist eine Bitmaske, die auf einen oder mehrere 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: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64)

Kurze Beschreibung (einzeilenbasierte Zeichenfolge) des Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.

Beschreibung

Datentyp: string

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, an dem das Objekt installiert wurde. Ein fehlender Wert gibt nicht an, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der Name des Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.

BerechtigungenAllowed

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt die Remotedesktopdienste Berechtigungen 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 zum Verwenden virtueller Kanäle. Virtuelle Kanäle ermöglichen den Zugriff von einem Serverprogramm auf Clientgeräte.

WINSTATION _ SHADOW (16)

Berechtigung zum Überschatten oder Remotesteuerung der Sitzung eines anderen Benutzers.

WINSTATION _ LOGON (32)

Berechtigung zum Anmelden bei einer Sitzung auf dem Server.

WINSTATION _ LOGOFF (4)

Berechtigung zum Abmelden eines Benutzers aus 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.

PermissionsDenied

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt die RD-Sitzungshost serverspezifischen Berechtigungen 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)

Aktueller Status des Objekts. Es können verschiedene Betriebs- und Nichtoperationsstatus definiert werden. Betriebsstatus: "OK", "Heruntergestuft" und "Pred Fail" (ein Element, z. B. ein SMART-fähiges Festplattenlaufwerk, funktioniert möglicherweise ordnungsgemäß, sagt aber einen Fehler in naher Zukunft vorher). Nichtoperationale Status: "Error", "Starting", "Stopping" und "Service". Letzteres, "Dienst", kann während des Spiegelungsresilverings eines Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Verwaltungsaufgaben angewendet werden. Nicht alle diese Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

("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 _ TerminalSettinggeerbt.

Hinweise

Um eine Verbindung mit dem \ \ CIMV2 \ TerminalServices-Stammnamespace herzustellen, muss die Authentifizierungsebene Paketdatenschutz 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 die Authentifizierungsebene WbemAuthenticationLevelPktPrivacy oder "pktPrivacy" mit dem Wert 6. Das folgende Beispiel Visual Basic Scripting Edition (VBScript) zeigt, wie Sie eine Verbindung mit einem Remotecomputer mit Paketschutz herstellen.

strComputer = "RemoteServer1" 
Set objServices = GetObject( _
    "winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")

Managed Object Format -Dateien (MOF) 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)
Windows Server 2008
Namespace
Root \ CIMv2 \ TerminalServices
MOF
TSCfgWmi.mof
DLL
TSCfgWmi.dll

Siehe auch

Win32 _ TerminalSetting