Get-MailboxStatistics
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수 및 설정은 한 환경 또는 다른 환경에만 사용할 수 있습니다.
Get-MailboxStatistics cmdlet을 사용하여 사서함 크기, 포함된 메시지 수 및 마지막으로 액세스한 시간과 같은 사서함에 대한 정보를 반환합니다. 또한 이동 기록 또는 완료된 이동 요청의 이동 보고서를 가져올 수 있습니다.
참고: Exchange Online PowerShell에서는 이 cmdlet 대신 Get-EXOMailboxStatistics cmdlet을 사용하는 것이 좋습니다. 자세한 내용은 원격 PowerShell을 사용하여 Exchange Online에 연결을 참조하세요.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Database
Get-MailboxStatistics
[[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
-Database <DatabaseIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>]
Identity
Get-MailboxStatistics
[-Identity] <GeneralMailboxOrMailUserIdParameter>
[-Archive]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-IncludeSoftDeletedRecipients]
[-NoADLookup]
[-UseCustomRouting]
[<CommonParameters>]
Server
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"를 참조하세요.
완료된 이동 요청에 대한 이동 보고서 및 이동 기록만 볼 수 있습니다.
참고: Exchange Online PowerShell에서 LastUserActionTime 속성을 더 이상 사용하지 않습니다. 해당 속성의 값을 사서함의 마지막 활성 시간으로 사용하지 마세요.
이 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'
이 예제에서는 organization 모든 사서함 데이터베이스의 연결이 끊긴 사서함에 대한 사서함 통계를 검색합니다. -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
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
아카이브 스위치는 사서함과 연결된 보관 사서함에 대한 사서함 통계를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-CopyOnServer
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
CopyOnServer 매개 변수는 지정된 서버의 특정 데이터베이스 복사본에서 통계를 검색하는 데 사용됩니다.
서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예제:
- 이름
- FQDN
- DN(고유 이름)
- Exchange 레거시 DN
Exchange 레거시 DN
매개 변수 속성
| 형식: | ServerIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Database
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Database
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
Database 매개 변수는 지정된 데이터베이스의 모든 사서함에 대한 통계를 반환합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- 이름
- DN(고유 이름)
- GUID
이 매개 변수는 Get-MailboxDatabase cmdlet의 파이프라인 입력을 허용합니다.
매개 변수 속성
| 형식: | DatabaseIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Database
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-DomainController
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
매개 변수 속성
| 형식: | Fqdn |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Filter
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 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'사용합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Database
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
Server
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Identity 매개 변수는 통계를 반환할 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- Domain\Username
- 전자 메일 주소
- GUID
- LegacyExchangeDN
- SamAccountName
- 사용자 ID 또는 UPN(사용자 계정 이름)
주의: identity 매개 변수의 값 $null 또는 존재하지 않는 값은 Identity 매개 변수 없이 Get- 명령을 실행한 것처럼 모든 개체를 반환합니다. Identity 매개 변수에 대한 값 목록이 정확하고 존재하지 않는 $null 값이 포함되어 있지 않은지 확인합니다.
매개 변수 속성
| 형식: | GeneralMailboxOrMailUserIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | 1 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-IncludeMoveHistory
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
IncludeMoveHistory 스위치는 상태, 플래그, 대상 데이터베이스, 잘못된 항목, 시작 시간, 종료 시간, 이동 요청이 다양한 단계에 있었던 기간 및 실패 코드와 같이 완료된 이동 요청의 기록을 포함하는 사서함에 대한 추가 정보를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IncludeMoveReport
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
IncludeMoveReport 스위치는 서버 연결 및 이동 단계와 같은 완료된 이동 요청에 대한 자세한 이동 보고서를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 명령의 출력은 자세한 정보이므로 더 쉽게 분석할 수 있도록 출력을 .CSV 파일로 보내야 합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IncludePassive
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
IncludePassive 스위치는 모든 활성 및 수동 데이터베이스 복사본에서 통계를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치를 사용하지 않으면 명령은 활성 데이터베이스 복사본에서만 통계를 검색합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Server
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IncludeQuarantineDetails
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
IncludeQuarantineDetails 스위치는 결과에 포함되지 않은 사서함에 대한 추가 격리 세부 정보를 반환할지 여부를 지정합니다. 이러한 세부 정보를 사용하여 사서함이 격리된 시기와 이유를 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
특히 이 스위치는 사서함의 QuarantineDescription, QuarantineLastCrash 및 QuarantineEnd 속성의 값을 반환합니다. 이러한 값을 보려면 서식 cmdlet을 사용해야 합니다. 예를 들면 Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*와 같습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IncludeSoftDeletedRecipients
적용 가능: Exchange Online
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
IncludeSoftDeletedRecipients 스위치는 일시 삭제된 사서함을 결과에 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
일시 삭제된 사서함은 삭제되었지만 복구할 수 있는 사서함입니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-NoADLookup
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
NoADLookup 스위치는 Active Directory가 아닌 사서함 데이터베이스에서 정보를 검색할 수 있도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치는 많은 수의 사서함이 포함된 사서함 데이터베이스를 쿼리할 때 cmdlet 성능을 향상시키는 데 도움이 됩니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Server
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
Server 매개 변수는 사서함 통계를 가져오려는 서버를 지정합니다. 다음 값 중 하나를 사용할 수 있습니다.
- FQDN(정규화된 도메인 이름)
- NetBIOS 이름
Server 매개 변수에 대한 값을 지정하면 명령은 지정된 서버의 복구 데이터베이스를 포함하여 모든 데이터베이스의 모든 사서함에 대한 통계를 반환합니다. 이 매개 변수를 지정하지 않으면 명령은 로컬 서버에 대한 로그온 통계를 반환합니다.
매개 변수 속성
| 형식: | ServerIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Server
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-StoreMailboxIdentity
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
StoreMailboxIdentity 매개 변수는 지정된 데이터베이스의 단일 사서함에 대한 통계를 반환하기 위해 Database 매개 변수와 함께 사용할 때 사서함 ID를 지정합니다. 다음 값 중 하나를 사용할 수 있습니다.
- MailboxGuid
- LegacyDN
이 구문을 사용하여 해당 Active Directory 개체가 없거나 사서함 데이터베이스의 연결이 끊긴 사서함을 가리키지 않는 해당 Active Directory 개체가 있는 연결이 끊긴 사서함에 대한 정보를 검색합니다.
매개 변수 속성
| 형식: | StoreMailboxIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Database
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-UseCustomRouting
적용 가능: Exchange Online
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
{{ Fill UseCustomRouting description }}
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.