Get-MailboxStatistics

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

Get-MailboxStatistics cmdlet을 사용하여 사서함 크기, 포함된 메시지 수 및 마지막으로 액세스한 시간과 같은 사서함에 대한 정보를 반환합니다. 또한 이동 기록 또는 완료된 이동 요청의 이동 보고서를 가져올 수 있습니다.

참고: Exchange Online PowerShell에서는 이 cmdlet 대신 Get-EXOMailboxStatistics cmdlet을 사용하는 것이 좋습니다. 자세한 내용은 원격 PowerShell을 사용하여 Exchange Online에 연결을 참조하세요.

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

Syntax

Get-MailboxStatistics
   -Database <DatabaseIdParameter>
   [[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludeQuarantineDetails]
   [-NoADLookup]
   [<CommonParameters>]
Get-MailboxStatistics
   [-Identity] <GeneralMailboxOrMailUserIdParameter>
   [-Archive]
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludeQuarantineDetails]
   [-IncludeSoftDeletedRecipients]
   [-NoADLookup]
   [<CommonParameters>]
Get-MailboxStatistics
   -Server <ServerIdParameter>
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludePassive]
   [-IncludeQuarantineDetails]
   [-NoADLookup]
   [<CommonParameters>]

Description

사서함 서버에서만 매개 변수 없이 Get-MailboxStatistics cmdlet을 사용할 수 있습니다. 이 경우 cmdlet은 로컬 서버의 모든 데이터베이스에 있는 모든 사서함에 대한 통계를 반환합니다.

Get-MailboxStatistics cmdlet을 완료하려면 서버, 데이터베이스 또는 ID 매개 변수 중 하나 이상이 필요합니다.

Get-MailboxStatistics cmdlet을 사용하여 이동 요청 문제를 해결하기 위해 완료된 이동 요청에 대한 자세한 이동 기록 및 이동 보고서를 반환할 수 있습니다. 이동 기록을 보려면 이 cmdlet을 개체로 전달해야 합니다. 이동 기록은 사서함 데이터베이스에 유지되며 증분 번호가 매겨지고 마지막으로 실행된 이동 요청은 항상 0으로 번호가 매겨집니다. 자세한 내용은 이 항목의 "예제 7", "예제 8" 및 "예제 9"를 참조하세요.

완료된 이동 요청에 대한 이동 보고서 및 이동 기록만 볼 수 있습니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Get-MailboxStatistics -Identity AylaKol

이 예제에서는 연결된 별칭 AylaKol을 사용하여 사용자 Ayla Kol의 사서함에 대한 사서함 통계를 검색합니다.

예 2

Get-MailboxStatistics -Server MailboxServer01

다음은 MailboxServer01 서버의 모든 사서함에 대한 사서함 통계를 검색하는 예제입니다.

예 3

Get-MailboxStatistics -Identity contoso\chris

다음은 지정된 사서함에 대한 사서함 통계를 검색하는 예제입니다.

예 4

Get-MailboxStatistics -Database "Mailbox Database"

다음은 지정된 사서함 데이터베이스의 모든 사서함에 대한 사서함 통계를 검색하는 예제입니다.

예 5

Get-MailboxDatabase | Get-MailboxStatistics -Filter 'DisconnectDate -ne $null'

다음은 조직의 모든 사서함 데이터베이스에 대한 연결이 끊긴 사서함에 대한 사서함 통계를 검색하는 예제입니다. -ne 연산자는 같지 않음을 의미합니다.

예 6

Get-MailboxStatistics -Database "Mailbox Database" -StoreMailboxIdentity 3b475034-303d-49b2-9403-ae022b43742d

다음은 연결이 끊긴 단일 사서함에 대한 사서함 통계를 검색하는 예제입니다. StoreMailboxIdentity 매개 변수의 값은 연결이 끊긴 사서함의 사서함 GUID입니다. LegacyDN을 사용할 수도 있습니다.

예 7

Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-List

다음은 Ayla Kol 사서함에 대한 완료된 이동 요청에 대한 요약 이동 기록을 반환하는 예제입니다. 출력을 Format-List cmdlet에 파이프라인하지 않으면 이동 기록이 표시되지 않습니다.

예 8

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory

$temp.MoveHistory[0]

이 예제에서는 Ayla Kol의 사서함에 대한 완료된 이동 요청에 대한 자세한 이동 기록을 반환합니다. 이 예제에서는 임시 변수를 사용하여 사서함 통계 개체를 저장합니다. 사서함을 여러 번 이동한 경우 여러 이동 보고서가 있습니다. 마지막 이동 보고서는 항상 MoveReport[0]입니다.

예제 9

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport

$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv

다음은 Ayla Kol 사서함에 대한 자세한 이동 기록 및 자세한 이동 보고서를 반환하는 예제입니다. 이 예제에서는 임시 변수를 사용하여 이동 요청 통계 개체를 저장하고 이동 보고서를 CSV 파일로 출력합니다.

매개 변수

-Archive

보관 스위치는 사서함과 연결된 보관 사서함에 대한 사서함 통계를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-CopyOnServer

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

CopyOnServer 매개 변수는 지정된 서버의 특정 데이터베이스 복사본에서 통계를 검색하는 데 사용됩니다.

서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예제:

  • 이름
  • FQDN
  • DN(고유 이름)
  • Exchange 레거시 DN

Exchange 레거시 DN

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Database

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

