Compartilhar via


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