Get-EXOMailboxFolderStatistics

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online

Esse cmdlet está disponível apenas no módulo Exchange Online PowerShell. Para obter mais informações, consulte Sobre o módulo Exchange Online PowerShell.

Use o cmdlet Get-EXOMailboxFolderStatistics para recuperar informações sobre as pastas em uma caixa de correio especificada, incluindo o número e o tamanho dos itens na pasta, o nome da pasta e a ID e outras informações.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-EXOMailboxFolderStatistics
   [-Archive]
   [-DiagnosticInfo <String>]
   [-ExternalDirectoryObjectId <Guid>]
   [-Folderscope <ElcFolderType>]
   [-Identity <String>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-PrimarySmtpAddress <String>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

Description

Uma caixa de correio pode ter itens ocultos que nunca estão visíveis para o usuário e que são usados apenas por aplicativos. O cmdlet Get-EXOMailboxFolderStatistics pode retornar itens ocultos para os seguintes valores: FolderSize, FolderAndSubfolderSize, ItemsInFolder e ItemsInFolderAndSubfolders.

Não confunda Get-EXOMailboxFolderStatistics cmdlet (pastas) com o cmdlet Get-EXOMailboxStatistics (caixas de correio).

Exemplos

Exemplo 1

Get-EXOMailboxFolderStatistics -Identity admin@contoso.com

Este exemplo retorna estatísticas para todas as pastas de caixa de correio. O padrão é FolderScope All.

Exemplo 2

Get-EXOMailboxFolderStatistics -Identity admin@contoso.com -FolderScope Calendar -IncludeOldestAndNewestItems

Este exemplo retorna estatísticas apenas para pastas de calendário.

Exemplo 3

Get-EXOMailbox -ResultSize Unlimited | Get-EXOMailboxFolderStatistics -FolderScope Inbox | Format-Table Identity,ItemsInFolderAndSubfolders,FolderAndSubfolderSize -AutoSize

Este exemplo usa o parâmetro FolderScope para exibir estatísticas de pastas de caixa de entrada para todas as caixas de correio.

Parâmetros

-Archive

A opção Arquivo especifica se deve retornar as estatísticas de uso da caixa de correio de arquivo associada à caixa de correio ou ao usuário de email. Não é preciso especificar um valor com essa opção.

Se você usar essa opção em uma caixa de correio que não tem o arquivamento habilitado, um erro será retornado.

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

-DiagnosticInfo

Normalmente, você usa o parâmetro DiagnosticInfo somente a pedido de Microsoft Serviço ao Cliente e suporte para solucionar problemas. Os valores válidos são:

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

-ExternalDirectoryObjectId

O parâmetro ExternalDirectoryObjectId identifica a caixa de correio que você deseja exibir pelo ObjectId no Azure Active Directory.

Você não pode usar esse parâmetro com os parâmetros Identity, PrimarySmtpAddress ou UserPrincipalName.

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

-Folderscope

O parâmetro FolderScope especifica o escopo da busca por tipo de pasta. Os valores válidos incluem:

  • Todos
  • Arquivar
  • Calendário
  • Email secundário
  • Contatos
  • ConversationHistory
  • Deleteditems
  • Rascunhos
  • Caixa de Entrada
  • Diário
  • JunkEmail
  • LegacyArchiveJournals
  • ManagedCustomFolder
  • NonIpmRoot
  • Observações
  • Caixa de saída
  • Personal
  • RecoverableItems
  • RssSubscriptions
  • SentItems
  • SyncIssues
  • Tarefas
Type:ElcFolderType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

O parâmetro Identity especifica a identidade da caixa de correio ou do usuário de email. Para obter o melhor desempenho, recomendamos usar a ID do usuário ou o nome da entidade de usuário (UPN) para identificar a caixa de correio.

Caso contrário, você pode usar qualquer valor que identifique exclusivamente a caixa de correio ou o usuário de email. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • LegacyExchangeDN
  • SamAccountName

Você não pode usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, PrimarySmtpAddress ou UserPrincipalName.

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

-IncludeAnalysis

Esse parâmetro está reservado para uso interno da Microsoft.

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

-IncludeOldestAndNewestItems

A opção IncludeOldestAndNewestItems especifica se deve retornar as datas dos itens mais antigos e mais recentes em cada pasta. Não é preciso especificar um valor com essa opção.

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

-IncludeSoftDeletedRecipients

A opção IncludeSoftDeletedRecipients especifica se deve incluir caixas de correio excluídas suavemente nos resultados. Não é preciso especificar um valor com essa opção.

Caixas de correio excluídas suavemente são caixas de correio que foram excluídas, mas ainda podem ser recuperadas.

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

-PrimarySmtpAddress

O PrimarySmtpAddress identifica a caixa de correio que você deseja exibir por endereço de email SMTP primário (por exemplo, navin@contoso.com).

Você não pode usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, Identity ou UserPrincipalName.

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

-UserPrincipalName

O parâmetro UserPrincipalName identifica a caixa de correio que você deseja exibir por UPN (por exemplo, navin@contoso.onmicrosoft.com).

Você não pode usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, Identity ou PrimarySmtpAddress.

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