AuthenticablePrincipal.FindByLogonTime Método

Definição

Sobrecargas

FindByLogonTime(PrincipalContext, DateTime, MatchType)

Retorna uma coleção de objetos de entidade de segurança de autenticação que têm um logon na conta registrado no intervalo de data e hora especificado.

FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)

Retorna uma coleção PrincipalSearchResult<T> de objetos que têm um tempo de logon dentro do intervalo de tempo e de data especificado. Essa é a função de modelo para classes estendidas que desejam implementar essa funcionalidade.

FindByLogonTime(PrincipalContext, DateTime, MatchType)

Origem:
AuthenticablePrincipal.cs
Origem:
AuthenticablePrincipal.cs
Origem:
AuthenticablePrincipal.cs

Retorna uma coleção de objetos de entidade de segurança de autenticação que têm um logon na conta registrado no intervalo de data e 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

O PrincipalContext que especifica o servidor ou domínio no qual as operações são executadas.

time
DateTime

Um objeto DateTime que identifica a data e a hora do registro de logon. Esse parâmetro é usado com o parâmetro de tipo para determinar o intervalo de tempo no qual os objetos retornados têm um logon na conta registrado.

type
MatchType

Um valor de enumeração MatchType que especifica o tipo de correspondência aplicado ao parâmetro time.

Retornos

Um PrincipalSearchResult<T> que contém um ou mais objetos AuthenticablePrincipal.

Exemplos

O código a seguir se conecta à instância ADAM hospedada pelo servidor "adamHost1.fabrikam.com" no número da porta "5000". O nome de usuário (adamAdmin) e a senha (SecretPwd123) são especificados no PrincipalContext construtor.

Uma pesquisa é realizada para todas as entidades de segurança autenticadas no contêiner "DC=adamApp1,DC=fabrikam,DC=com" que não fizeram logon nesta instância adam nos últimos 45 dias. As entidades de segurança retornadas pela pesquisa são então excluídas.

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

Comentários

O tempo padrão será UTC. Se você quiser especificar a hora no horário local, especifique a Kind propriedade do time objeto como DateTimeKind.Local.

Aplica-se a

FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)

Origem:
AuthenticablePrincipal.cs
Origem:
AuthenticablePrincipal.cs
Origem:
AuthenticablePrincipal.cs

Retorna uma coleção PrincipalSearchResult<T> de objetos que têm um tempo de logon dentro do intervalo de tempo e de data especificado. Essa é a função de modelo para classes estendidas que desejam implementar essa funcionalidade.

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

O PrincipalContext que especifica o servidor ou domínio no qual as operações são executadas.

time
DateTime

Um objeto DateTime que identifica a data e a hora do conjunto de senhas. Esse parâmetro é usado com o parâmetro de tipo para determinar o intervalo de tempo no qual os objetos retornados têm um conjunto de senhas registrado.

type
MatchType

Um valor de enumeração MatchType que especifica o tipo de correspondência aplicado ao parâmetro time.

Retornos

Um PrincipalSearchResult<T> que contém um ou mais objetos do tipo de entidade de segurança apropriado ou uma coleção vazia, se nenhuma correspondência for encontrada.

Comentários

O tempo padrão será UTC. Se você quiser especificar a hora no horário local, especifique a Kind propriedade do time objeto como DateTimeKind.Local.

Aplica-se a