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

time パラメーターに適用される一致の種類を指定する MatchType 列挙値。

戻り値

PrincipalSearchResult<AuthenticablePrincipal>

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)

ソース:

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>

適切なプリンシパルの種類の 1 つまたは複数の PrincipalSearchResult<T> を含むオブジェクト、または一致なしの場合は空のコレクション。

注釈

時刻は既定で UTC になります。 現地時刻で時刻を指定する場合は、 オブジェクトの プロパティを Kindtime として DateTimeKind.Local指定します。