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은 데이터를 반환하지 않습니다.