Freigeben über


AuthenticablePrincipal.FindByLogonTime Methode

Definition

Überlädt

FindByLogonTime(PrincipalContext, DateTime, MatchType)

Gibt eine Sammlung von Authentifizierungsprinzipalobjekten zurück, für die im angegebenen Datums- und Uhrzeitbereich eine Kontoanmeldung aufgezeichnet wurde.

FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)

Gibt eine PrincipalSearchResult<T>-Sammlung von Objekten zurück, die eine Anmeldezeit im angegebenen Datums- und Uhrzeitbereich aufweisen. Dies ist die Vorlagenfunktion für erweiterte Klassen, die diese Funktionalität implementieren möchten.

FindByLogonTime(PrincipalContext, DateTime, MatchType)

Quelle:
AuthenticablePrincipal.cs
Quelle:
AuthenticablePrincipal.cs
Quelle:
AuthenticablePrincipal.cs

Gibt eine Sammlung von Authentifizierungsprinzipalobjekten zurück, für die im angegebenen Datums- und Uhrzeitbereich eine Kontoanmeldung aufgezeichnet wurde.

public:
 static System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::AuthenticablePrincipal ^> ^ FindByLogonTime(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, DateTime time, System::DirectoryServices::AccountManagement::MatchType type);
public static System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.AuthenticablePrincipal> FindByLogonTime (System.DirectoryServices.AccountManagement.PrincipalContext context, DateTime time, System.DirectoryServices.AccountManagement.MatchType type);
static member FindByLogonTime : System.DirectoryServices.AccountManagement.PrincipalContext * DateTime * System.DirectoryServices.AccountManagement.MatchType -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.AuthenticablePrincipal>
Public Shared Function FindByLogonTime (context As PrincipalContext, time As DateTime, type As MatchType) As PrincipalSearchResult(Of AuthenticablePrincipal)

Parameter

context
PrincipalContext

Der PrincipalContext, der den Server oder die Domäne angibt, für den bzw. die Vorgänge ausgeführt werden.

time
DateTime

Ein DateTime-Objekt, das Datum und Uhrzeit der aufgezeichneten Anmeldung angibt. Dieser Parameter wird zusammen mit dem Typparameter verwendet, um die Zeitspanne zu bestimmen, in der für die zurückgegebenen Objekte eine Kontoanmeldung aufgezeichnet wurde.

type
MatchType

Ein MatchType-Enumerationswert, der den Typ der Übereinstimmung angibt, die auf den time-Parameter angewendet wird.

Gibt zurück

Ein PrincipalSearchResult<T>, das mindestens ein AuthenticablePrincipal-Objekt enthält.

Beispiele

Mit dem folgenden Code wird eine Verbindung mit dem ADAM-instance hergestellt, der vom Server "adamHost1.fabrikam.com" unter der Portnummer "5000" gehostet wird. Der Benutzername (adamAdmin) und das Kennwort (SecretPwd123) werden im PrincipalContext Konstruktor angegeben.

Unter dem Container "DC=adamApp1,DC=fabrikam,DC=fabrikam,DC=com", die sich in den letzten 45 Tagen nicht bei diesem ADAM-instance angemeldet haben, wird eine Suche durchgeführt. Die von der Suche zurückgegebenen Prinzipale werden dann gelöscht.

PrincipalContext ctx = new PrincipalContext(  
                                      ContextType.ApplicationDirectory,   
                                      "adamHost1.fabrikam.com:5000",   
                                      "DC=adamApp1,DC=fabrikam,DC=com",   
                                      "adamAdmin", "SecretPwd123");  

PrincipalSearchResult<AuthenticablePrincipal> oldPrincipals =   
                     AuthenticablePrincipal.FindByLogonTime(ctx,   
                            (DateTime.Now - new TimeSpan(45, 0, 0, 0)),   
                            MatchType.LessThan);  

foreach (Principal p in oldPrincipals)  
{  
    p.Delete();  
}  

oldPrincipals.Dispose();  
ctx.Dispose();  

Hinweise

Die Uhrzeit wird standardmäßig auf UTC festgelegt. Wenn Sie die Uhrzeit in Ortszeit angeben möchten, geben Sie die Kind -Eigenschaft des time -Objekts als DateTimeKind.Localan.

Gilt für:

FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)

Quelle:
AuthenticablePrincipal.cs
Quelle:
AuthenticablePrincipal.cs
Quelle:
AuthenticablePrincipal.cs

Gibt eine PrincipalSearchResult<T>-Sammlung von Objekten zurück, die eine Anmeldezeit im angegebenen Datums- und Uhrzeitbereich aufweisen. Dies ist die Vorlagenfunktion für erweiterte Klassen, die diese Funktionalität implementieren möchten.

protected:
generic <typename T>
 static System::DirectoryServices::AccountManagement::PrincipalSearchResult<T> ^ FindByLogonTime(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, DateTime time, System::DirectoryServices::AccountManagement::MatchType type);
protected static System.DirectoryServices.AccountManagement.PrincipalSearchResult<T> FindByLogonTime<T> (System.DirectoryServices.AccountManagement.PrincipalContext context, DateTime time, System.DirectoryServices.AccountManagement.MatchType type);
static member FindByLogonTime : System.DirectoryServices.AccountManagement.PrincipalContext * DateTime * System.DirectoryServices.AccountManagement.MatchType -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<'T>
Protected Shared Function FindByLogonTime(Of T) (context As PrincipalContext, time As DateTime, type As MatchType) As PrincipalSearchResult(Of T)

Typparameter

T

Parameter

context
PrincipalContext

Der PrincipalContext, der den Server oder die Domäne angibt, für den bzw. die Vorgänge ausgeführt werden.

time
DateTime

Ein DateTime-Objekt, das Datum und Uhrzeit für das festgelegte Kennwort angibt. Dieser Parameter wird zusammen mit dem Typparameter verwendet, um die Zeitspanne zu bestimmen, für die für die zurückgegebenen Objekte die Festlegung eines Kennworts aufgezeichnet ist.

type
MatchType

Ein MatchType-Enumerationswert, der den Typ der Übereinstimmung angibt, die auf den time-Parameter angewendet wird.

Gibt zurück

Ein PrincipalSearchResult<T>, das ein oder mehrere Objekte des entsprechenden Prinzipaltyps enthält, oder eine leere Sammlung, wenn keine Übereinstimmungen gefunden werden.

Hinweise

Die Uhrzeit wird standardmäßig auf UTC festgelegt. Wenn Sie die Uhrzeit in Ortszeit angeben möchten, geben Sie die Kind -Eigenschaft des time -Objekts als DateTimeKind.Localan.

Gilt für: