Share via


Get-UMMailbox

 

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

마지막으로 수정된 항목: 2007-07-20

Get-UMMailbox cmdlet는 UM 사용 가능 받는 사람의 UM(통합 메시징) 속성을 표시합니다.

구문

Get-UMMailbox [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

자세한 정보

Get-UMMailbox cmdlet는 단일 UM 사서함에 대한 UM 속성을 검색합니다. UM 사용 가능 사서함 목록을 반환할 수도 있습니다.

Get-UMMailbox cmdlet를 실행하려면 사용하는 계정이 Exchange 받는 사람 관리자 역할을 위임받아야 합니다.

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

매개 변수

매개 변수 필수 종류 설명

Anr

선택

System.String

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

  • CN(CommonName)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

선택

System.Management.Automation.PSCredential

이 매개 변수는 Active Directory 디렉터리 서비스에 액세스하는 데 사용할 사용자 이름과 암호를 지정합니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

이 매개 변수는 해당 구성 변경을 Active Directory에 기록하는 도메인 컨트롤러의 정규화된 도메인 이름을 지정합니다.

Filter

선택

System.String

cmdlet에서 반환되는 결과를 필터링할 수 있습니다.

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

Identity

선택

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

이 매개 변수는 통합 메시징을 사용할 사용자를 지정합니다. 이 매개 변수에 대한 변수는 다음과 같습니다.

  • ADObjectID

  • GUID

  • DN

  • Domain\Account

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Instance 매개 변수가 사용되지 않는 경우 이 매개 변수가 필요합니다.

IgnoreDefaultScope

선택

System.Management.Automation.SwitchParameter

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

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

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

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

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

OrganizationalUnit

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

이 매개 변수는 OU(조직 구성 단위)를 지정하며, 결과를 제한하는 데 사용됩니다. 이 매개 변수를 사용하면 지정한 컨테이너의 사서함만 검색됩니다. OU 또는 도메인 이름을 사용할 수 있습니다. OU를 사용하는 경우 OU의 정식 이름을 지정해야 합니다.

ReadFromDomainController

선택

System.Management.Automation.SwitchParameter

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

ResultSize

선택

Microsoft.Exchange.Data.Unlimited

이 매개 변수는 반환되는 최대 결과 수를 지정합니다. 최대 결과 수가 지정되지 않으면 해당 cmdlet에서 모든 결과를 반환합니다.

SortBy

선택

System.String

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

  • Alias

  • DisplayName

  • Name

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

입력 형식

종류 설명

 

 

반환 형식

종류 설명

 

 

오류

오류 설명

 

 

예제

첫 번째 코드 예에서는 Active Directory 포리스트의 모든 UM 사용 가능 사서함 목록을 서식 있는 목록에 표시합니다.

두 번째 코드 예에서는 yanli@contoso.com에 대한 UM 사서함 속성을 표시합니다.

Get-UMMailbox | format-list

Get-UMMailbox -Identity yanli@contoso.com