Get-Contact
적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
마지막으로 수정된 항목: 2010-04-27
Get-Contact cmdlet를 사용하여 지정된 연락처에 관한 정보를 검색할 수 있습니다.
구문
Get-Contact [-Identity <ContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
자세한 정보
Get-Contact cmdlet는 Active Directory 디렉터리 서비스에 있는 특정 연락처 또는 연락처 받는 사람 개체의 속성을 쿼리합니다.
Get-Contact cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.
- Exchange 보기 권한만 있는 관리자 역할
사용 권한, 역할 위임 및 Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
| 매개 변수 | 필수 | 종류 | 설명 |
|---|---|---|---|
Anr |
선택 |
System.String |
Anr 매개 변수는 제공된 일부 문자열과 일치하는 개체를 검색하는 데 사용됩니다. 이는 와일드카드 문자를 사용하는 검색과 유사합니다. |
Credential |
선택 |
System.Management.Automation.PSCredential |
Credential 매개 변수는 연락처의 자격 증명을 위해 Active Directory를 쿼리할 때 사용되는 계정을 지정합니다. |
DomainController |
선택 |
Microsoft.Exchange.Data.Fqdn |
Active Directory에서 데이터를 검색하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 해당 명령에 DomainController 매개 변수를 포함시킵니다. |
Filter |
선택 |
System.String |
Filter 매개 변수는 쿼리에서 반환하는 받는 사람을 제한하는 데 사용되는 특성 집합을 지정합니다. 필터링할 수 있는 속성에 대한 자세한 내용은 -Filter 매개 변수의 필터링할 수 있는 속성을 참조하십시오. |
Identity |
선택 |
Microsoft.Exchange.Configuration.Tasks.ContactIdParameter |
Identity 매개 변수에는 다음 값 중 하나를 사용할 수 있습니다.
|
IgnoreDefaultScope |
선택 |
System.Management.Automation.SwitchParameter |
IgnoreDefaultScope 매개 변수는 명령이 Exchange 관리 셸에 대한 기본 받는 사람 범위 설정을 무시하고 해당 범위로 전체 포리스트를 사용하도록 지시합니다. 이렇게 하면 명령은 현재 기본 범위에 있지 않은 Active Directory 개체에 액세스할 수 있습니다. IgnoreDefaultScope 매개 변수를 사용하면 다음과 같은 제한이 적용됩니다.
|
OrganizationalUnit |
선택 |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
OrganizationalUnit 매개 변수는 지정된 OU(조직 구성 단위)에서만 개체를 반환합니다. |
ReadFromDomainController |
선택 |
System.Management.Automation.SwitchParameter |
ReadFromDomainController 매개 변수는 사용자 정보를 사용자 도메인의 도메인 컨트롤러에서 읽도록 지정합니다. 받는 사람 범위에 포리스트의 모든 받는 사람이 포함되도록 설정하는 경우 이 매개 변수를 사용하지 않으면 사용자 정보를 오래된 정보가 포함된 글로벌 카탈로그에서 읽을 가능성이 있습니다. 이 매개 변수를 사용하는 경우에는 정보를 가져오기 위해 읽기를 여러 번 수행해야 할 수 있습니다. 참고 기본적으로 받는 사람 범위는 Exchange 서버를 호스팅하는 도메인에 설정됩니다. |
RecipientTypeDetails |
선택 |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
RecipientTypeDetails 매개 변수는 반환되는 받는 사람 유형을 지정합니다. Microsoft Exchange Server 2007의 받는 사람 유형은 받는 사람 유형 및 하위 유형으로 구분됩니다. 각 받는 사람 유형에는 모든 하위 유형의 일반 속성이 모두 포함되어 있습니다. 예를 들어 UserMailbox 유형은 연관된 사서함이 있는 Active Directory의 사용자 계정을 나타냅니다. 사서함 유형에도 여러 가지가 있기 때문에 각 사서함 유형은 RecipientTypeDetails 매개 변수로 식별됩니다. 예를 들어 회의실 사서함에는 ConferenceRoomMailbox로 설정된 RecipientTypeDetails가 있으며, 사용자 사서함에는 UserMailbox로 설정된 RecipientTypeDetails가 있습니다. 이 명령의 경우 사용할 수 있는 받는 사람 유형의 세부 사항은 다음과 같습니다.
|
ResultSize |
선택 |
Microsoft.Exchange.Data.Unlimited |
ResultSize 매개 변수는 반환할 결과의 최대 수를 지정합니다. |
SortBy |
선택 |
System.String |
SortBy 매개 변수는 단일 특성을 오름차순으로 정렬하도록 지정합니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
|
|
예외
| 예외 | 설명 |
|---|---|
|
예제
이 예에서 Get-Contact 명령은 Ted Bremer의 연락처를 검색하고 개체를 Format-List 명령에 파이프라이닝하여 연락처에 대한 정보를 표시합니다.
Get-Contact -Identity TedBremer | Format-List