Get-MailContact(RTM)

  • 아티클

 

적용 대상: Exchange Server 2007

마지막으로 수정된 항목: 2007-06-05

Active Directory에서 지정된 연락처의 특성을 모두 가져오려면 Get-MailContact cmdlet를 사용합니다.

구문

Get-MailContact [-Identity <MailContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-MailContact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-MailContact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

자세한 정보

이 cmdlet는 지정된 연락처의 특성을 모두 가져옵니다. 매개 변수가 필요하지 않습니다. 매개 변수 없이 cmdlet를 실행하면 Exchange 조직의 전체 연락처 목록이 반환됩니다.

Get-MailContact cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.

  • Exchange 보기 권한만 있는 관리자 역할

사용 권한, 역할 위임 및 Microsoft Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.

매개 변수

매개 변수 필수 종류 설명

ANR

선택

System.String

모호한 이름 확인(ANR)을 사용하면 지정된 매개 변수가 확인됩니다. 검색되는 기본 특성은 다음과 같습니다.

  • CommonName (CN)

  • DisplayName(displayName)

  • FirstName(givenName)

  • LastName(sn)

  • Alias(mailNickname)

  • LegacyExchangeDN(legacyExchangeDN)

  • Name(name)(CommonName/CN 대신 사용)

  • EmailAddresses(proxyAddresses)

  • SamAccountName(samAccountName)

  • Office(physicalDeliveryOfficeName)

Credential

선택

System.Management.Automation.PSCredential

이 매개 변수는 Active Directory에 액세스하는 데 사용할 계정을 지정합니다.

Credential 매개 변수를 사용하면 계속하기 전에 계정의 암호를 입력하도록 요구하는 명령 프롬프트가 표시됩니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

Active Directory에서 데이터를 검색하는 도메인 컨트롤러의 정규화된 도메인 이름을 지정하려면 해당 명령에 DomainController 매개 변수를 포함시킵니다.

Filter

선택

System.String

이 매개 변수는 반환된 받는 사람 목록을 필터링하는 데 사용됩니다. 필터링 특성을 지정할 수 있습니다.

필터링할 수 있는 속성에 대한 자세한 내용은 -Filter 매개 변수의 필터링할 수 있는 속성을 참조하십시오.

Identity

선택

Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter

이 매개 변수는 연락처를 식별합니다. 연락처의 ADObjectID, 고유 이름, LegacyExchangeDN, GUID, Domain\SamAccountName, UPN(사용자 이름), 전자 메일 주소 또는 별칭이 포함될 수 있습니다.

OrganizationalUnit

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

이 매개 변수는 결과가 제한될 컨테이너를 지정합니다. OU(조직 구성 단위) 또는 도메인이 지정될 수 있습니다. 또한 정식 이름도 지정되어야 합니다. 예를 들면,

  • OU: westcoast.contoso.com/users

  • 도메인: westcoast.contoso.com

ReadFromDomainController

선택

System.Management.Automation.SwitchParameter

이 매개 변수는 사용자 도메인의 도메인 컨트롤러에서 사용자 정보를 읽도록 지정합니다. 포리스트의 모든 받는 사람을 포함하도록 받는 사람 범위를 설정했으며 이 매개 변수를 사용하지 않을 경우 오래된 정보를 가진 글로벌 카탈로그에서 사용자 정보를 읽을 가능성이 있습니다. 이 매개 변수를 사용할 경우 정보를 얻기 위해 여러 읽기가 필요할 수 있습니다.

참고

기본적으로 받는 사람 범위는 Exchange 서버를 호스팅하는 도메인에 설정됩니다.

RecipientTypeDetails

선택

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

RecipientTypeDetails 매개 변수는 반환되는 받는 사람의 유형을 지정합니다. Exchange 2007의 받는 사람 유형은 받는 사람 유형 및 하위 유형으로 분리됩니다. 각 받는 사람 유형은 모든 하위 유형에 대한 모든 일반 속성을 포함합니다. 예를 들어, UserMailbox 유형은 연관된 사서함이 있는 Active Directory의 사용자 계정을 나타냅니다. 여러 사서함 유형이 있기 때문에 RecipientTypeDetails 매개 변수로 각 사서함 유형이 식별됩니다. 예를 들어, 회의실 사서함에는 ConferenceRoomMailbox로 설정된 RecipientTypeDetails가 있으며, 사용자 사서함에는 UserMailbox로 설정된 RecipientTypeDetails가 있습니다.

이 cmdlet의 경우 사용할 수 있는 받는 사람 유형 정보는 다음과 같습니다.

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

선택

Microsoft.Exchange.Data.Unlimited

이 매개 변수는 반환할 받는 사람 개체의 총 수를 지정합니다. 값이 지정되지 않으면 매개 변수에서 필터와 일치하는 모든 결과가 반환됩니다.

SortBy

선택

System.String

이 매개 변수는 결과를 정렬하는 기준에 대한 특성을 지정합니다. 정렬은 한 번에 하나의 특성으로 항상 오름차순으로 수행됩니다.

입력 형식

반환 형식

오류

오류 설명

예외

예외 설명

예제

다음 예는 Get-MailContact 명령을 사용하여 'Ted'라는 메일 사용 가능한 연락처를 가져옵니다.

Get-MailContact -Identity Ted | Format-List