Database 매개 변수는 지정된 데이터베이스의 모든 사서함에 대한 통계를 반환합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름
  • DN(고유 이름)
  • GUID

이 매개 변수는 Get-MailboxDatabase cmdlet의 파이프라인 입력을 허용합니다.

Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

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

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Filter

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

Filter 매개 변수는 OPATH 구문을 사용하여 지정된 속성 및 값으로 결과를 필터링합니다. 검색 조건은 구문을 "Property -ComparisonOperator 'Value'"사용합니다.

  • 전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예 $true: , $false또는 $null)이 포함된 경우 대신 작은따옴표 ' 를 사용합니다. 이 매개 변수는 문자열(시스템 블록이 아님)이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 사용할 수 있습니다.
  • 속성은 필터링 가능한 속성입니다.
  • ComparisonOperator는 OPATH 비교 연산자입니다(예 -eq : 같음 및 -like 문자열 비교의 경우). 비교 연산자에 대한 자세한 내용은 about_Comparison_Operators 참조하세요.
  • 값은 검색할 속성 값입니다. 텍스트 값과 변수를 작은따옴표('Value' 또는 '$Variable')로 묶습니다. 변수 값에 작은따옴표가 포함된 경우 변수를 올바르게 확장하려면 작은따옴표를 식별(이스케이프)해야 합니다. 예를 들어 대신 를 '$User'사용합니다 '$($User -Replace "'","''")'. 정수 또는 시스템 값을 따옴표로 묶지 마세요(예: , , $true$false또는 $null 를 대신 사용500).

논리 연산자 -and-or를 사용하여 여러 검색 조건을 함께 연결할 수 있습니다. 예를 들어 "Criteria1 -and Criteria2" 또는 "(Criteria1 -and Criteria2) -or Criteria3"입니다.

Exchange의 OPATH 필터에 대한 자세한 내용은 추가 OPATH 구문 정보를 참조하세요.

예를 들어 연결이 끊긴 모든 사서함을 특정 사서함 데이터베이스에 표시하려면 구문을 'DisconnectDate -ne $null'사용합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 매개 변수는 통계를 반환할 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • Domain\Username
  • 전자 메일 주소
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 사용자 ID 또는 UPN(사용자 계정 이름)
Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeMoveHistory

IncludeMoveHistory 스위치는 상태, 플래그, 대상 데이터베이스, 잘못된 항목, 시작 시간, 종료 시간, 이동 요청이 다양한 단계에 있었던 기간 및 실패 코드와 같은 완료된 이동 요청의 기록을 포함하는 사서함에 대한 추가 정보를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeMoveReport

IncludeMoveReport 스위치는 서버 연결 및 이동 단계와 같은 완료된 이동 요청에 대한 자세한 이동 보고서를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 명령의 출력은 자세한 정보이므로 더 쉽게 분석할 수 있도록 출력을 .CSV 파일로 보내야 합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludePassive

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

IncludePassive 스위치는 모든 활성 및 수동 데이터베이스 복사본에서 통계를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하지 않으면 명령은 활성 데이터베이스 복사본에서만 통계를 검색합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeQuarantineDetails

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

IncludeQuarantineDetails 스위치는 결과에 포함되지 않은 사서함에 대한 추가 격리 세부 정보를 반환할지 여부를 지정합니다. 이러한 세부 정보를 사용하여 사서함이 격리된 시기와 이유를 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

특히 이 스위치는 사서함의 QuarantineDescription, QuarantineLastCrash 및 QuarantineEnd 속성의 값을 반환합니다. 이러한 값을 보려면 서식 cmdlet을 사용해야 합니다. 예를 들면 Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*와 같습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeSoftDeletedRecipients

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

IncludeSoftDeletedRecipients 스위치는 일시 삭제된 사서함을 결과에 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-NoADLookup

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

NoADLookup 스위치는 Active Directory가 아닌 사서함 데이터베이스에서 정보를 검색할 수 있도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 많은 수의 사서함이 포함된 사서함 데이터베이스를 쿼리할 때 cmdlet 성능을 향상시키는 데 도움이 됩니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

Server 매개 변수는 사서함 통계를 가져오려는 서버를 지정합니다. 다음 값 중 하나를 사용할 수 있습니다.

  • FQDN(정규화된 도메인 이름)
  • NetBIOS 이름

Server 매개 변수에 대한 값을 지정하면 명령은 지정된 서버의 복구 데이터베이스를 포함하여 모든 데이터베이스의 모든 사서함에 대한 통계를 반환합니다. 이 매개 변수를 지정하지 않으면 명령은 로컬 서버에 대한 로그온 통계를 반환합니다.

Type:ServerIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-StoreMailboxIdentity

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

StoreMailboxIdentity 매개 변수는 지정된 데이터베이스의 단일 사서함에 대한 통계를 반환하기 위해 Database 매개 변수와 함께 사용할 때 사서함 ID를 지정합니다. 다음 값 중 하나를 사용할 수 있습니다.

  • MailboxGuid
  • LegacyDN

이 구문을 사용하여 해당 Active Directory 개체가 없거나 사서함 데이터베이스의 연결이 끊긴 사서함을 가리키지 않는 해당 Active Directory 개체가 있는 연결이 끊긴 사서함에 대한 정보를 검색합니다.

Type:StoreMailboxIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

입력

Input types

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

출력

Output types

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