Get-Mailbox

  • 아티클

 

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

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

Get-Mailbox cmdlet를 사용하여 사서함 개체 및 특성을 보거나, 속성 페이지를 채우거나, 다른 작업에 사서함 정보를 제공할 수 있습니다.

구문

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

get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-Database <DatabaseIdParameter>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

자세한 정보

Get-Mailbox cmdlet는 사서함에 대한 특성 및 개체를 검색합니다. 매개 변수는 필요하지 않습니다. 매개 변수 없이 cmdlet를 사용하면 조직의 모든 사서함이 나열됩니다.

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

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

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

참고

Get-Mailbox cmdlet를 사용하여 현재 저장소 할당량 상태를 정확하게 평가하려면 ProhibitSendQuota, ProhibitSendReceiveQuota 및 IssueWarningQuota 속성 외에 UseDatabaseQuotaDefaults 속성도 확인해야 합니다. UseDatabaseQuotaDefaults 속성의 값이 True이면 사서함별 설정이 무시되고 사서함 데이터베이스 제한이 사용됩니다. 이 속성은 True로 설정되고 ProhibitSendQuota, ProhibitSendReceiveQuota 및 IssueWarningQuota 속성은 제한 없음으로 설정된 경우 사서함의 크기는 제한됩니다. 대신 사서함 데이터베이스 저장소 제한을 참조하여 사서함에 대한 제한 사항을 확인해야 합니다. UseDatabaseQuotaDefaults 속성의 값이 False이면 사서함별 설정이 사용됩니다.

매개 변수

매개 변수 필수 종류 설명

Anr

선택

System.String

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

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

선택

System.Management.Automation.PSCredential

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

Database

선택

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Database 매개 변수는 사서함을 가져올 데이터베이스를 지정합니다. 다음 값을 사용할 수 있습니다.

  • 데이터베이스의 GUID

  • 데이터베이스 이름

  • 서버 이름\데이터베이스 이름

  • 서버 이름\저장소 그룹\데이터베이스 이름

서버 이름을 지정하지 않으면 cmdlet는 로컬 서버의 데이터베이스를 검색합니다. 동일한 서버에 이름이 같은 데이터베이스가 여러 개 있는 경우 저장소 그룹을 지정해야 합니다.

이 매개 변수는 Filter 매개 변수와 함께 사용할 수 없습니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

DomainController 매개 변수는 Active Directory에 액세스하는 데 사용할 도메인 컨트롤러를 지정합니다. 사용하려는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 사용하십시오.

Filter

선택

System.String

Filter 매개 변수는 쿼리에서 반환하는 사서함을 제한하는 데 사용되는 하나 이상의 특성을 지정합니다.

이 매개 변수는 Database 매개 변수와 함께 사용할 수 없습니다.

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

Identity

선택

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • GUID

  • DN(고유 이름)

  • 도메인\계정

  • UPN(사용자 이름)

  • LegacyExchangeDN

  • SmtpAddress

  • 별칭

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 또는 도메인 이름을 사용할 수 있습니다. OU를 사용하는 경우 OU의 정식 이름을 지정해야 합니다.

ReadFromDomainController

선택

System.Management.Automation.SwitchParameter

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

참고

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

RecipientTypeDetails

선택

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

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

이 명령의 경우 사용 가능한 받는 사람 유형 정보는 다음과 같습니다.

  • RoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • SharedMailbox

ResultSize

선택

Microsoft.Exchange.Data.Unlimited

ResultSize 매개 변수는 반환할 결과의 최대 수를 지정합니다. 쿼리와 일치하는 모든 사서함을 반환하려면 이 매개 변수의 값으로 "unlimited"를 사용하십시오. 기본값은 1000입니다.

Server

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 매개 변수는 개별 서버를 지정하며 결과를 제한하는 데 사용됩니다. 이 매개 변수를 사용하면 지정한 서버에 있는 사서함만 가져옵니다. 지정하려는 서버의 일반 이름을 사용하십시오.

SortBy

선택

System.String

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

  • Alias

  • 표시 이름

  • Name

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

입력 형식

반환 형식

오류

오류 설명

 

예외

예외 설명

 

예제

첫 번째 예에서는 조직의 모든 사서함 목록을 가져오는 방법을 보여줍니다.

두 번째 예에서는 Contoso.com 도메인의 사용자 컨테이너에 있는 조직 내 모든 사서함 목록을 가져오는 방법을 보여줍니다.

세 번째 예에서는 모호한 이름 확인을 통해 DC01이라는 도메인에 있는 문자열 "Chr"로 확인되는 모든 사서함을 가져오는 방법을 보여줍니다. 이에 따라 Chris Ashton, Christian Cletus 및 Christa Geller 같은 사용자의 사서함이 반환됩니다.

Get-Mailbox -ResultSize unlimited
Get-Mailbox -OrganizationalUnit Users
Get-Mailbox -Anr Chr -DomainController DC01