Freigeben über

Win32_TSLogonSetting-Klasse

  • Artikel

Die Win32_TSLogonSetting WMI-Klasse definiert Konfigurationseinstellungen für die Win32_Terminal Klasse, die sich auf die Clientanmeldung bezieht.

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_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;
};

Member

Die Win32_TSLogonSetting-Klasse verfügt über folgende Membertypen:

Methoden

Die Win32_TSLogonSetting-Klasse verfügt über diese Methoden.

Methode BESCHREIBUNG
ExplicitLogon Legt die Anmeldeinformationen für die Benutzer-, Kennwort- und Domänenauthentifizierung fest.
SetPromptForPassword Legt die PromptForPassword-Eigenschaft fest.

Eigenschaften

Die Win32_TSLogonSetting-Klasse verfügt über diese Eigenschaften.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64)

Kurze Beschreibung (einzeilige Zeichenfolge) des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

ClientLogonInfoPolicy

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Die Richtlinie, die der Server zum Bestimmen der Verbindungseinstellungen verwendet.

Pro Benutzer (0)

Einzelne Benutzerverbindungseinstellungen sind in Kraft.

Serverüberschreibung (1)

Die Verbindungseinstellungen einzelner Benutzer werden vom Server überschrieben.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Domäne

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die Anmeldeinformationen für die Domänenanmeldeinformation des Benutzers. Dies ist die Domäne, in der sich der Computer des Benutzers befindet. Diese Eigenschaft darf nicht länger als 17 Zeichen sein.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: Zuordnungszeichenfolgen ("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.

Kennwort

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die Anmeldeinformationen für die Kennwortanmeldeinformationen des Benutzers. Diese Eigenschaft darf nicht länger als 14 Zeichen sein. Wenn Sie diese Eigenschaft abfragen, empfiehlt es sich, die Sicherheitsstufe auf Paketdatenschutz (wbemAuthenticationLevelPktPrivacy = 6) festzulegen. Dies liegt daran, dass das Kennwort nicht über das Netzwerk ohne diese Sicherheitsstufe verschlüsselt wird. Weitere Informationen zum Festlegen von Sicherheitsstufen finden Sie unter Festlegen der Prozesssicherheit für Clientanwendungen in der WMI SDK-Dokumentation.

PolicySourceDomain

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, ob die Domain-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert wird.

0

Server

1

Gruppenrichtlinie

2

Standard

PolicySourcePromptForPassword

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, ob die PromptForPassword-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert wird.

0

Server

1

Gruppenrichtlinie

2

Standard

PolicySourceUserName

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, ob die UserName-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert wird.

0

Server

1

Gruppenrichtlinie

2

Standard

PromptForPassword

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, ob der Benutzer während der Anmeldung beim Server immer zur Eingabe eines Kennworts aufgefordert wird.

FALSE (0)

Der Benutzer wird nicht zur Eingabe eines Kennworts aufgefordert.

TRUE (1)

Der Benutzer wird zur Eingabe eines Kennworts aufgefordert.

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.

UserName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Die Anmeldeinformationen des Benutzers für die Anmeldeauthentifizierung. Diese Eigenschaft darf nicht länger als 20 Zeichen sein.

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 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
TSCfgWmi.mof
DLL
TSCfgWmi.dll

Siehe auch

Win32_Terminal

Win32_TerminalSetting