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에서만 사용 가능합니다.
필터 매개 변수는 OPATH 구문을 사용하여 지정된 속성 및 값으로 결과를 필터링합니다. 검색 조건은 구문을 사용합니다."Property -ComparisonOperator 'Value'"
- 전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예:
$true,$false, 또는$null)이 포함되어 있으면 작은따옴표 ' '를 대신 사용합니다. 이 매개 변수는 시스템 블록이 아닌 문자열이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 가능합니다. - 속성은 필터링 가능한 속성입니다.
- ComparisonOperator는 OPATH 비교 연산자입니다(예:
-eq같음 및-like문자열 비교의 경우). 비교 연산자에 대한 자세한 내용은 about_Comparison_Operators를 참조하세요. - 값은 검색할 속성 값입니다. 텍스트 값과 변수는 작은따옴표(
'Value'또는'$Variable')로 묶습니다. 변수 값에 작은따옴표가 포함된 경우 작은따옴표를 식별(이스케이프)하여 변수를 올바르게 확장해야 합니다. 예를 들어'$User', 대신 를 사용합니다'$($User -Replace "'","''")'. 정수나 시스템 값을 따옴표로 묶지 마세요(예: ,$false, , 또는 대신 사용500$null).$true
논리 연산자 -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
ID 매개 변수는 통계를 반환할 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- 도메인\사용자 이름
- 전자 메일 주소
- GUID
- LegacyExchangeDN
- SamAccountName
- 사용자 ID 또는 UPN(사용자 계정 이름)
주의: Identity 매개 변수에 대한 값 $null 또는 존재하지 않는 값은 Identity 매개 변수 없이 Get- 명령을 실행한 것처럼 모든 개체를 반환합니다. ID 매개 변수에 대한 값 목록이 정확하고 존재하지 않는 $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 설명 }}
매개 변수 속성
| 형식: | 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은 데이터를 반환하지 않습니다.