AuthenticablePrincipal.FindByLogonTime 方法

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v8.0.0

多載

FindByLogonTime(PrincipalContext, DateTime, MatchType)	傳回在指定日期和時間範圍內有帳戶登入記錄的驗證主體物件集合。
FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)	傳回物件的 PrincipalSearchResult<T> 集合，其中含有指定的日期和時間範圍內的登入時間。 這是要實作這項功能的延伸類別範本函式。

FindByLogonTime(PrincipalContext, DateTime, MatchType)

來源:

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

MatchType 列舉值，指定套用至 time 參數的符合型別。

傳回

PrincipalSearchResult<AuthenticablePrincipal>

包含一個或多個 AuthenticablePrincipal 物件的 PrincipalSearchResult<T>。

範例

下列程式代碼會連線到埠號碼 「5000」 上伺服器 「adamHost1.fabrikam.com」 所裝載的 ADAM 實例。在建構函式中 PrincipalContext 會指定 username (adamAdmin) 和 password (SecretPwd123) 。

搜尋會針對過去 45 天內未登入此 ADAM 實例的容器 “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。 如果您要以當地時間指定時間，請將 物件的 屬性time指定Kind為 DateTimeKind.Local。

FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)

來源:

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

MatchType 列舉值，指定套用至 time 參數的符合型別。

傳回

PrincipalSearchResult<T>

PrincipalSearchResult<T>，其中包含一或多個適當主體類型的物件，或如果找不到符合結果，則為空集合。

備註

時間預設為UTC。 如果您要以當地時間指定時間，請將 物件的 屬性time指定Kind為 DateTimeKind.Local。