Get-MailboxFolderStatistics

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

Get-MailboxFolderStatistics cmdlet을 사용하면 폴더의 항목 수와 크기, 폴더 이름과 ID 및 기타 정보를 포함하여 지정된 사서함의 폴더에 대한 정보를 검색할 수 있습니다.

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

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

Syntax

Get-MailboxFolderStatistics
   [-Identity] <GeneralMailboxOrMailUserIdParameter>
   [-Archive]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-ResultSize <Unlimited>]
   [-SkipCount <Int32>]
   [<CommonParameters>]
Get-MailboxFolderStatistics
   [[-Identity] <GeneralMailboxOrMailUserIdParameter>]
   [-AuditLog]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-ResultSize <Unlimited>]
   [-SkipCount <Int32>]
   [<CommonParameters>]
Get-MailboxFolderStatistics
   -Database <DatabaseIdParameter>
   -StoreMailboxIdentity <StoreMailboxIdParameter>
   [-DiagnosticInfo <String>]
   [-FolderScope <ElcFolderType>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-ResultSize <Unlimited>]
   [-SkipCount <Int32>]
   [<CommonParameters>]

Description

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

사서함에는 사용자에게 표시되지 않고 응용 프로그램에서만 사용되는 숨겨진 항목이 있을 수 있습니다. Get-MailboxFolderStatistics cmdlet은 FolderSize, FolderAndSubfolderSize, ItemsInFolder 및 ItemsInFolderAndSubfolders 값에 대해 숨겨진 항목을 반환할 수 있습니다.

Get-MailboxFolderStatistics cmdlet을 Get-MailboxStatistics cmdlet과 혼동하지 마십시오.

예제

예 1

Get-MailboxFolderStatistics -Identity contoso\chris

이 예에서는 FolderScope 매개 변수를 지정하지 않고 Contoso 도메인의 사용자 Chris에 대한 모든 정보를 검색합니다.

예 2

Get-MailboxFolderStatistics -Identity Chris -FolderScope Calendar

이 예에서는 FolderScope 매개 변수를 사용하여 사용자 Chris의 일정 폴더에 대한 통계를 표시합니다.

예 3

Get-MailboxFolderStatistics -Identity Ayla@contoso.com -Archive

이 예제에서는 보관 스위치를 사용하여 Ayla의 보관에 대한 통계를 봅니다.

예 4

Get-MailboxFolderStatistics -Identity "Tony" -FolderScope RecoverableItems -IncludeAnalysis

이 예제에서는 IncludeAnalysis 스위치를 사용하여 Tony의 복구 가능한 항목 폴더의 통계를 봅니다.

예 5

$All = Get-Mailbox -ResultSize Unlimited

$All | foreach {Get-MailboxFolderStatistics -Identity $_.Identity -FolderScope Inbox | Format-Table Identity,ItemsInFolderAndSubfolders,FolderAndSubfolderSize -AutoSize}

이 예제에서는 FolderScope 매개 변수를 사용하여 모든 사서함에 대한 받은 편지함 폴더 통계를 봅니다.

매개 변수

-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

-AuditLog

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

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

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

-Database

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

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

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

-DiagnosticInfo

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

일반적으로 DiagnosticInfo 매개 변수는 Microsoft 고객 서비스 및 지원 요청 시만 사용하여 문제를 해결합니다.

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

-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

-FolderScope

FolderScope 매개 변수는 폴더 유형별로 검색 범위를 지정합니다. 유효한 매개 변수 값은 다음과 같습니다.

  • 전체
  • 보관: Exchange 2016 이상.
  • 일정
  • 연락처
  • ConversationHistory
  • DeletedItems
  • 초안
  • 받은 편지함
  • JunkEmail
  • 저널
  • LegacyArchiveJournals: Exchange 2013 이상.
  • ManagedCustomFolder: 모든 관리되는 사용자 지정 폴더에 대한 출력을 반환합니다.
  • NonIpmRoot: Exchange 2013 이상.
  • 참고
  • 보낼 편지함
  • Personal
  • RecoveryableItems: 복구 가능한 항목 폴더 및 삭제, DiscoveryHolds, 제거 및 버전 하위 폴더에 대한 출력을 반환합니다.
  • RssSubscriptions
  • SentItems
  • SyncIssues
  • 작업
Type:ElcFolderType
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

-Identity

Identity 매개 변수는 사서함 또는 메일 사용자의 ID를 지정합니다. 사서함 또는 메일 사용자를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

  • 이름
  • 별칭
  • 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

-IncludeAnalysis

IncludeAnalysis 스위치는 폴더 내의 모든 항목을 검사하고 폴더 및 항목 크기와 관련된 통계를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

명령을 완료하려면 시간이 오래 걸릴 수 있으므로 문제 해결 시에는 이 스위치를 사용해야 합니다.

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

-IncludeOldestAndNewestItems

IncludeOldestAndNewestItems 스위치는 각 폴더에서 가장 오래된 항목과 최신 항목의 날짜를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-IncludeSoftDeletedRecipients

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

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

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

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

-ResultSize

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

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

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

-SkipCount

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

{{ Fill SkipCount Description }}

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

-StoreMailboxIdentity

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

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

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

입력

Input types

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

출력

Output types

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