Get-EXOMailboxFolderStatistics

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