AuthenticablePrincipal.FindByLogonTime Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- AuthenticablePrincipal.cs
- 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<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.
Se aplica a
FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)
- Source:
- AuthenticablePrincipal.cs
- Source:
- AuthenticablePrincipal.cs
- 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> 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.
