Share via


AuthenticablePrincipal.FindByLogonTime 메서드

정의

오버로드

FindByLogonTime(PrincipalContext, DateTime, MatchType)

계정 로그온 시간이 지정된 날짜 및 시간 범위 내에 속하는 인증 사용자 개체의 컬렉션을 반환합니다.

FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)

로그온 시간이 지정된 날짜 및 시간 범위 내에 속하는 개체의 PrincipalSearchResult<T> 컬렉션을 반환합니다. 이 기능을 구현하려는 확장 클래스에 대한 템플릿 함수입니다.

FindByLogonTime(PrincipalContext, DateTime, MatchType)

Source:
AuthenticablePrincipal.cs
Source:
AuthenticablePrincipal.cs
Source:
AuthenticablePrincipal.cs

계정 로그온 시간이 지정된 날짜 및 시간 범위 내에 속하는 인증 사용자 개체의 컬렉션을 반환합니다.

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)

매개 변수

context
PrincipalContext

작업이 수행되는 서버 또는 도메인을 지정하는 PrincipalContext입니다.

time
DateTime

로그온 레코드의 날짜 및 시간을 식별하는 DateTime 개체입니다. 이 매개 변수는 반환된 개체의 계정 로그온이 기록되는 시간 범위를 확인하기 위해 형식 매개 변수와 함께 사용됩니다.

type
MatchType

time 매개 변수에 적용되는 일치 유형을 지정하는 MatchType 열거형 값입니다.

반환

AuthenticablePrincipal 개체를 하나 이상 포함하는 PrincipalSearchResult<T>입니다.

예제

다음 코드는 포트 번호 "5000"에서 서버 "adamHost1.fabrikam.com"에서 호스트되는 ADAM instance 연결합니다. 사용자 이름(adamAdmin) 및 암호(SecretPwd123)가 생성자에 지정됩니다PrincipalContext.

지난 45일 동안 이 ADAM instance 로그온하지 않은 컨테이너 "DC=adamApp1,DC=fabrikam,DC=com"에서 모든 인증 가능한 보안 주체에 대해 검색이 수행됩니다. 그런 다음 검색에서 반환된 보안 주체가 삭제됩니다.

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

설명

시간은 기본적으로 UTC입니다. 현지 시간으로 시간을 지정하려면 개체의 Kindtime 속성을 로 DateTimeKind.Local지정합니다.

적용 대상

FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)

Source:
AuthenticablePrincipal.cs
Source:
AuthenticablePrincipal.cs
Source:
AuthenticablePrincipal.cs

로그온 시간이 지정된 날짜 및 시간 범위 내에 속하는 개체의 PrincipalSearchResult<T> 컬렉션을 반환합니다. 이 기능을 구현하려는 확장 클래스에 대한 템플릿 함수입니다.

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)

형식 매개 변수

T

매개 변수

context
PrincipalContext

작업이 수행되는 서버 또는 도메인을 지정하는 PrincipalContext입니다.

time
DateTime

암호 설정의 날짜 및 시간을 식별하는 DateTime 개체입니다. 이 매개 변수는 반환된 개체의 암호 설정이 기록되는 시간 범위를 확인하기 위해 형식 매개 변수와 함께 사용됩니다.

type
MatchType

time 매개 변수에 적용되는 일치 유형을 지정하는 MatchType 열거형 값입니다.

반환

해당 보안 주체 형식의 개체를 하나 이상 포함하는 PrincipalSearchResult<T>이거나, 일치 항목이 없는 경우 빈 컬렉션입니다.

설명

시간은 기본적으로 UTC입니다. 현지 시간으로 시간을 지정하려면 개체의 Kindtime 속성을 로 DateTimeKind.Local지정합니다.

적용 대상