이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

Get-Mailbox

 

적용 대상:Exchange Online, Exchange Server 2016

마지막으로 수정된 항목:2017-06-08

이 cmdlet은 온-프레미스 Exchange Server 2016 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.

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

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하세요.

Get-Mailbox [-Identity <MailboxIdParameter>] <COMMON PARAMETERS>

Get-Mailbox [-MailboxPlan <MailboxPlanIdParameter>] <COMMON PARAMETERS>

Get-Mailbox [-Server <ServerIdParameter>] <COMMON PARAMETERS>

Get-Mailbox [-Database <DatabaseIdParameter>] <COMMON PARAMETERS>

Get-Mailbox [-Anr <String>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-Arbitration <SwitchParameter>] [-Archive <SwitchParameter>] [-AuditLog <SwitchParameter>] [-AuxAuditLog <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-GroupMailbox <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-InactiveMailboxOnly <SwitchParameter>] [-IncludeInactiveMailbox <SwitchParameter>] [-Migration <SwitchParameter>] [-Monitoring <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PublicFolder <SwitchParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-RemoteArchive <SwitchParameter>] [-ResultSize <Unlimited>] [-SoftDeletedMailbox <SwitchParameter>] [-SortBy <String>] [-SupervisoryReviewPolicy <SwitchParameter>]

이 예에서는 조직의 모든 사서함 요약 목록이 반환됩니다.

Get-Mailbox -ResultSize unlimited

이 예에서는 조직의 Users OU에 있는 모든 사서함 목록이 반환됩니다.

Get-Mailbox -OrganizationalUnit Users

이 예에서는 "Chr" 문자열에 대한 모호한 이름 확인 검색에서 확인되는 모든 사서함을 반환합니다. 이 예에서는 Chris Ashton, Christian Hess 및 Christa Geller 같은 사용자의 사서함이 반환됩니다.

Get-Mailbox -Anr Chr

이 예제에서는 Mailbox01이라는 사서함 서버의 모든 보관 사서함에 대한 요약 목록을 반환합니다.

Get-Mailbox -Archive -Server Mailbox01

이 예제에서는 사용자 ed@contoso.com에 대한 원격 보관 사서함 관련 정보를 반환합니다.

Get-Mailbox -Identity ed@contoso.com -RemoteArchive

note참고:
온-프레미스 Exchange 환경에서 Get-Mailbox cmdlet을 사용하여 사서함의 할당량 설정을 확인할 때는 먼저 UseDatabaseQuotaDefaults 속성의 값을 확인해야 합니다. 이 속성의 값이 True이면 사서함별 할당량 설정은 무시되므로 Get-MailboxDatabase cmdlet을 사용하여 실제 값을 확인해야 합니다. UseDatabaseQuotaDefaults 속성이 False이면 사서함별 할당량 설정이 사용되는 것이므로 Get-Mailbox cmdlet을 통해 확인하는 값이 사서함의 실제 할당량 값입니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 cmdlet의 모든 매개 변수가 이 항목에 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 필요한 사용 권한을 확인하려면 다음을 참조하세요. 받는 사람에 게 사용 권한의 "받는 사람의 프로비전 권한" 섹션

 

매개 변수 필수 종류 설명

Anr

선택

System.String

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

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Arbitration

옵션

System.Management.Automation.SwitchParameter

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

Arbitration 매개 변수는 명령을 실행 중인 사서함이 중재 사서함이도록 지정합니다. 중재 사서함은 승인 워크플로를 관리하는 데 사용됩니다. 예를 들어 중재 사서함은 중재된 받는 사람과 메일 그룹 구성원 승인을 처리하는 데 사용됩니다.

Archive

선택

System.Management.Automation.SwitchParameter

Archive 스위치는 결과에 보관 사서함을 포함할지 여부를 지정 합니다. 이 스위치와 함께 값을 지정할 필요가 없습니다.

이 스위치는 보관 사서함을 반환 하려면 필요 합니다.

AuditLog

옵션

System.Management.Automation.SwitchParameter

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

AuxAuditLog

옵션

System.Management.Automation.SwitchParameter

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Credential

옵션

System.Management.Automation.PSCredential

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

Credential 매개 변수는 이 명령을 실행하는 데 사용되는 사용자 이름과 암호를 지정합니다. 일반적으로는 필요한 권한이 있는 여러 자격 증명을 제공해야 하는 경우나 스크립트를 사용하는 경우 이 매개 변수를 사용합니다.

이 매개 변수는 자격 증명 개체의 생성 및 전달이 필요합니다. 이 자격 증명 개체는 Get-Credential cmdlet을 사용하여 만들어집니다. 자세한 내용은 Get-Credential을 참조하세요.

Database

옵션

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

Database 매개 변수는 결과를 사서함 데이터베이스별로 필터링합니다. 이 매개 변수를 사용할 때는 지정한 데이터베이스의 사서함만 결과에 포함됩니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름

  • DN(고유 이름)

  • GUID

이 매개 변수를 Anr, Identity 또는 Server 매개 변수와 함께 사용할 수는 없습니다.

DomainController

옵션

Microsoft.Exchange.Data.Fqdn

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 데이터를 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화 된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

Filter

옵션

System.String

Filter 매개 변수는 받는 사람을 필터링하는 데 사용되는 OPath 필터를 나타냅니다.

필터링할 수 있는 속성에 대한 자세한 내용은 Filterable properties for the -Filter parameter을 참고하세요.

GroupMailbox

옵션

System.Management.Automation.SwitchParameter

GroupMailbox 스위치는 결과에 Office 365 그룹 을 포함할지 여부를 지정 합니다. 이 스위치와 함께 값을 지정할 필요가 없습니다.

이 스위치는 Office 365 그룹 반환 해야 합니다.

Identity

옵션

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Identity 매개 변수는 보려는 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다.

예를 들면 다음과 같습니다.

  • 이름

  • 표시 이름

  • 별칭

  • DN(고유 이름)

  • 정식 DN

  • <domain name>\<account name>

  • 전자 메일 주소

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • 사용자 ID 또는 UPN(사용자 계정 이름)

이 매개 변수를 Anr, Database, MailboxPlan 또는 Server 매개 변수와 함께 사용할 수는 없습니다.

IgnoreDefaultScope

옵션

System.Management.Automation.SwitchParameter

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

IgnoreDefaultScope 스위치는 명령이 Exchange 관리 셸 세션에 대한 기본 받는 사람 범위 설정을 무시하고 해당 범위로 전체 포리스트를 사용하도록 지시합니다. 이 경우 명령은 현재 기본 범위에서 사용할 수 없는 Active Directory 개체에 액세스할 수 있습니다.

IgnoreDefaultScope 스위치를 사용하면 다음과 같은 제한이 적용됩니다.

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

  • Identity 매개 변수의 DN만 사용할 수 있습니다. 별칭 또는 GUID와 같이 다른 식별 형식은 허용되지 않습니다.

InactiveMailboxOnly

옵션

System.Management.Automation.SwitchParameter

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

InactiveMailboxOnly 스위치는 결과에 비활성 사서함을 포함할지 여부를 지정 합니다. 이 스위치와 함께 값을 지정할 필요가 없습니다.

이 스위치를 사용 하면 비활성 사서함만 결과에 포함 됩니다.

비활성 사서함은 일시 삭제되기 전에 원본 위치 유지 또는 소송 보존 상태로 설정된 사서함입니다. 비활성 사서함의 콘텐츠는 보류를 제거할 때까지 보존됩니다.

IncludeInactiveMailbox

옵션

System.Management.Automation.SwitchParameter

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

IncludeInactiveMailbox 스위치는 결과에서 비활성 사서함을 포함할지 여부를 지정 합니다. 이 스위치와 함께 값을 지정할 필요가 없습니다.

이 스위치를 사용 하면 사서함 활성 및 비활성 결과에 포함 됩니다.

비활성 사서함은 일시 삭제되기 전에 원본 위치 유지 또는 소송 보존 상태로 설정된 사서함입니다. 비활성 사서함의 콘텐츠는 보류를 제거할 때까지 보존됩니다.

MailboxPlan

옵션

Microsoft.Exchange.Configuration.Tasks.MailboxPlanIdParameter

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

MailboxPlan 매개 변수는 결과를 사서함 계획별로 필터링합니다. 이 매개 변수를 사용할 때는 지정한 사서함 계획에 할당된 사서함만 결과에 포함됩니다. 사서함 계획을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

  • 이름

  • 별칭

  • 표시 이름

  • DN(고유 이름)

  • GUID

사서함 계획은 클라우드 기반 조직의 사서함 사용자가 사용할 수 있는 권한 및 기능을 지정합니다. Get-MailboxPlan cmdlet을 통해 사용 가능한 사서함 계획을 확인할 수 있습니다.

Anr 또는 Identity 매개 변수와 함께 이 매개 변수를 사용할 수 없습니다.

Migration

옵션

System.Management.Automation.SwitchParameter

Migration 스위치는 결과에 마이그레이션 사서함만을 포함할지 여부를 지정 합니다. 이 스위치와 함께 값을 지정할 필요가 없습니다.

이 스위치는 사서함 마이그레이션 반환 해야 합니다.

Monitoring

옵션

System.Management.Automation.SwitchParameter

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

Monitoring스위치는 결과의 사서함만 모니터링를 포함할지 여부를 지정 합니다. 이 스위치와 함께 값을 지정할 필요가 없습니다.

이 스위치는 모니터링 사서함 반환 해야 합니다.

모니터링 사서함은 관리되는 가용성 및 Exchange Health Manager 서비스에 연결되어 있으며 RecipientTypeDetails 속성 값이 MonitoringMailbox입니다.

OrganizationalUnit

