다음을 통해 공유

Get-Recipient(RTM)

  • 아티클

 

적용 대상: Exchange Server 2007

마지막으로 수정된 항목: 2008-04-16

Get-Recipient cmdlet를 사용하여 Active Directory 디렉터리 서비스에서 받는 사람 개체 목록을 반환할 수 있습니다.

구문

get-Recipient [-Identity <RecipientIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientType <RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Recipient [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientType <RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Recipient [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientType <RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

자세한 정보

Get-Recipient cmdlet는 지정된 받는 사람의 특성을 검색하며, 매개 변수가 필요하지 않습니다. 매개 변수 없이 해당 cmdlet가 실행되면 조직의 전체 받는 사람 목록이 반환됩니다.

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

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

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

매개 변수

매개 변수 필수 종류 설명

Anr

선택

System.String

Anr 매개 변수는 ANR(모호한 이름 확인) 검색을 수행할 문자열을 지정합니다. 부분 문자열을 지정하고 해당 문자열과 일치하는 특성의 개체를 검색할 수 있습니다. 검색되는 기본 특성은 다음과 같습니다.

  • CommonName (CN)

  • DisplayName(displayName)

  • FirstName(givenName)

  • LastName(sn)

  • Alias(mailNickname)

Credential

선택

System.Management.Automation.PSCredential

Credential 매개 변수는 Active Directory 액세스에 사용할 사용자 이름과 암호를 지정합니다.

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

DomainController

선택

Microsoft.Exchange.Data.Fqdn

이 구성 변경을 Active Directory에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 명령에 DomainController 매개 변수를 포함시킵니다.

Filter

선택

System.String

Filter 매개 변수를 사용하여 쿼리에 의해 반환되는 받는 사람을 제한하는 데 사용되는 특성을 하나 이상 지정할 수 있습니다. 이 매개 변수는 Identity 매개 변수나 Anr 매개 변수와 함께 사용될 수 없습니다.

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

Identity

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Identity 매개 변수는 받는 사람을 확인합니다. 다음 값 중에서 하나를 사용할 수 있습니다.

  • GUID

  • 도메인\계정

  • UPN(User Principal Name)

  • LegacyExchangeDN

  • SMTP(Simple Mail Transfer Protocol) 주소

  • Name

  • Alias

OrganizationalUnit

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 매개 변수는 OU(조직 구성 단위)나 정식 도메인 이름을 지정하며, 결과를 제한하는 데 사용됩니다. 이 매개 변수를 사용하면 지정한 컨테이너에서 받는 사람 결과만 표시됩니다. 예를 들면,

  • OU: westcoast.contoso.com/users

  • 도메인: westcoast.contoso.com

ReadFromDomainController

선택

System.Management.Automation.SwitchParameter

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

참고

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

RecipientType

선택

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

RecipientType 매개 변수는 주소 목록에 포함할 받는 사람의 유형을 지정하는 필터입니다. 다음 유형 중에서 하나 이상 사용할 수 있습니다.

  • UserMailbox

  • MailUser

  • MailContact

  • MailUniversalDistributionGroup

  • MailUniversalSecruityGroup

  • MailNonUniversalGroup

  • DynamicDistributionGroup

  • PublicFolder

RecipientTypeDetails

선택

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

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

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

  • ConferenceRoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • MailContact

  • DynamicDistributionGroup

  • MailForestContact

  • MailNonUniversalGroup

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

  • MailUser

  • PublicFolder

  • SharedMailbox

ResultSize

선택

Microsoft.Exchange.Data.Unlimited

ResultSize 매개 변수는 반환할 결과의 최대 수를 지정합니다. 필터와 일치하는 받는 사람을 모두 반환하려면 매개 변수 값에 "제한 없음"을 사용합니다. 기본값은 1000입니다.

SortBy

선택

System.String

SortBy 매개 변수는 결과를 정렬하는 기준에 대한 특성을 지정합니다. 한 번에 하나의 특성으로만 정렬할 수 있습니다. 다음 특성으로 정렬할 수 있습니다.

  • Alias

  • DisplayName

  • Name

결과는 오름차순으로 정렬됩니다.

입력 형식

반환 형식

오류

오류 설명

   

 

예외

예외 설명

  

 

예제

첫 번째 예는 조직에 있는 모든 받는 사람에 대한 정보를 얻는 방법을 보여줍니다.

두 번째 예는 조직에 있는 모든 연락처에 대한 정보를 얻는 방법과 이름을 기준으로 정렬하는 방법을 보여줍니다.

Get-Recipient -ResultSize unlimited
Get-Recipient -RecipientType DynamicDistributionGroup -SortBy Name