Get-InboxRule

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-03-29

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Get-InboxRule permet d'afficher les propriétés des règles de boîte de réception. Les règles de la boîte de réception sont utilisées pour traiter les messages de la boîte de réception à partir des conditions spécifiées et pour entreprendre des actions comme le déplacement d'un message vers un dossier spécifié ou la suppression d'un message.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Get-InboxRule [-Identity <InboxRuleIdParameter>] [-DescriptionTimeFormat <String>] [-DescriptionTimeZone <ExTimeZoneValue>] [-DomainController <Fqdn>] [-IncludeHidden <SwitchParameter>] [-Mailbox <MailboxIdParameter>]

Cet exemple récupère toutes les règles de boîte de réception de la boîte aux lettres Joe@Contoso.com.

Get-InboxRule -Mailbox Joe@Contoso.com

Cet exemple récupère la règle de boîte de réception ReceivedLastYear de la boîte aux lettres joe@Contoso.com qui utilise le paramètre ReceivedBeforeDate. Les paramètres DescriptionTimeFormat et DescriptionTimeZone permettent de spécifier, dans cet exemple, le format de l'heure et du fuseau horaire utilisés dans la propriété Description de la règle.

Get-InboxRule "ReceivedLastYear" -Mailbox joe@contoso.com -DescriptionTimeFormat "mm/dd/yyyy" -DescriptionTimeZone "Pacific Standard Time"

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir Entrée « Règles de la boîte de réception » dans la rubrique Autorisations des destinataires.

 

Paramètre Obligatoire Type Description

DescriptionTimeFormat

Facultatif

System.String

Le paramètre DescriptionTimeFormat spécifie le format dans lequel les dates sont renvoyées dans la description de la règle. Vous devez utiliser des paramètres de format d'heure standard, par exemple :

jj/mm/aaaa, où jj sont les deux chiffres du jour, mm les deux chiffres du mois et aaaa les quatre chiffres de l’année.

DescriptionTimeZone

Facultatif

Microsoft.Exchange.Data.Storage.Management.ExTimeZoneValue

Le paramètre DescriptionTimeZone spécifie le format dans lequel le fuseau horaire pour les valeurs d'heure est renvoyé dans la description de la règle. Utilisez un nom de fuseau horaire Microsoft Windows valide.

Vous pouvez utiliser l'interface de ligne de commande Windows PowerShell pour récupérer les noms des fuseaux horaires à partir du Registre, par exemple :

$timezone = Get-ChildItem "HKLM :\Software\Microsoft\Windows NT\CurrentVersion\Time zones" | For-Each {Get-ItemProperty $_.PSPath}; $timezone | Format-Table pschildname,display -auto

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.InboxRuleIdParameter

Le paramètre Identity spécifie l'identité d'une règle de boîte de réception.

IncludeHidden

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est réservé à l’usage interne chez Microsoft.

Mailbox

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Mailbox spécifie la boîte aux lettres à laquelle appartient la règle de boîte de réception. Vous pouvez utiliser l’une des valeurs suivantes :

  • GUID

  • Nom unique (DN)

  • Domaine\Compte

  • Nom d'utilisateur principal (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: