Get-EXOMailboxFolderStatistics
Este cmdlet está disponível somente no módulo do PowerShell do Exchange Online. Para obter mais informações, consulte Sobre o módulo do PowerShell do Exchange Online.
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 e a ID da pasta e outras informações.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-EXOMailboxFolderStatistics
[-Archive]
[-DiagnosticInfo <String>]
[-ExternalDirectoryObjectId <Guid>]
[-Folderscope <ElcFolderType>]
[-Identity <String>]
[-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 da 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 pasta da Caixa de Entrada para todas as caixas de correio.
Parâmetros
-Archive
Aplicável: Exchange Online
A opção de Arquivo Morto especifica se as estatísticas de uso da caixa de correio de arquivo morto 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DiagnosticInfo
Aplicável: Exchange Online
Observação: este parâmetro está preterido na versão 3.7.0-Preview1 ou posterior do módulo.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExternalDirectoryObjectId
Aplicável: Exchange Online
O parâmetro ExternalDirectoryObjectId identifica a caixa de correio que você deseja exibir pelo ObjectId no Microsoft Entra ID.
Não é possível usar esse parâmetro com os parâmetros Identity, PrimarySmtpAddress ou UserPrincipalName.
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Folderscope
Aplicável: Exchange Online
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
- História da conversa
- DeletedItems
- Rascunhos
- Caixa de Entrada
- Diário
- Lixo eletrônico
- LegacyArchiveJournals
- ManagedCustomFolder
- NonIpmRoot
- Observações
- Caixa de saída
- Personal
- Itens recuperáveis
- RssSubscriptions
- SentItems
- SyncIssues
- Tarefas
Propriedades do parâmetro
| Tipo: | ElcFolderType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Online
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 UPN (nome UPN) para identificar a caixa de correio.
Caso contrário, você poderá usar qualquer valor que identifique exclusivamente a caixa de correio ou o usuário do email. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- LegacyExchangeDN
- SamAccountName
Não é possível usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, PrimarySmtpAddress ou UserPrincipalName.
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeOldestAndNewestItems
Aplicável: Exchange Online
A opção IncludeOldestAndNewestItems especifica se as datas dos itens mais antigos e mais recentes devem ser retornadas em cada pasta. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IncludeSoftDeletedRecipients
Aplicável: Exchange Online
A opção IncludeSoftDeletedRecipients especifica se as caixas de correio excluídas temporariamente devem ser incluídas nos resultados. Não é preciso especificar um valor com essa opção.
As caixas de correio excluídas temporariamente são caixas de correio que foram excluídas, mas ainda podem ser recuperadas.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PrimarySmtpAddress
Aplicável: Exchange Online
O PrimarySmtpAddress identifica a caixa de correio que você deseja exibir pelo endereço de email SMTP primário (por exemplo, navin@contoso.com).
Não é possível usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, Identity ou UserPrincipalName.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-UserPrincipalName
Aplicável: Exchange Online
O parâmetro UserPrincipalName identifica a caixa de correio que você deseja exibir por UPN (por exemplo, navin@contoso.onmicrosoft.com).
Não é possível usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, Identity ou PrimarySmtpAddress.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.