Utiliser Exchange Online PowerShell pour afficher des informations Microsoft 365 boîte aux lettres Office 365'utilisateur

Important

Consultez le nouveau centre d Exchange’administration ! L’expérience est moderne, intelligente, accessible et meilleure. Personnalisez votre tableau de bord, gérez la migration entre les locataires, découvrez la fonctionnalité Groupes améliorée, et bien plus encore. Essayez-le maintenant !

Les administrateurs peuvent apprendre à utiliser Exchange Online PowerShell pour afficher des informations sur les boîtes aux lettres dans leur Microsoft 365 ou Office 365 organisation.

Pour vous donner une idée de certaines des choses que vous pouvez faire avec PowerShell dans Microsoft 365 et Office 365, examinons les boîtes aux lettres utilisateur dans Exchange Online PowerShell.

Avant de commencer

Pour vous connecter à Exchange Online PowerShell, voir Connexion à Exchange Online PowerShell.

Affichage d'informations de boîte aux lettres avec Exchange Online PowerShell

Vous pouvez facilement obtenir des informations sur la boîte aux lettres d'un utilisateur, par exemple, voici une commande qui renvoie des informations sur les boîtes aux lettres de Ken Myer :

Get-Mailbox -Identity "Ken Myer"

Cette commande renverra un résultat semblable à celui-ci :

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

vous voyez l'alias et le quota de messagerie de Ken. Cependant, une boîte aux lettres Exchange Online offre bien plus d'informations que les quatre propriétés renvoyées par la cmdlet Get-Mailbox.

Voici un exemple de commande qui affiche toutes les informations pour une boîte aux lettres spécifique :

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

La commande indique à Exchange Online PowerShell de renvoyer toutes les propriétés disponibles pour la boîte aux lettres dans une liste. Il existe environ 200 propriétés et valeurs de propriétés différentes. Vous pouvez également utiliser les cmdlets Format-List et Format-Table pour renvoyer uniquement des valeurs de propriété spécifiques. Par exemple, vous pouvez également afficher les propriétés liées à la mise en attente pour litige concernant Ken Myer à l'aide de cette commande :

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

Vous pouvez également utiliser des caractères génériques lorsque vous utilisez la cmdlet Format-List. Par exemple, toutes les propriétés de la attente pour litige commencent par les lettres lit . Vous pouvez récupérer ces informations à l'aide de la commande suivante :

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

Cette commande indique à Get-Mailbox de récupérer la valeur de la propriété DisplayName de Ken, ainsi que les valeurs de toutes les propriétés dont les noms commencent par les lit lettres. Voici un exemple du résultat obtenu :

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

Vous pouvez renvoyer des informations sur plusieurs boîtes aux lettres en laissant dehors le paramètre Identity. Cet exemple renvoie les propriétés DisplayName et LitigationHoldEnabled pour toutes les boîtes aux lettres :

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

Dans de nombreux cas, vous souhaitez uniquement examiner un sous-ensemble de vos boîtes aux lettres. Supposons que l'on vous demande d'obtenir une liste de toutes les boîtes aux lettres qui ont été mises en conservation pour litige. Vous pouvez utiliser la cmdlet Where-Object avec la cmdlet Get-Mailbox. La cmdlet Where-Object a besoin d'une expression de filtre pour indiquer à Exchange Online PowerShell l'ensemble de boîtes aux lettres qui vous intéresse.

Dans leur forme la plus simple, les expressions de filtre utilisent la syntaxe "<PropertyName> -<ComparisonOperator> <PropertyValue>" .

Voici quelques opérateurs de comparaison fréquemment utilisés :

  • eq (égal, ne respecte pas la casse)

  • ne (différent de, ne respecte pas la casse)

  • gt (supérieur à)

  • lt (inférieur à)

Pour obtenir la liste complète des opérateurs de comparaison, reportez-vous à Where-Object.

Les valeurs de la propriété dépendent de la propriété et peuvent être des valeurs telles que des chaînes, des nombres, des valeurs boolé communes <PropertyValue> $True (ou $False ) ou aucune valeur ( $Null ). Des guillemets doivent être placés autour des valeurs de texte avec des espaces. Les valeurs numériques, les valeurs boolé suivantes ne $Null nécessitent pas de guillemets autour de la valeur.

Pour revenir à notre exemple de toutes les boîtes aux lettres pour litige, l’expression de filtre est la suivante "LitigationHoldEnabled -eq $True" :

  • Le nom de la propriété LitigationHoldEnabled est .

  • L’opérateur de comparaison eq est .

  • La valeur de propriété que nous recherchons est $True .

Une fois que vous avez l'expression de filtre, vous pouvez créer la partie Where-Object de la commande à l'aide de la syntaxe suivante :

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

Voici la commande pour notre exemple :

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

Voici un autre exemple : supposons que vous souhaitiez vous assurer que tous vos utilisateurs ont activé la règle de courrier indésirable. Voici une commande rapide permettant de trouver les utilisateurs qui n'ont pas activé cette règle :

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

Il s’agit simplement d’un exemple. Si vous souhaitez afficher un ensemble de boîtes aux lettres en fonction d’un paramètre et que vous ne pouvez pas filtrer ce paramètre dans le Centre d'administration Microsoft 365, faites les étapes suivantes :

  1. Recherchez la propriété de boîte aux lettres qui correspond au paramètre qui vous intéresse en exécutant la commande de liste de toutes les propriétés Get-Mailbox -Identity "<MailboxIdentity" | Select-Object * d’une boîte aux lettres. <MailboxIdentity> est un identificateur unique pour la boîte aux lettres (nom, adresse de messagerie, alias, etc.)

  2. Construisez votre Office 365 PowerShell comme ceci :Get-Mailbox -ResultSize unlimited | Where-Object {$_.<PropertyName> -<ComparisonOperator> <PropertyValue>}