Get-EXOMailboxFolderStatistics
Este cmdlet só está disponível no módulo Exchange Online PowerShell. Para obter mais informações, veja Acerca do módulo Exchange Online PowerShell.
Utilize o cmdlet Get-EXOMailboxFolderStatistics para obter informações sobre as pastas numa caixa de correio especificada, incluindo o número e o tamanho dos itens na pasta, o nome e o 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 (Padrão)
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 devolver 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 devolve estatísticas para todas as pastas de caixa de correio. A predefinição é FolderScope All.
Exemplo 2
Get-EXOMailboxFolderStatistics -Identity admin@contoso.com -FolderScope Calendar -IncludeOldestAndNewestItems
Este exemplo devolve 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 utiliza o parâmetro FolderScope para ver as estatísticas da pasta Caixa de Entrada para todas as caixas de correio.
Parâmetros
-Archive
Aplicável: Exchange Online
O parâmetro Arquivo especifica se pretende devolver as estatísticas de utilização da caixa de correio de arquivo associada à caixa de correio ou ao utilizador de correio. Não é preciso especificar um valor com essa opção.
Se utilizar este botão numa caixa de correio que não tenha o arquivo ativado, é devolvido um erro.
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
Esse parâmetro está reservado para uso interno da Microsoft.
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 pretende ver pelo ObjectId no Microsoft Entra ID.
Não pode utilizar este 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
- ConversationHistory
- DeletedItems
- Rascunhos
- Caixa de Entrada
- Diário
- E-mail de Lixo
- LegacyArchiveJournals
- ManagedCustomFolder
- NonIpmRoot
- Observações
- Caixa de saída
- Personal
- RecoverableItems
- 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 que utilize o ID de utilizador ou o nome principal de utilizador (UPN) para identificar a caixa de correio.
Caso contrário, pode utilizar qualquer valor que identifique exclusivamente a caixa de correio ou o utilizador de correio. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- LegacyExchangeDN
- SamAccountName
Não pode utilizar este parâmetro com os parâmetros ExternalDirectoryObjectId, PrimarySmtpAddress 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: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeAnalysis
Aplicável: Exchange Online
Esse parâmetro está reservado para uso interno da Microsoft.
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 |
-IncludeOldestAndNewestItems
Aplicável: Exchange Online
O comutador IncludeOldestAndNewestItems especifica se pretende devolver as datas dos itens mais antigos e mais recentes 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
O comutador IncludeSoftDeletedRecipients especifica se deve incluir caixas de correio eliminadas de forma recuperável nos resultados. Não é preciso especificar um valor com essa opção.
As caixas de correio eliminadas de forma recuperável são caixas de correio que foram eliminadas, mas que continuam a ser recuperáveis.
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 pretende ver pelo endereço de e-mail SMTP principal (por exemplo, navin@contoso.com).
Não pode utilizar este 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 pretende ver pelo UPN (por exemplo, navin@contoso.onmicrosoft.com).
Não pode utilizar este 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.