옵션

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 매개 변수는 Active Directory 내의 개체 위치를 기준으로 결과를 필터링합니다. 지정된 위치에 있는 개체만 반환됩니다. 이 매개 변수에 사용할 수 있는 입력은 Get-OrganizationalUnit cmdlet을 사용하여 표시되는 OU(조직 구성 단위) 또는 도메인입니다. OU 또는 도메인을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름

  • DN(고유 이름)

  • DN(고유 이름)

  • GUID

PublicFolder

옵션

System.Management.Automation.SwitchParameter

PublicFolder 스위치는 결과에 공용 폴더 사서함을 포함할지 여부를 지정 합니다. 이 스위치와 함께 값을 지정할 필요가 없습니다.

이 스위치는 공용 폴더 사서함을 반환 하려면 필요 합니다.

ReadFromDomainController

옵션

System.Management.Automation.SwitchParameter

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

ReadFromDomainController 스위치는 사용자 도메인의 도메인 컨트롤러에서 정보를 읽도록 지정합니다. Set-AdServerSettings -ViewEntireForest $true 명령을 실행하여 모든 개체를 포리스트에 포함하고 ReadFromDomainController 스위치를 사용하지 않으면 오래된 정보가 포함된 글로벌 카탈로그에서 정보를 읽을 수 있습니다. ReadFromDomainController 스위치를 사용하는 경우에는 정보를 가져오기 위해 읽기를 여러 번 수행해야 할 수 있습니다. 이 스위치를 사용하여 값을 지정할 필요가 없습니다.

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

RecipientTypeDetails

옵션

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

RecipientTypeDetails 매개 변수는 지정 된 사서함 하위 형식에 따라 결과 필터링합니다. 유효한 값입니다.

  • DiscoveryMailbox

  • EquipmentMailbox

  • GroupMailbox

  • LegacyMailbox

  • LinkedMailbox

  • LinkedRoomMailbox

  • RoomMailbox

  • SchedulingMailbox

  • SharedMailbox

  • TeamMailbox

  • UserMailbox

쉼표로 구분하여 여러 값을 지정할 수 있습니다.

RemoteArchive

옵션

System.Management.Automation.SwitchParameter

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

RemoteArchive 스위치는 결과에 원격 보관 사서함을 포함할지 여부를 지정 합니다. 이 스위치와 함께 값을 지정할 필요가 없습니다.

이 스위치는 원격 보관 사서함을 반환 하려면 필요 합니다.

원격 보관 사서함은 온-프레미스 Exchange 조직의 사서함 사용자와 연결된 클라우드 기반 서비스의 보관 사서함입니다.

ResultSize

옵션

Microsoft.Exchange.Data.Unlimited

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

Server

옵션

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

Server 매개 변수는 결과를 Exchange 서버별로 필터링합니다. 이 매개 변수를 사용할 때는 지정한 Exchange 서버의 사서함만 결과에 포함됩니다.

서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름

    예제: Exchange01

  • DN(고유 이름)

    예: CN=Exchange01,CN=Servers,CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,CN=First Organization,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=contoso,DC=com

  • Exchange 레거시 DN

    예: /o=First Organization/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=Exchange01

  • GUID

    예제: bc014a0d-1509-4ecc-b569-f077eec54942

이 매개 변수를 Anr, Database 또는 Identity 매개 변수와 함께 사용할 수는 없습니다.

note참고:
사서함의 ServerNameServerLegacyDN 속성은 DAG(데이터베이스 사용 가능 그룹) 내의 사서함 이동 직후에 업데이트되지 않을 수도 있습니다. 이러한 사서함 속성의 최신 값을 가져오려면 Get-Mailbox <Identity> | Get-MailboxStatistics | Format-List Name,ServerName,ServerLegacyDN 명령을 실행합니다.

SoftDeletedMailbox

옵션

System.Management.Automation.SwitchParameter

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

SoftDeletedMailbox 스위치는 결과에 일시적으로 삭제 된 사서함을 포함할지 여부를 지정 합니다. 이 스위치와 함께 값을 지정할 필요가 없습니다.

이 스위치는 일시 삭제 된 사서함을 반환 하려면 필요 합니다.

일시 삭제된 사서함은 삭제되었지만 복구할 수 있는 사서함입니다.

SortBy

옵션

System.String

SortBy 매개 변수는 결과의 정렬 기준으로 사용할 속성을 지정합니다. 한 번에 하나의 속성에 대해 정렬이 수행됩니다. 결과는 오름차순으로 정렬됩니다.

기본 보기에 정렬 기준으로 사용할 속성이 포함되어 있지 않으면 | Format-Table -Auto <Property1>,<Property2>...를 명령에 추가하여 표시하려는 모든 속성이 포함된 새로운 보기를 만들 수 있습니다. 속성 이름에 와일드카드(*)를 사용할 수 있습니다.

다음과 같은 속성으로 정렬할 수 있습니다.

  • name

  • DisplayName

  • alias

  • Office

  • ServerLegacyDN

SupervisoryReviewPolicy

옵션

System.Management.Automation.SwitchParameter

PARAMVALUE: SwitchParameter

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.

 
표시: