Usar Exchange Online PowerShell para mostrar la información del buzón de Microsoft 365 o Office 365

Importante

Consulte el nuevo centro de administración de Exchange. La experiencia es moderna, inteligente, accesible y mejor. Personalice el panel, administre la migración entre inquilinos, experimente la característica grupos mejorada y mucho más. Pruébelo ahora.

Los administradores pueden aprender a usar Exchange Online PowerShell para mostrar información sobre los buzones de correo en su organización de Microsoft 365 o Office 365.

Para darle una idea de algunas de las cosas que puede hacer con PowerShell en Microsoft 365 y Office 365, echemos un vistazo a los buzones de usuario en Exchange Online PowerShell.

Antes de empezar

Para conectarse al PowerShell de Exchange Online, consulte Conexión a Exchange Online PowerShell.

Mostrar información del buzón con Exchange Online PowerShell

Puede obtener fácilmente información acerca de un buzón de usuario único. Por ejemplo, aquí tiene un comando que devuelve información acerca de los buzones de Ken Myer:

Get-Mailbox -Identity "Ken Myer"

Este comando devolverá algo similar a lo siguiente:

Name      Alias       ServerName      ProhibitSendQuota
----      -----       ----------      -----------------
kenmyer   kenmyer     bn1pr02mb038    49.5 GB (53,150,220,288 bytes)

Puede ver cosas como el alias de Ken y su cuota de tamaño de buzón. Pero hay mucha más información asociada a un buzón de Exchange Online que solo las cuatro propiedades devueltas por el cmdlet Get-Mailbox.

Este es un comando de ejemplo que muestra toda la información de un buzón concreto:

Get-Mailbox -Identity "Ken Myer" | Format-List

El comando indica a Exchange Online PowerShell que devuelva todas las propiedades disponibles para el buzón de una lista. Hay unas 200 propiedades y valores de propiedad diferentes. También puede usar los cmdlets Format-List y Format-Table para devolver solo valores de propiedad específicos. Por ejemplo, puede ver las propiedades relacionadas con la retención por juicio de Ken Myer con este comando:

Get-Mailbox -Identity "Ken Myer" | Format-List DisplayName, LitigationHoldEnabled, LitigationHoldDate, LitigationHoldOwner, LitigationHoldDuration

También puede usar caracteres comodín al trabajar con el cmdlet Format-List . Por ejemplo, todas las propiedades de retención de litigio comienzan con las letras lit. Podemos recuperar la misma información con este comando:

Get-Mailbox -Identity "Ken Myer" | Format-List DisplayName, Lit*

Este comando indica a Get-Mailbox que recupere el valor de la propiedad DisplayName de Ken junto con los valores de las propiedades que tienen nombres que comienzan por las letras lit. Este es un ejemplo de lo que recuperamos:

DisplayName            : Ken Myer
LitigationHoldEnabled  : False
LitigationHoldDate     :
LitigationHoldOwner    :
LitigationHoldDuration : Unlimited

Para devolver información sobre varios buzones, deje fuera el parámetro Identity . En este ejemplo se devuelven las propiedades DisplayName y LitigationHoldEnabled para todos los buzones:

Get-Mailbox -ResultSize unlimited | Format-Table DisplayName, LitigationHoldEnabled -Auto

En muchos casos, solo quiere ver un subconjunto de los buzones de correo. Por ejemplo, supongamos que se le pide que elabore una lista de todos los buzones que están en retención por juicio. Puede usar el cmdlet Where-Object junto con el cmdlet Get-Mailbox . El cmdlet Where-Object necesita una frase de filtro para indicar a Exchange Online PowerShell qué conjunto de buzones le interesan.

En su forma más sencilla, las frases de filtro usan la sintaxis "<PropertyName> -<ComparisonOperator> <PropertyValue>".

Algunos operadores de comparación de uso común son:

  • eq (es igual; no distingue mayúsculas de minúsculas)

  • ne (no es igual; no distingue mayúsculas de minúsculas)

  • gt (mayor que)

  • lt (menor que)

Para obtener una lista completa de los operadores de comparación, consulte Where-Object.

Los valores de <PropertyValue> dependen de la propiedad y pueden ser valores como cadenas, números, valores booleanos ( $True o $False), o ningún valor ( $Null). Los valores de texto con espacios requieren comillas alrededor del valor. Los valores numéricos, los valores booleanos y $Null no requieren comillas alrededor del valor.

Volviendo a nuestro ejemplo de todos los buzones a los que se ha asignado una suspensión por juicio, la frase de filtro es "LitigationHoldEnabled -eq $True":

  • El nombre de la propiedad es LitigationHoldEnabled.

  • El operador de comparación es eq.

  • El valor de propiedad que estamos buscando es $True.

Una vez que tenga la frase de filtro, puede construir la parte Where-Object del comando mediante esta sintaxis:

Get-Mailbox -ResultSize unlimited | Where-Object {$_.<Filter Phrase>}

Este es el comando de nuestro ejemplo:

Get-Mailbox -ResultSize unlimited | Where-Object {$_.LitigationHoldEnabled -eq $True}

Por otro ejemplo, supongamos que desea asegurarse de que todos los usuarios tienen habilitada la regla de correo no deseado. Este es un comando rápido para buscar los usuarios que no tienen habilitada esa regla:

Get-Mailbox -ResultSize unlimited | Get-MailboxJunkEmailConfiguration | Where-Object {$_.Enabled -eq $False}

Esto es solo un ejemplo. Si desea mostrar un conjunto de buzones en función de una configuración y no puede filtrar por esa configuración en el Centro de administración de Microsoft 365, siga estos pasos:

  1. Busque la propiedad mailbox que corresponde a la configuración que le interesa mediante la ejecución del comando Get-Mailbox -Identity "<MailboxIdentity" | Select-Object * para enumerar todas las propiedades de un buzón. <MailboxIdentity> es cualquier identificador único para el buzón (nombre, dirección de correo electrónico, alias, etc.)

  2. Construya el comando de PowerShell Office 365 de la siguiente manera:Get-Mailbox -ResultSize unlimited | Where-Object {$_.<PropertyName> -<ComparisonOperator> <PropertyValue>}