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。
- time
- DateTime
ログオン記録の日時を識別する DateTime オブジェクト。 このパラメーターは型パラメーターと共に使用して、返されるオブジェクトに記録されるアカウントのログオンの時間範囲を特定します。
戻り値
1 つ以上の AuthenticablePrincipal オブジェクトを含む PrincipalSearchResult<T>。
例
次のコードは、ポート番号 "5000" でサーバー "adamHost1.fabrikam.com" によってホストされている ADAM インスタンスに接続します。ユーザー名 (adamAdmin)、およびパスワード (SecretPwd123) がコンストラクターで PrincipalContext 指定されています。
過去 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 になります。 現地時刻で時刻を指定する場合は、 オブジェクトの プロパティを Kindtime として 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。
- time
- DateTime
パスワード設定の日時を識別する DateTime オブジェクト。 このパラメーターは型パラメーターと共に使用して、返されるオブジェクトに記録されるパスワード設定の時間範囲を特定します。
戻り値
適切なプリンシパルの種類の 1 つまたは複数の PrincipalSearchResult<T> を含むオブジェクト、または一致なしの場合は空のコレクション。
注釈
時刻は既定で UTC になります。 現地時刻で時刻を指定する場合は、 オブジェクトの プロパティを Kindtime として DateTimeKind.Local指定します。
適用対象
.NET