Get-MailUser

  • 아티클

 

적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

마지막으로 수정된 항목: 2010-04-27

Get-MailUser cmdlet를 사용하여 Active Directory 디렉터리 서비스에서 지정된 사용자의 메일 관련 특성을 검색할 수 있습니다.

구문

get-MailUser [-Identity <MailUserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-MailUser [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-MailUser [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

자세한 정보

Get-MailUser cmdlet는 지정된 사용자의 모든 메일 관련 특성을 검색합니다.

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

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

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

참고

Get-MailUser cmdlet로는 일부 사용자 특성이 검색되지 않습니다. Get-User cmdlet를 사용하여 추가적인 사용자 특성을 검색할 수 있습니다.

매개 변수

매개 변수 필수 종류 설명

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 매개 변수는 반환된 받는 사람 목록을 필터링하는 데 사용됩니다. 필터링할 특성을 지정할 수 있습니다.

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

Identity

선택

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

Identity 매개 변수는 사용자를 확인합니다. 사용자의 ADObjectID, DN(고유 이름), LegacyExchangeDN, GUID, Domain\SamAccountName, UPN(사용자 이름), 전자 메일 주소 또는 별칭을 포함할 수 있습니다.

IgnoreDefaultScope

선택

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 매개 변수는 명령이 Exchange 관리 셸에 대한 기본 받는 사람 범위 설정을 무시하고 해당 범위로 전체 포리스트를 사용하도록 지시합니다. 이렇게 하면 명령은 현재 기본 범위에 있지 않은 Active Directory 개체에 액세스할 수 있습니다. IgnoreDefaultScope 매개 변수를 사용하면 다음과 같은 제한이 적용됩니다.

  • DomainController 매개 변수를 사용할 수 없습니다. 해당 명령은 적합한 글로벌 카탈로그 서버를 자동으로 사용합니다.

  • Identity 매개 변수의 DN만 사용할 수 있습니다. 별칭이나 GUID 등 다른 ID 형태는 사용할 수 없습니다.

  • OrganizationalUnit 및 Identity 매개 변수를 함께 사용할 수 없습니다.

  • Credential 매개 변수를 사용할 수 없습니다.

OrganizationalUnit

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

  • OU: westcoast.contoso.com/users

  • 도메인: westcoast.contoso.com

ReadFromDomainController

선택

System.Management.Automation.SwitchParameter

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

참고

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

ResultSize

선택

Microsoft.Exchange.Data.Unlimited

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

SortBy

선택

System.String

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

입력 형식

반환 형식

오류

오류 설명

 

예외

예외 설명

 

예제

첫 번째 예에서 Get-MailUser 명령은 매개 변수 없이 전체 Exchange 조직에 대해 메일 사용이 가능한 전체 사용자 목록을 검색하는 데 사용되었습니다.

두 번째 예에서는 사용자 Ted에 대한 메일 설정이 검색되는 다음 표시를 위해 Format-List cmdlet에 파이프되었습니다.

Get-MailUser
Get-MailUser -Identity Ted | Format-List