UserPrincipal.FindByIdentity 메서드

정의

네임스페이스:

System.DirectoryServices.AccountManagement

어셈블리:

System.DirectoryServices.AccountManagement.dll

패키지:

System.DirectoryServices.AccountManagement v8.0.0

지정된 ID 값과 일치하는 사용자 보안 주체 개체를 반환합니다.

오버로드

FindByIdentity(PrincipalContext, IdentityType, String)	지정된 ID 형식 및 값과 일치하는 사용자 보안 주체 개체를 반환합니다. 이 버전의 FindByIdentity 메서드는 ID 값의 형식을 결정합니다.
FindByIdentity(PrincipalContext, String)	지정된 ID 값과 일치하는 사용자 보안 주체 개체를 반환합니다.

FindByIdentity(PrincipalContext, IdentityType, String)

Source:

User.cs

지정된 ID 형식 및 값과 일치하는 사용자 보안 주체 개체를 반환합니다. 이 버전의 FindByIdentity 메서드는 ID 값의 형식을 결정합니다.

public:
 static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> System.DirectoryServices.AccountManagement.UserPrincipal

Public Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As UserPrincipal

매개 변수

context

PrincipalContext

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

identityType

IdentityType

identityValue 매개 변수의 형식을 지정하는 IdentityType 열거형 값입니다.

identityValue

String

사용자 보안 주체의 ID입니다. 이 매개 변수는 IdentityType 열거형에 포함된 임의 형식일 수 있습니다.

반환

UserPrincipal

지정된 ID 값 및 형식과 일치하는 UserPrincipal 개체이거나, 일치하는 항목이 없으면 null입니다.

예외

MultipleMatchesException

현재 사용자 개체와 일치하는 여러 사용자 보안 주체 개체를 찾은 경우

InvalidEnumArgumentException

ID 값이 유효한 IdentityType 열거형 값이 아닙니다.

예제

다음 코드는 로컬 컴퓨터 저장소에 연결합니다. 자격 증명은 생성자에 지정되지 PrincipalContext 않으므로 현재 스레드를 실행하는 사용자의 자격 증명이 사용됩니다.

SamAccountName "Guest"가 있는 사용자를 찾기 위해 검색이 수행됩니다.

사용자가 발견되면 검사 수행되어 이 사용자의 계정이 사용하도록 설정되어 있는지 여부를 확인합니다. 계정이 사용하도록 설정되지 않은 경우 예제 코드에서 사용할 수 있습니다.

PrincipalContext ctx = new PrincipalContext(ContextType.Machine);  

UserPrincipal usr = UserPrincipal.FindByIdentity(ctx,   
                                           IdentityType.SamAccountName,   
                                           "Guest");  

if(usr != null)  
{  
    if (usr.Enabled == false)  
        usr.Enabled = true;  

    usr.Save();  
    usr.Dispose();  
}  
ctx.Dispose();   

FindByIdentity(PrincipalContext, String)

Source:

User.cs

지정된 ID 값과 일치하는 사용자 보안 주체 개체를 반환합니다.

public:
 static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * string -> System.DirectoryServices.AccountManagement.UserPrincipal

Public Shared Function FindByIdentity (context As PrincipalContext, identityValue As String) As UserPrincipal

매개 변수

context

PrincipalContext

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

identityValue

String

사용자 보안 주체의 ID입니다. 이 매개 변수는 IdentityType 열거형에 포함된 임의 형식일 수 있습니다.

반환

UserPrincipal

지정된 ID 값과 일치하는 UserPrincipal 개체이거나, 일치하는 항목이 없으면 null입니다.

예외

MultipleMatchesException

현재 사용자 개체와 일치하는 여러 사용자 보안 주체 개체를 찾은 경우