PrincipalContext 생성자

정의

네임스페이스:

System.DirectoryServices.AccountManagement

어셈블리:

System.DirectoryServices.AccountManagement.dll

패키지:

System.DirectoryServices.AccountManagement v8.0.0

PrincipalContext 클래스의 새 인스턴스를 초기화합니다.

오버로드

PrincipalContext(ContextType)	지정된 컨텍스트 형식을 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.
PrincipalContext(ContextType, String)	지정된 컨텍스트 형식 및 이름을 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.
PrincipalContext(ContextType, String, String)	지정된 컨텍스트 형식, 이름 및 컨테이너를 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.
PrincipalContext(ContextType, String, String, ContextOptions)	지정된 컨텍스트 형식, 이름, 컨테이너 및 컨텍스트 옵션을 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.
PrincipalContext(ContextType, String, String, String)	지정한 컨텍스트 형식, 이름, 사용자 이름 및 암호를 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.
PrincipalContext(ContextType, String, String, String, String)	지정한 컨텍스트 형식, 이름, 컨테이너, 사용자 이름 및 암호를 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.
PrincipalContext(ContextType, String, String, ContextOptions, String, String)	지정한 컨텍스트 형식, 이름, 컨테이너, 컨텍스트 옵션, 사용자 이름 및 암호를 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.

설명

PrincipalContext 생성자는 매개 변수 및 서버의 유효성 검사를 수행하지만 자격 증명의 유효성을 검사하지는 않습니다.

컨테이너를 지정하지 않고 주 컨텍스트 개체를 만들 때 여러 고유 컨테이너를 나타내는 데 사용할 수 있습니다. 하나의 컨테이너를 쿼리 작업의 기반으로 사용할 수 있으며, 추가 컨테이너는 새로 만든 보안 주체 개체를 보유할 수 있습니다. 예를 들어 사용자 또는 그룹이 도메인 컨텍스트 형식에 삽입되면 계정 관리 API는 잘 알려진 기본 사용자 컨테이너인 "CN=Users,DC=Fabrikam,DC=com"을 사용합니다. 컴퓨터가 저장소에 삽입되면 API는 기본 "CN=Computers,DC=Fabrikam,DC=com" 컨테이너를 사용합니다. 기본 컨테이너 이름은 도메인 관리자가 변경할 수 있습니다. Principal 개체 생성자만 하나의 보안 주체 컨텍스트를 지정할 수, 있으므로 애플리케이션 컨테이너를 지정 하지 않고 도메인 컨텍스트를 만들 때 추가 컨텍스트는 기본적으로 노출 됩니다. 애플리케이션 컨테이너를 생성자에 지정 해야 애플리케이션 디렉터리에는 잘 알려진 컨테이너가 없으므로 또는 ArgumentException throw 됩니다. SAM 컨테이너 없기 때문에 ArgumentException 애플리케이션의 생성자에서 컨테이너를 지정 하는 경우 throw 됩니다.

사용자 이름을 매개 변수로 사용하는 생성자의 각 버전에서 문자열은 userName 다양한 형식일 수 있습니다. 에 지원되는 세 가지 NameFormats는 Nt4Name, UserPrincipalName 및 SamAccountName입니다. 이름 형식에 대한 자세한 내용은 ADS_NAME_TYPE_ENUM 설명서를 참조하세요.

PrincipalContext(ContextType)

Source:

Context.cs

지정된 컨텍스트 형식을 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType)

매개 변수

contextType

ContextType

보안 주체 컨텍스트에 대한 저장소 형식을 지정하는 ContextType 열거형 값입니다.

예외

ArgumentException

애플리케이션 디렉터리 컨텍스트를 사용할 때 이름이나 컨테이너를 지정해야 하는 경우

InvalidEnumArgumentException

contextType 매개 변수에 유효한 ContextType 열거형 값이 없는 경우

PrincipalContext(ContextType, String)

Source:

Context.cs

지정된 컨텍스트 형식 및 이름을 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String)

매개 변수

contextType

ContextType

보안 주체 컨텍스트에 대한 저장소 형식을 지정하는 ContextType 열거형 값입니다.

name

String

Domain 컨텍스트 형식에 대한 도메인이나 서버의 이름, Machine 컨텍스트 형식에 대한 시스템 이름 또는 ApplicationDirectory 인스턴스를 호스팅하는 서버 및 포트의 이름입니다.

Domain 컨텍스트 형식의 이름이 null인 경우 이 컨텍스트는 스레드를 실행하는 데 사용되는 사용자 계정의 도메인에 대한 도메인 컨트롤러입니다. Machine 컨텍스트 형식의 이름이 null인 경우 로컬 머신 이름입니다. 이 매개 변수는 ApplicationDirectory 컨텍스트 형식에 대해 null일 수 없습니다.

예외

ArgumentException

contextType 매개 변수에 ApplicationDirectory를 지정할 때 이름을 지정해야 하는 경우

InvalidEnumArgumentException

contextType 매개 변수에 유효한 ContextType 열거형 값이 없는 경우

PrincipalContext(ContextType, String, String)

Source:

Context.cs

지정된 컨텍스트 형식, 이름 및 컨테이너를 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String)

매개 변수

contextType

ContextType

보안 주체 컨텍스트에 대한 저장소 형식을 지정하는 ContextType 열거형 값입니다.

name

String

Domain 컨텍스트 형식에 대한 도메인이나 서버의 이름, Machine 컨텍스트 형식에 대한 시스템 이름 또는 ApplicationDirectory 인스턴스를 호스팅하는 서버 및 포트의 이름입니다.

Domain 컨텍스트 형식의 이름이 null인 경우 이 컨텍스트는 스레드를 실행하는 데 사용되는 사용자 계정의 도메인에 대한 도메인 컨트롤러입니다. Machine 컨텍스트 형식의 이름이 null인 경우 로컬 머신 이름입니다. 이 매개 변수는 ApplicationDirectory 컨텍스트 형식에 대해 null일 수 없습니다.

container

String

컨텍스트의 루트로 사용할 저장소의 컨테이너입니다. 모든 쿼리는 이 루트에서 수행되며 모든 삽입은 이 컨테이너를 대상으로 수행됩니다.

Domain 및 ApplicationDirectory 컨텍스트 형식의 경우 이 매개 변수는 컨테이너 개체의 고유 이름입니다.

Machine 컨텍스트 형식의 경우 이 매개 변수를 null로 설정해야 합니다.

예외

ArgumentException

contextType 매개 변수에 Machine 컨텍스트 형식을 지정할 때 컨테이너를 지정할 수 없는 경우

contextType 매개 변수에 ApplicationDirectory를 지정할 때 이름이나 컨테이너를 지정해야 하는 경우

InvalidEnumArgumentException

contextType 매개 변수에 유효한 ContextType 열거형 값이 없는 경우

설명

InvalidOperationException 보안 주체 컨텍스트에 지정된 Domain 컨테이너가 유효한 컨테이너가 아닌 경우 서버에 연결하는 후속 디렉터리 작업 호출에서 이 throw될 수 있습니다. 컨테이너는 스키마 클래스에 사용자, 그룹 또는 컴퓨터의 가능한Inferiors 특성에 주 클래스가 있는 개체로 정의됩니다.

PrincipalContext(ContextType, String, String, ContextOptions)

Source:

Context.cs

지정된 컨텍스트 형식, 이름, 컨테이너 및 컨텍스트 옵션을 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::DirectoryServices::AccountManagement::ContextOptions options);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, System.DirectoryServices.AccountManagement.ContextOptions options);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * System.DirectoryServices.AccountManagement.ContextOptions -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)

매개 변수

contextType

ContextType

보안 주체 컨텍스트에 대한 저장소 형식을 지정하는 ContextType 열거형 값입니다.

name

String

Domain 컨텍스트 형식에 대한 도메인이나 서버의 이름, Machine 컨텍스트 형식에 대한 시스템 이름 또는 ApplicationDirectory 인스턴스를 호스팅하는 서버 및 포트의 이름입니다.

Domain 컨텍스트 형식의 이름이 null인 경우 이 컨텍스트는 스레드를 실행하는 데 사용되는 사용자 계정의 도메인에 대한 도메인 컨트롤러입니다. Machine 컨텍스트 형식의 이름이 null인 경우 로컬 머신 이름입니다. 이 매개 변수는 ApplicationDirectory 컨텍스트 형식에 대해 null일 수 없습니다.

container

String

컨텍스트의 루트로 사용할 저장소의 컨테이너입니다. 모든 쿼리는 이 루트에서 수행되며 모든 삽입은 이 컨테이너를 대상으로 수행됩니다.

Domain 및 ApplicationDirectory 컨텍스트 형식의 경우 이 매개 변수는 컨테이너 개체의 고유 이름입니다.

Machine 컨텍스트 형식의 경우 이 매개 변수를 null로 설정해야 합니다.

options

ContextOptions

서버에 바인딩하는 데 사용되는 옵션을 지정하는 하나 이상의 ContextOptions 열거형 값의 조합입니다. 이 매개 변수가 null인 경우 기본 옵션은 ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing입니다.

예외

ArgumentException

contextType 매개 변수에 Machine 컨텍스트 형식을 지정할 때 컨테이너를 지정할 수 없는 경우

contextType 매개 변수에 ApplicationDirectory를 지정할 때 이름이나 컨테이너를 지정해야 하는 경우

InvalidEnumArgumentException

contextType 매개 변수에 유효한 ContextType 열거형 값이 없는 경우

options 매개 변수에 유효한 ContextOptions 열거형 값의 조합이 없는 경우

설명

InvalidOperationException 보안 주체 컨텍스트에 지정된 Domain 컨테이너가 유효한 컨테이너가 아닌 경우 서버에 연결하는 후속 디렉터리 작업 호출에서 이 throw될 수 있습니다. 컨테이너는 스키마 클래스에 사용자, 그룹 또는 컴퓨터의 가능한Inferiors 특성에 주 클래스가 있는 개체로 정의됩니다.

PrincipalContext(ContextType, String, String, String)

Source:

Context.cs

지정한 컨텍스트 형식, 이름, 사용자 이름 및 암호를 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ userName, System::String ^ password);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string userName, string password);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, userName As String, password As String)

매개 변수

contextType

ContextType

보안 주체 컨텍스트에 대한 저장소 형식을 지정하는 ContextType 열거형 값입니다.

name

String

Domain 컨텍스트 형식에 대한 도메인이나 서버의 이름, Machine 컨텍스트 형식에 대한 시스템 이름 또는 ApplicationDirectory 인스턴스를 호스팅하는 서버 및 포트의 이름입니다.

Domain 컨텍스트 형식의 이름이 null인 경우 이 컨텍스트는 스레드를 실행하는 데 사용되는 사용자 계정의 도메인에 대한 도메인 컨트롤러입니다. Machine 컨텍스트 형식의 이름이 null인 경우 로컬 머신 이름입니다. 이 매개 변수는 ApplicationDirectory 컨텍스트 형식에 대해 null일 수 없습니다.

userName

String

저장소에 연결하는 데 사용되는 사용자 이름입니다. userName 및 password 매개 변수가 모두 null인 경우 현재 프로세스의 자격 증명을 사용합니다. 그렇지 않은 경우에는 userName 및 password 모두 null이 아니어야 하며 이들을 통해 지정되는 자격 증명이 저장소 연결에 사용됩니다.

password

String

저장소에 연결하는 데 사용되는 암호입니다. userName 및 password 매개 변수가 모두 null인 경우 현재 프로세스의 자격 증명을 사용합니다. 그렇지 않은 경우에는 userName 및 password 모두 null이 아니어야 하며 이들을 통해 지정되는 자격 증명이 저장소 연결에 사용됩니다.

예외

ArgumentException

username 및 password 매개 변수가 null이거나 값을 포함해야 하는 경우

contextType 매개 변수에 ApplicationDirectory를 지정할 때 이름을 지정해야 하는 경우

InvalidEnumArgumentException

contextType 매개 변수에 유효한 ContextType 열거형 값이 없는 경우

PrincipalContext(ContextType, String, String, String, String)

Source:

Context.cs

지정한 컨텍스트 형식, 이름, 컨테이너, 사용자 이름 및 암호를 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::String ^ userName, System::String ^ password);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, string userName, string password);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String, userName As String, password As String)

매개 변수

contextType

ContextType

보안 주체 컨텍스트에 대한 저장소 형식을 지정하는 ContextType 열거형 값입니다.

name

String

Domain 컨텍스트 형식에 대한 도메인이나 서버의 이름, Machine 컨텍스트 형식에 대한 시스템 이름 또는 ApplicationDirectory 인스턴스를 호스팅하는 서버 및 포트의 이름입니다.

Domain 컨텍스트 형식의 이름이 null인 경우 이 컨텍스트는 스레드를 실행하는 데 사용되는 사용자 계정의 도메인에 대한 도메인 컨트롤러입니다. Machine 컨텍스트 형식의 이름이 null인 경우 로컬 머신 이름입니다. 이 매개 변수는 ApplicationDirectory 컨텍스트 형식에 대해 null일 수 없습니다.

container

String

컨텍스트의 루트로 사용할 저장소의 컨테이너입니다. 모든 쿼리는 이 루트에서 수행되며 모든 삽입은 이 컨테이너를 대상으로 수행됩니다.

Domain 및 ApplicationDirectory 컨텍스트 형식의 경우 이 매개 변수는 컨테이너 개체의 고유 이름입니다.

Machine 컨텍스트 형식의 경우 이 매개 변수를 null로 설정해야 합니다.

userName

String

저장소에 연결하는 데 사용되는 사용자 이름입니다. userName 및 password 매개 변수가 모두 null인 경우에는 현재 보안 주체의 기본 자격 증명을 사용합니다. 그렇지 않은 경우에는 userName 및 password 모두 null이 아니어야 하며 이들을 통해 지정되는 자격 증명이 저장소 연결에 사용됩니다.

password

String

저장소에 연결하는 데 사용되는 암호입니다. userName 및 password 매개 변수가 모두 null인 경우에는 현재 보안 주체의 기본 자격 증명을 사용합니다. 그렇지 않은 경우에는 userName 및 password 모두 null이 아니어야 하며 이들을 통해 지정되는 자격 증명이 저장소 연결에 사용됩니다.

예외

ArgumentException

username 및 password 매개 변수가 null이거나 값을 포함해야 하는 경우

contextType 매개 변수에 Machine 컨텍스트 형식을 지정할 때 컨테이너를 지정할 수 없는 경우

name 매개 변수에 ApplicationDirectory를 지정할 때 container 또는 contextType를 지정해야 하는 경우

InvalidEnumArgumentException

contextType 매개 변수에 유효한 ContextType 열거형 값이 없는 경우

설명

InvalidOperationException 보안 주체 컨텍스트에 지정된 Domain 컨테이너가 유효한 컨테이너가 아닌 경우 서버에 연결하는 후속 디렉터리 작업 호출에서 이 throw될 수 있습니다. 컨테이너는 스키마 클래스에 사용자, 그룹 또는 컴퓨터의 가능한Inferiors 특성에 주 클래스가 있는 개체로 정의됩니다.

PrincipalContext(ContextType, String, String, ContextOptions, String, String)

Source:

Context.cs

지정한 컨텍스트 형식, 이름, 컨테이너, 컨텍스트 옵션, 사용자 이름 및 암호를 사용하여 PrincipalContext 클래스의 새 인스턴스를 초기화합니다.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::DirectoryServices::AccountManagement::ContextOptions options, System::String ^ userName, System::String ^ password);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, System.DirectoryServices.AccountManagement.ContextOptions options, string userName, string password);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * System.DirectoryServices.AccountManagement.ContextOptions * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions, userName As String, password As String)

매개 변수

contextType

ContextType

보안 주체 컨텍스트에 대한 저장소 형식을 지정하는 ContextType 열거형 값입니다.

name

String

Domain 컨텍스트 형식에 대한 도메인이나 서버의 이름, Machine 컨텍스트 형식에 대한 시스템 이름 또는 ApplicationDirectory 인스턴스를 호스팅하는 서버 및 포트의 이름입니다.

Domain 컨텍스트 형식의 이름이 null인 경우 이 컨텍스트는 스레드를 실행하는 데 사용되는 사용자 계정의 도메인에 대한 도메인 컨트롤러입니다. Machine 컨텍스트 형식의 이름이 null인 경우 로컬 머신 이름입니다. 이 매개 변수는 ApplicationDirectory 컨텍스트 형식에 대해 null일 수 없습니다.

container

String

컨텍스트의 루트로 사용할 저장소의 컨테이너입니다. 모든 쿼리는 이 루트에서 수행되며 모든 삽입은 이 컨테이너를 대상으로 수행됩니다.

Domain 및 ApplicationDirectory 컨텍스트 형식의 경우 이 매개 변수는 컨테이너 개체의 고유 이름입니다.

Machine 컨텍스트 형식의 경우 이 매개 변수를 null로 설정해야 합니다.

options

ContextOptions

서버에 바인딩하는 데 사용되는 옵션을 지정하는 하나 이상의 ContextOptions 열거형 값의 조합입니다. 이 매개 변수가 null인 경우 기본 옵션은 ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing입니다.

userName

String

저장소에 연결하는 데 사용되는 사용자 이름입니다. userName 및 password 매개 변수가 모두 null인 경우에는 현재 보안 주체의 기본 자격 증명을 사용합니다. 그렇지 않은 경우에는 userName 및 password 모두 null이 아니어야 하며 이들을 통해 지정되는 자격 증명이 저장소 연결에 사용됩니다.

password

String

저장소에 연결하는 데 사용되는 암호입니다. userName 및 password 매개 변수가 모두 null인 경우에는 현재 보안 주체의 기본 자격 증명을 사용합니다. 그렇지 않은 경우에는 userName 및 password 모두 null이 아니어야 하며 이들을 통해 지정되는 자격 증명이 저장소 연결에 사용됩니다.

예외

ArgumentException

username 및 password 매개 변수가 null이거나 값을 포함해야 하는 경우

contextType 매개 변수에 Machine 컨텍스트 형식을 지정할 때 컨테이너를 지정할 수 없는 경우

contextType 매개 변수에 ApplicationDirectory를 지정할 때 이름이나 컨테이너를 지정해야 하는 경우

InvalidEnumArgumentException

contextType 매개 변수에 유효한 ContextType 열거형 값이 없는 경우

options 매개 변수에 유효한 ContextOptions 열거형 값의 조합이 없는 경우

설명

InvalidOperationException 주 컨텍스트에 대해 지정된 Domain 컨테이너가 유효한 컨테이너가 아닌 경우 서버에 연결하는 후속 디렉터리 작업 호출에서 이 throw될 수 있습니다. 컨테이너는 스키마 클래스의 possibleInferiors 특성에 사용자, 그룹 또는 컴퓨터 중 하나의 주 클래스가 있는 개체로 정의됩니다.