AuthenticablePrincipal.FindByLogonTime 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| FindByLogonTime(PrincipalContext, DateTime, MatchType) |
傳回在指定日期和時間範圍內有帳戶登入記錄的驗證主體物件集合。 |
| FindByLogonTime<T>(PrincipalContext, DateTime, MatchType) |
傳回物件的 PrincipalSearchResult<T> 集合，其中含有指定的日期和時間範圍內的登入時間。 這是要實作這項功能的延伸類別範本函式。 |
FindByLogonTime(PrincipalContext, DateTime, MatchType)
傳回在指定日期和時間範圍內有帳戶登入記錄的驗證主體物件集合。
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。
傳回
包含一個或多個 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)
傳回物件的 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。
傳回
PrincipalSearchResult<T>，其中包含一或多個適當主體類型的物件，或如果找不到符合結果，則為空集合。
備註
時間預設為UTC。 如果您要以當地時間指定時間，請將 物件的 屬性time指定Kind為 DateTimeKind.Local。
