Compartir a través de

Get-EXOMailboxFolderStatistics

Módulo:
Exchange PowerShell

Este cmdlet solo está disponible en el módulo de PowerShell Exchange Online. Para obtener más información, vea Acerca de la Exchange Online módulo de PowerShell.

Use el cmdlet Get-EXOMailboxFolderStatistics para recuperar información sobre las carpetas de un buzón especificado, incluido el número y el tamaño de los elementos de la carpeta, el nombre y el identificador de la carpeta, y otra información.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

Default (valor predeterminado) 

Get-EXOMailboxFolderStatistics

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

Description

Un buzón puede tener elementos ocultos que nunca están visibles para el usuario y que sólo usan las aplicaciones. El cmdlet Get-EXOMailboxFolderStatistics puede devolver elementos ocultos para los siguientes valores: FolderSize, FolderAndSubfolderSize, ItemsInFolder y ItemsInFolderAndSubfolders.

No confunda Get-EXOMailboxFolderStatistics cmdlet (carpetas) con el cmdlet Get-EXOMailboxStatistics (buzones).

Ejemplos

Ejemplo 1

Get-EXOMailboxFolderStatistics -Identity admin@contoso.com

En este ejemplo se devuelven estadísticas para todas las carpetas de buzón de correo. El valor predeterminado es FolderScope All.

Ejemplo 2

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

En este ejemplo se devuelven estadísticas solo para carpetas de calendario.

Ejemplo 3

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

En este ejemplo se usa el parámetro FolderScope para ver las estadísticas de carpetas bandeja de entrada de todos los buzones.

Parámetros

-Archive

Aplicable: Exchange Online

El modificador Archivo especifica si se deben devolver las estadísticas de uso del buzón de archivo asociado al buzón o al usuario de correo. No es necesario especificar un valor con este modificador.

Si usa este modificador en un buzón que no tiene habilitado el archivado, se devuelve un error.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DiagnosticInfo

Aplicable: Exchange Online

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExternalDirectoryObjectId

Aplicable: Exchange Online

El parámetro ExternalDirectoryObjectId identifica el buzón que desea ver por objectId en Microsoft Entra ID.

No puede usar este parámetro con los parámetros Identity, PrimarySmtpAddress o UserPrincipalName.

Propiedades de parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Folderscope

Aplicable: Exchange Online

El parámetro FolderScope especifica el ámbito de la búsqueda por tipo de carpeta. Los valores válidos son:

  • todas
  • Archivar
  • Calendario
  • Otros correos
  • Contactos
  • ConversationHistory
  • DeletedItems
  • Borradores
  • Bandeja de entrada
  • Diario
  • Correo basura
  • LegacyArchiveJournals
  • ManagedCustomFolder
  • NonIpmRoot
  • Notas
  • Bandeja de salida
  • Personal
  • RecoverableItems
  • RssSubscriptions
  • SentItems
  • SyncIssues
  • Tareas

Propiedades de parámetro

Tipo:ElcFolderType
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Online

El parámetro Identity especifica la identidad del buzón de correo o del usuario de correo. Para obtener el mejor rendimiento, se recomienda usar el identificador de usuario o el nombre principal de usuario (UPN) para identificar el buzón.

De lo contrario, puede usar cualquier valor que identifique de forma única el buzón o el usuario de correo. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • LegacyExchangeDN
  • SamAccountName

No se puede usar este parámetro con los parámetros ExternalDirectoryObjectId, PrimarySmtpAddress o UserPrincipalName.

Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IncludeAnalysis

Aplicable: Exchange Online

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeOldestAndNewestItems

Aplicable: Exchange Online

El modificador IncludeOldestAndNewestItems especifica si se deben devolver las fechas de los elementos más antiguos y más recientes de cada carpeta. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeSoftDeletedRecipients

Aplicable: Exchange Online

El modificador IncludeSoftDeletedRecipients especifica si se deben incluir buzones eliminados temporalmente en los resultados. No es necesario especificar un valor con este modificador.

Los buzones eliminados temporalmente son buzones que se han eliminado, pero que todavía se pueden recuperar.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PrimarySmtpAddress

Aplicable: Exchange Online

PrimarySmtpAddress identifica el buzón que desea ver por dirección de correo electrónico SMTP principal (por ejemplo, navin@contoso.com).

No se puede usar este parámetro con los parámetros ExternalDirectoryObjectId, Identity o UserPrincipalName.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-UserPrincipalName

Aplicable: Exchange Online

El parámetro UserPrincipalName identifica el buzón que quiere ver por UPN (por ejemplo, navin@contoso.onmicrosoft.com).

No se puede usar este parámetro con los parámetros ExternalDirectoryObjectId, Identity o PrimarySmtpAddress.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.