AuthenticablePrincipal.FindByLogonTime Método

Definición

Espacio de nombres:

System.DirectoryServices.AccountManagement

Ensamblado:

System.DirectoryServices.AccountManagement.dll

Paquete:

System.DirectoryServices.AccountManagement v8.0.0

Sobrecargas

FindByLogonTime(PrincipalContext, DateTime, MatchType)	Devuelve una colección de objetos principales de autenticación con un inicio de sesión de cuenta registrado en el intervalo de fecha y hora especificado.
FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)	Devuelve una colección de objetos PrincipalSearchResult<T> con un tiempo de inicio de sesión dentro del intervalo de fecha y hora especificado. Se trata de la función de plantilla para las clases extendidas que quieren implementar esta funcionalidad.

FindByLogonTime(PrincipalContext, DateTime, MatchType)

Source:

AuthenticablePrincipal.cs

Devuelve una colección de objetos principales de autenticación con un inicio de sesión de cuenta registrado en el intervalo de fecha y hora especificado.

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)

Parámetros

context

PrincipalContext

PrincipalContext que especifica el servidor o dominio en el que se realizan las operaciones.

time

DateTime

Objeto DateTime que identifica la fecha y hora del registro de inicio de sesión. Este parámetro se usa con el parámetro de tipo para determinar el intervalo de tiempo en el que los objetos devueltos tienen un inicio de sesión de cuenta registrado.

type

MatchType

Un valor de enumeración MatchType que especifica el tipo de coincidencia que se aplica al parámetro time.

Devoluciones

PrincipalSearchResult<AuthenticablePrincipal>

PrincipalSearchResult<T> que contiene uno o más objetos AuthenticablePrincipal.

Ejemplos

El código siguiente se conecta a la instancia de ADAM hospedada por el servidor "adamHost1.fabrikam.com" en el número de puerto "5000". El nombre de usuario (adamAdmin) y la contraseña (SecretPwd123) se especifican en el PrincipalContext constructor .

Se realiza una búsqueda para todas las entidades de seguridad autenticables en el contenedor "DC=adamApp1,DC=fabrikam,DC=com" que no han iniciado sesión en esta instancia de ADAM durante los últimos 45 días. A continuación, se eliminan las entidades de seguridad devueltas por la búsqueda.

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();  

Comentarios

La hora tendrá como valor predeterminado UTC. Si desea especificar la hora en la hora local, especifique la Kind propiedad del time objeto como DateTimeKind.Local.

FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)

Source:

AuthenticablePrincipal.cs

Devuelve una colección de objetos PrincipalSearchResult<T> con un tiempo de inicio de sesión dentro del intervalo de fecha y hora especificado. Se trata de la función de plantilla para las clases extendidas que quieren implementar esta funcionalidad.

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)

Parámetros de tipo

T

Parámetros

context

PrincipalContext

PrincipalContext que especifica el servidor o dominio en el que se realizan las operaciones.

time

DateTime

Objeto DateTime que identifica la fecha y hora de la contraseña establecida. Este parámetro se usa con el parámetro de tipo para determinar el intervalo de tiempo en el que los objetos devueltos tienen un establecimiento de contraseña registrado.

type

MatchType

Un valor de enumeración MatchType que especifica el tipo de coincidencia que se aplica al parámetro time.

Devoluciones

PrincipalSearchResult<T>

PrincipalSearchResult<T> que contiene uno o más objetos del tipo de entidad de seguridad adecuado o una colección vacía si no se encuentran coincidencias.

Comentarios

La hora tendrá como valor predeterminado UTC. Si desea especificar la hora en la hora local, especifique la Kind propiedad del time objeto como DateTimeKind.Local.