New-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 New-InboxRule permet de créer des règles de boîte de réception dans des boîtes aux lettres. Les règles de boîte de réception traitent les messages de la boîte de réception à partir des conditions et entreprennent des actions comme le déplacement d’un message vers un dossier spécifié ou la suppression d’un message.

Vous devez disposer des autorisations appropriées sur la boîte aux lettres pour créer une règle de boîte de réception.

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

New-InboxRule -Name <String> [-ApplyCategory <MultiValuedProperty>] [-ApplySystemCategory <MultiValuedProperty>] [-BodyContainsWords <MultiValuedProperty>] [-CopyToFolder <MailboxFolderIdParameter>] [-DeleteMessage <$true | $false>] [-DeleteSystemCategory <MultiValuedProperty>] [-ExceptIfBodyContainsWords <MultiValuedProperty>] [-ExceptIfFlaggedForAction <String>] [-ExceptIfFrom <RecipientIdParameter[]>] [-ExceptIfFromAddressContainsWords <MultiValuedProperty>] [-ExceptIfHasAttachment <$true | $false>] [-ExceptIfHasClassification <MessageClassificationIdParameter[]>] [-ExceptIfHeaderContainsWords <MultiValuedProperty>] [-ExceptIfMessageTypeMatches <AutomaticReply | AutomaticForward | Encrypted | Calendaring | CalendaringResponse | PermissionControlled | Voicemail | Signed | ApprovalRequest | ReadReceipt | NonDeliveryReport>] [-ExceptIfMyNameInCcBox <$true | $false>] [-ExceptIfMyNameInToBox <$true | $false>] [-ExceptIfMyNameInToOrCcBox <$true | $false>] [-ExceptIfMyNameNotInToBox <$true | $false>] [-ExceptIfReceivedAfterDate <ExDateTime>] [-ExceptIfReceivedBeforeDate <ExDateTime>] [-ExceptIfRecipientAddressContainsWords <MultiValuedProperty>] [-ExceptIfSentOnlyToMe <$true | $false>] [-ExceptIfSentTo <RecipientIdParameter[]>] [-ExceptIfSubjectContainsWords <MultiValuedProperty>] [-ExceptIfSubjectOrBodyContainsWords <MultiValuedProperty>] [-ExceptIfWithImportance <Low | Normal | High>] [-ExceptIfWithinSizeRangeMaximum <ByteQuantifiedSize>] [-ExceptIfWithinSizeRangeMinimum <ByteQuantifiedSize>] [-ExceptIfWithSensitivity <Normal | Personal | Private | CompanyConfidential>] [-FlaggedForAction <String>] [-ForwardAsAttachmentTo <RecipientIdParameter[]>] [-ForwardTo <RecipientIdParameter[]>] [-From <RecipientIdParameter[]>] [-FromAddressContainsWords <MultiValuedProperty>] [-HasAttachment <$true | $false>] [-HasClassification <MessageClassificationIdParameter[]>] [-HeaderContainsWords <MultiValuedProperty>] [-MarkAsRead <$true | $false>] [-MarkImportance <Low | Normal | High>] [-MessageTypeMatches <AutomaticReply | AutomaticForward | Encrypted | Calendaring | CalendaringResponse | PermissionControlled | Voicemail | Signed | ApprovalRequest | ReadReceipt | NonDeliveryReport>] [-MoveToFolder <MailboxFolderIdParameter>] [-MyNameInCcBox <$true | $false>] [-MyNameInToBox <$true | $false>] [-MyNameInToOrCcBox <$true | $false>] [-MyNameNotInToBox <$true | $false>] [-PinMessage <$true | $false>] [-Priority <Int32>] [-ReceivedAfterDate <ExDateTime>] [-ReceivedBeforeDate <ExDateTime>] [-RecipientAddressContainsWords <MultiValuedProperty>] [-RedirectTo <RecipientIdParameter[]>] [-SendTextMessageNotificationTo <MultiValuedProperty>] [-SentOnlyToMe <$true | $false>] [-SentTo <RecipientIdParameter[]>] [-StopProcessingRules <$true | $false>] [-SubjectContainsWords <MultiValuedProperty>] [-SubjectOrBodyContainsWords <MultiValuedProperty>] [-WithImportance <Low | Normal | High>] [-WithinSizeRangeMaximum <ByteQuantifiedSize>] [-WithinSizeRangeMinimum <ByteQuantifiedSize>] [-WithSensitivity <Normal | Personal | Private | CompanyConfidential>] <COMMON PARAMETERS>

New-InboxRule -FromMessageId <MailboxStoreObjectIdParameter> -ValidateOnly <SwitchParameter> <COMMON PARAMETERS>

COMMON PARAMETERS: [-AlwaysDeleteOutlookRulesBlob <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptIfFromSubscription <AggregationSubscriptionIdentity[]>] [-Force <SwitchParameter>] [-FromSubscription <AggregationSubscriptionIdentity[]>] [-Mailbox <MailboxIdParameter>] [-WhatIf [<SwitchParameter>]]

Cet exemple fait passer l’importance du message à High si le nom du propriétaire de la boîte aux lettres est indiqué dans le champ À. En outre, le message est marqué pour action.

New-InboxRule "CheckActionRequired" -MyNameInToBox $true -FlaggedForAction Any -MarkImportance "High"

importantImportant :
Lorsque vous créez, modifiez, supprimez, activez ou désactivez une règle de boîte de réception dans Exchange PowerShell, les règles côté client créées par MicrosoftOutlook sont supprimées.

Les paramètres utilisés pour les conditions ont également des paramètres d’exception correspondants. Lorsque les conditions spécifiées dans une exception sont remplies, la règle n’est pas appliquée au message. Les paramètres d’exception commencent par ExceptIf. Par exemple, le paramètre d’exception de SubjectOrBodyContainsWords est ExceptIfSubjectOrBodyContainsWords.

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

FromMessageId

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxStoreObjectIdParameter

Le paramètre FromMessageId spécifie le message utilisé pour créer la règle de boîte de réception. La règle est basée sur les propriétés du message. Vous identifiez le message à sa valeur de propriété codée en Base64 StoreObjectId. Par exemple :

  • MailboxId\StoreObjectId

  • StoreObjectId

Lorsque vous utilisez ce paramètre pour créer une règle de boîte de réception, les propriétés de message suivantes sont utilisées dans la règle :

  • Subject   L’objet du message est ajouté à la condition SubjectContainsWords.

  • From   L’expéditeur du message est ajouté à la condition From.

  •  To et Cc   Les destinataires des champs À et Cc sont ajoutés à la condition SentTo.

Name

Obligatoire

System.String

Le paramètre Name spécifie le nom de la règle de boîte de réception. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, mettez le nom entre guillemets (").

ValidateOnly

Obligatoire

System.Management.Automation.SwitchParameter

Le commutateur ValidateOnly indique à la cmdlet d’évaluer les conditions et exigences nécessaires pour effectuer l’opération et signale ensuite si l’opération réussit ou échoue. Aucune modification n’est effectuée lorsque le commutateur ValidateOnly est utilisé.

AlwaysDeleteOutlookRulesBlob

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre AlwaysDeleteOutlookRulesBlob supprime un avertissement que les utilisateurs finals ou les administrateurs reçoivent s’ils utilisent Outlook Web App ou Windows PowerShell pour modifier des règles de boîte de réception.

ApplyCategory

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ApplyCategory spécifie une action de la règle de boîte de réception qui applique la catégorie spécifiée aux messages. Une valeur valide est n’importe quelle valeur de texte que vous voulez définir en tant que catégorie. Vous pouvez spécifier plusieurs catégories séparées par des virgules. Si la valeur contient des espaces, placez-la entre guillemets (").

Les catégories que vous spécifiez pour ce paramètre sont définies dans la boîte aux lettres (elles ne sont pas partagées entre les boîtes aux lettres).

ApplySystemCategory

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ApplySystemCategory spécifie une action pour la règle de boîte de réception qui applique la catégorie système spécifiée aux messages. Les catégories système sont disponibles pour toutes les boîtes aux lettres de l’organisation. Les valeurs valides sont les suivantes :

  • NotDefined

  • Bills

  • Document

  • DocumentPlus

  • Event

  • Family

  • File

  • Flight

  • FromContact

  • Important

  • LiveView

  • Lodging

  • MailingList

  • Newsletter

  • Photo

  • Purchase

  • RentalCar

  • RestaurantReservation

  • RetiredPromotion

  • ShippingNotification

  • Shopping

  • SocialUpdate

  • Travel

  • Video

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

BodyContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre BodyContainsWords spécifie une condition de la règle de boîte de réception qui recherche les mots ou expressions spécifiés dans le corps des messages.

Si l’expression contient des espaces, vous devez placer la valeur entre guillemets. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre d’exception correspondant à cette condition est ExceptIfBodyContainsWords.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

CopyToFolder

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxFolderIdParameter

Le paramètre CopyToFolder spécifie une action de la règle de boîte de réception qui copie les messages vers le dossier de boîte aux lettres spécifié. Vous pouvez préciser le dossier existant en indiquant son nom ou l’ID d’objet du dossier, ainsi qu’une chaîne de chemin d’accès (par exemple, \Inbox\Personal).

DeleteMessage

Facultatif

System.Boolean

Le paramètre DeleteMessage spécifie une action de la règle de boîte de réception qui envoie des messages vers le dossier Éléments supprimés. Les valeurs valides sont les suivantes :

  • $true   Les messages qui répondent aux conditions de la règle sont déplacés vers le dossier Éléments supprimés.

  • $false   L’action n’est pas utilisée.

DeleteSystemCategory

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre DeleteSystemCategory spécifie une action de la règle de boîte de réception qui supprime la catégorie système spécifiée des messages. Les catégories système sont disponibles pour toutes les boîtes aux lettres de l’organisation. Les valeurs valides sont les suivantes :

  • NotDefined

  • Bills

  • Document

  • DocumentPlus

  • Event

  • Family

  • File

  • Flight

  • FromContact

  • Important

  • LiveView

  • Lodging

  • MailingList

  • Newsletter

  • Photo

  • Purchase

  • RentalCar

  • RestaurantReservation

  • RetiredPromotion

  • ShippingNotification

  • Shopping

  • SocialUpdate

  • Travel

  • Video

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

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.

ExceptIfBodyContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ExceptIfBodyContainsWords spécifie une exception à la règle de boîte de réception qui recherche les mots ou expressions spécifiés dans le corps des messages.

Si l’expression contient des espaces, vous devez placer la valeur entre guillemets. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre de condition correspondant à cette exception est BodyContainsWords.

ExceptIfFlaggedForAction

Facultatif

System.String

Le paramètre ExceptIfFlaggedForAction spécifie une exception à la règle de boîte de réception qui recherche les messages comportant l’indicateur de message spécifié. Les valeurs valides sont les suivantes :

  • Any

  • Call

  • DoNotForward

  • FollowUp

  • ForYourInformation

  • Forward

  • NoResponseNecessary

  • Read

  • Reply

  • ReplyToAll

  • Review

Le paramètre de condition correspondant à cette exception est FlaggedForAction.

ExceptIfFrom

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre ExceptIfFrom spécifie une condition de la règle de boîte de réception qui recherche l’expéditeur spécifié dans les messages. Vous pouvez utiliser n’importe quelle valeur qui identifie l’expéditeur de manière unique. Par exemple :

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • Adresse de messagerie

  • GUID

Vous pouvez spécifier plusieurs expéditeurs séparés par des virgules.

Le paramètre de condition correspondant à cette exception est From.

ExceptIfFromAddressContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ExceptIfFromAddressContainsWords spécifie une exception à la règle de boîte de réception qui recherche les messages pour lesquels les mots spécifiés sont dans l’adresse e-mail de l’expéditeur.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre de condition correspondant à cette exception est FromAddressContainsWords.

ExceptIfFromSubscription

Facultatif

Microsoft.Exchange.Transport.Sync.Common.Subscription.AggregationSubscriptionIdentity[]

Ce paramètre est disponible uniquement dans le service informatique.

Le paramètre ExceptIfFromSubscription spécifie une exception à la règle de boîte de réception qui recherche les messages reçus à partir des abonnements (par exemple, les abonnements POP ou IMAP). Vous pouvez identifier l’abonnement en utilisant la cmdlet Get-Subscription.

Le paramètre de condition correspondant à cette exception est FromSubscription.

ExceptIfHasAttachment

Facultatif

System.Boolean

Le paramètre ExceptIfHasAttachment spécifie une exception à la règle de boîte de réception qui recherche les messages contenant des pièces jointes. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle ne s’applique pas aux messages qui ont une pièce jointe.

  • $false   L’exception n’est pas utilisée.

Le paramètre de condition correspondant à cette exception est HasAttachment.

ExceptIfHasClassification

Facultatif

Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter[]

Le paramètre ExceptIfHasClassification spécifie une exception à la règle de boîte de réception qui recherche les messages ayant la classification de message spécifiée. Vous pouvez trouver des classifications de message à l’aide de la cmdlet Get-MessageClassification. Vous pouvez spécifier plusieurs classifications de messages séparées par des virgules.

Le paramètre de condition correspondant à cette exception est HasClassification.

ExceptIfHeaderContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre HeaderContainsWords spécifie une exception à la règle de boîte de réception qui recherche les mots ou expressions spécifiés dans le champ d’en-tête des messages.

Si l’expression contient des espaces, vous devez placer la valeur entre guillemets. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre de condition correspondant à cette exception est HeaderContainsWords.

ExceptIfMessageTypeMatches

Facultatif

Microsoft.Exchange.Data.Storage.InboxRuleMessageType

Le paramètre ExceptIfMessageTypeMatches spécifie une exception à la règle de boîte de réception qui recherche les messages du type spécifié. Les valeurs valides sont les suivantes :

  • AutomaticReply

  • AutomaticForward

  • Encrypted

  • Calendaring

  • CalendaringResponse

  • PermissionControlled

  • Voicemail

  • Signed

  • ApprovalRequest

  • ReadReceipt

  • NonDeliveryReport

Le paramètre de condition correspondant à cette exception est MessageTypeMatches.

ExceptIfMyNameInCcBox

Facultatif

System.Boolean

Le paramètre ExceptIfMyNameInCcBox spécifie une exception à la règle de boîte de réception qui recherche les messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ Cc. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle ne s’applique pas aux messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ Cc.

  • $false   L’exception n’est pas utilisée.

Le paramètre de condition correspondant à cette exception est MyNameInCcBox.

ExceptIfMyNameInToBox

Facultatif

System.Boolean

Le paramètre ExceptIfMyNameInToBox spécifie une exception à la règle de boîte de réception qui recherche les messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ À. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle ne s’applique pas aux messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ À.

  • $false   L’exception n’est pas utilisée.

Le paramètre de condition correspondant à cette exception est MyNameInToBox.

ExceptIfMyNameInToOrCcBox

Facultatif

System.Boolean

Le paramètre ExceptIfMyNameInToOrCcBox spécifie une exception à la règle de boîte de réception qui recherche les messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ À ou Cc. Les valeurs valides sont :

  • $true   L’action de la règle ne s’applique pas aux messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ À ou Cc.

  • $false   L’exception n’est pas utilisée.

Le paramètre de condition correspondant à cette exception est MyNameInToOrCcBox.

ExceptIfMyNameNotInToBox

Facultatif

System.Boolean

Le paramètre ExceptIfMyNameNotInToBox spécifie une exception à la règle de boîte de réception qui recherche les messages pour lesquels le propriétaire de la boîte aux lettres n’est pas indiqué dans le champ À. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle ne s’applique pas aux messages pour lesquels le propriétaire de la boîte aux lettres n’est pas indiqué dans le champ À.

  • $false   L’exception n’est pas utilisée.

Le paramètre de condition correspondant à cette exception est MyNameNotInToBox.

ExceptIfReceivedAfterDate

Facultatif

Microsoft.Exchange.ExchangeSystem.ExDateTime

Le paramètre ExceptIfReceivedAfterDate spécifie une exception à la règle de boîte de réception qui recherche les messages reçus après la date spécifiée.

Utilisez le format de date courte qui est défini dans les paramètres Options régionales de l’ordinateur sur lequel vous exécutez la commande. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte dd/mm/yyyy, entrez 01/09/2015 pour spécifier le 1er septembre 2015. Vous pouvez entrer la date uniquement, ou la date et l’heure de la journée. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets («  »), par exemple « 01/09/2015 17:00 ».

Le paramètre de condition correspondant à cette exception est ReceivedAfterDate.

ExceptIfReceivedBeforeDate

Facultatif

Microsoft.Exchange.ExchangeSystem.ExDateTime

Le paramètre ExceptIfReceivedBeforeDate spécifie une exception à la règle de boîte de réception qui recherche les messages reçus avant la date spécifiée.

Utilisez le format de date courte qui est défini dans les paramètres Options régionales de l’ordinateur sur lequel vous exécutez la commande. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte dd/mm/yyyy, entrez 01/09/2015 pour spécifier le 1er septembre 2015. Vous pouvez entrer la date uniquement, ou la date et l’heure de la journée. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets («  »), par exemple « 01/09/2015 17:00 ».

Le paramètre de condition correspondant à cette exception est ReceivedBeforeDate.

ExceptIfRecipientAddressContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ExceptIfRecipientAddressContainsWords spécifie une exception à la règle de boîte de réception qui recherche les messages pour lesquels les mots spécifiés sont dans les adresses e-mail des destinataires.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre de condition correspondant à cette exception est RecipientAddressContainsWords.

ExceptIfSentOnlyToMe

Facultatif

System.Boolean

Le paramètre ExceptIfSentOnlyToMe spécifie une exception à la règle de boîte de réception qui recherche les messages pour lesquels le seul destinataire est le propriétaire de la boîte aux lettres. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle ne s’applique pas aux messages pour lesquels le seul destinataire est le propriétaire de la boîte aux lettres.

  • $false   L’exception n’est pas utilisée.

Le paramètre de condition correspondant à cette exception est SentOnlyToMe.

ExceptIfSentTo

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre ExceptIfSentTo spécifie une exception qui recherche les destinataires dans les messages. Vous pouvez utiliser une valeur quelconque qui identifie le destinataire. Par exemple :

  • Nom

  • Nom unique (DN)

  • Nom complet

  • Adresse de messagerie

  • GUID

Pour saisir plusieurs valeurs, utilisez la syntaxe suivante : <value1>,<value2>,...<valueX>. Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>",..."<valueX>".

Le paramètre de condition correspondant à cette exception est SentTo.

ExceptIfSubjectContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ExceptIfSubjectContainsWords spécifie une exception à la règle de boîte de réception qui recherche les mots ou expressions spécifiés dans le champ Objet des messages.

Si l’expression contient des espaces, vous devez placer la valeur entre guillemets. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre de condition correspondant à cette exception est SubjectContainsWords.

ExceptIfSubjectOrBodyContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ExceptIfSubjectOrBodyContainsWords spécifie une exception à la règle de boîte de réception qui recherche les mots ou expressions spécifiés dans le champ Objet ou le corps des messages.

Si l’expression contient des espaces, vous devez placer la valeur entre guillemets. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre de condition correspondant à cette exception est ExceptIfSubjectOrBodyContainsWords.

ExceptIfWithImportance

Facultatif

Microsoft.Exchange.Data.Storage.Importance

Le paramètre ExceptIfWithImportance spécifie une exception à la règle de boîte de réception qui recherche les messages avec le niveau d’importance spécifié. Les valeurs valides sont les suivantes :

  • High

  • Normal

  • Low

Le paramètre de condition correspondant à cette exception est WithImportance.

ExceptIfWithinSizeRangeMaximum

Facultatif

Microsoft.Exchange.Data.ByteQuantifiedSize

Le paramètre ExceptIfWithinSizeRangeMaximum spécifie une partie d’une exception à la règle de boîte de réception qui recherche les messages de taille plus petite que la taille maximale spécifiée.

Lorsque vous entrez une valeur, qualifiez-la à l’aide de l’une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

  • TB (téraoctets)

Les valeurs non qualifiées sont généralement traitées comme des octets, mais les petites valeurs peuvent être arrondies au kilo-octet le plus proche.

Vous devez utiliser ce paramètre avec le paramètre ExceptIfWithinSizeRangeMainimum, et la valeur de ce paramètre doit être supérieure à la valeur de ExceptIfWithinSizeRangeMinimum.

Le paramètre de condition correspondant à cette exception est WithinSizeRangeMaximum.

ExceptIfWithinSizeRangeMinimum

Facultatif

Microsoft.Exchange.Data.ByteQuantifiedSize

Le paramètre ExceptIfWithinSizeRangeMinimum spécifie une partie d’une exception à la règle de boîte de réception qui recherche les messages de taille plus grande que la taille minimale spécifiée.

Lorsque vous entrez une valeur, qualifiez-la à l’aide de l’une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

  • TB (téraoctets)

Les valeurs non qualifiées sont généralement traitées comme des octets, mais les petites valeurs peuvent être arrondies au kilo-octet le plus proche.

Vous devez utiliser ce paramètre avec le paramètre ExceptIfWithinSizeRangeMaximum, et la valeur de ce paramètre doit être inférieure à la valeur de ExceptIfWithinSizeRangeMaximum.

Le paramètre de condition correspondant à cette exception est WithinSizeRangeMinimum.

ExceptIfWithSensitivity

Facultatif

Microsoft.Exchange.Data.Storage.Sensitivity

Le paramètre ExceptIfWithSensitivity spécifie une exception qui recherche les messages avec le niveau de confidentialité spécifié. Les valeurs valides sont les suivantes :

  • Normal

  • Personal

  • Private

  • CompanyConfidential

Le paramètre de condition correspondant à cette exception est WithSensitivity.

FlaggedForAction

Facultatif

System.String

Le paramètre FlaggedForAction spécifie une condition de la règle de boîte de réception qui recherche les messages comportant l’indicateur de message spécifié. Les valeurs valides sont les suivantes :

  • Any

  • Call

  • DoNotForward

  • FollowUp

  • ForYourInformation

  • Forward

  • NoResponseNecessary

  • Read

  • Reply

  • ReplyToAll

  • Review

Force

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Force spécifie s’il faut supprimer les messages d’avertissement ou de confirmation. Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Un message de confirmation vous avertit si la boîte aux lettres contient des règles créées par Outlook, car toute règle côté client sera supprimée par les actions de cette cmdlet.

ForwardAsAttachmentTo

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre ForwardAsAttachmentTo spécifie une action de la règle de boîte de réception qui transfère le message au destinataire spécifié en tant que pièce jointe. Vous pouvez utiliser n’importe quelle valeur qui identifie le destinataire de manière unique.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • Adresse de messagerie

  • GUID

Vous pouvez spécifier plusieurs destinataires séparés par des virgules.

ForwardTo

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre ForwardTo spécifie une action de la règle de boîte de réception qui transfère le message au destinataire spécifié. Vous pouvez utiliser n’importe quelle valeur qui identifie le destinataire de manière unique.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • Adresse de messagerie

  • GUID

Vous pouvez spécifier plusieurs destinataires séparés par des virgules.

From

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre From spécifie une condition de la règle de boîte de réception qui recherche l’expéditeur spécifié dans les messages. Vous pouvez utiliser n’importe quelle valeur qui identifie l’expéditeur de manière unique.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • Adresse de messagerie

  • GUID

Vous pouvez spécifier plusieurs expéditeurs séparés par des virgules.

Le paramètre d’exception correspondant à cette condition est ExceptIfFrom.

FromAddressContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre FromAddressContainsWords spécifie une condition de la règle de boîte de réception qui recherche les messages pour lesquels les mots spécifiés sont dans l’adresse e-mail de l’expéditeur.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre d’exception correspondant à cette condition est ExceptIfFromAddressContainsWords.

FromSubscription

Facultatif

Microsoft.Exchange.Transport.Sync.Common.Subscription.AggregationSubscriptionIdentity[]

Ce paramètre est disponible uniquement dans le service informatique.

Le paramètre FromSubscription spécifie une condition de la règle de boîte de réception qui recherche les messages reçus à partir des abonnements (par exemple, les abonnements POP ou IMAP). Vous pouvez identifier l’abonnement en utilisant la cmdlet Get-Subscription.

Le paramètre d’exception correspondant à cette condition est ExceptIfFromSubscription.

HasAttachment

Facultatif

System.Boolean

Le paramètre HasAttachment spécifie une condition de la règle de boîte de réception qui recherche les messages contenant des pièces jointes. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle s’applique aux messages avec des pièces jointes.

  • $false   La condition n’est pas utilisée.

Le paramètre d’exception correspondant à cette condition est ExceptIfHasAttachment.

HasClassification

Facultatif

Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter[]

Le paramètre HasClassification spécifie une condition de la règle de boîte de réception qui recherche les messages ayant la classification de message spécifiée. Vous pouvez trouver des classifications de message à l’aide de la cmdlet Get-MessageClassification. Vous pouvez spécifier plusieurs classifications de messages séparées par des virgules.

Le paramètre d’exception correspondant à cette condition est ExceptIfHasClassification.

HeaderContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre HeaderContainsWords spécifie une condition de la règle de boîte de réception qui recherche les mots ou expressions spécifiés dans le champ d’en-tête des messages.

Si l’expression contient des espaces, vous devez placer la valeur entre guillemets. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre d’exception correspondant à cette condition est ExceptIfHeaderContainsWords.

Mailbox

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Mailbox indique la boîte aux lettres qui contient la règle de la boîte de réception. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la boîte aux lettres.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • <domain name>\<account name>

  • Adresse de messagerie

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

MarkAsRead

Facultatif

System.Boolean

Le paramètre MarkAsRead spécifie une action de la règle de boîte de réception qui marque les messages comme lus. Les valeurs valides sont les suivantes :

  • $true   Les messages qui répondent aux conditions de la règle sont marqués comme lus.

  • $false   L’action n’est pas utilisée.

MarkImportance

Facultatif

Microsoft.Exchange.Data.Storage.Importance

Le paramètre MarkImportance spécifie une action de la règle de boîte de réception qui marque les messages comportant l’indicateur d’importance spécifié. Les valeurs valides sont les suivantes :

  • Low

  • Normal

  • High

MessageTypeMatches

Facultatif

Microsoft.Exchange.Data.Storage.InboxRuleMessageType

Le paramètre MessageTypeMatches spécifie une condition de la règle de boîte de réception qui recherche les messages du type spécifié. Les valeurs valides sont les suivantes :

  • AutomaticReply

  • AutomaticForward

  • Encrypted

  • Calendaring

  • CalendaringResponse

  • PermissionControlled

  • Voicemail

  • Signed

  • ApprovalRequest

  • ReadReceipt

  • NonDeliveryReport

Le paramètre d’exception correspondant à cette condition est ExceptIfMessageTypeMatches.

MoveToFolder

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxFolderIdParameter

Le paramètre MoveToFolder spécifie une action de la règle de boîte de réception qui déplace les messages vers le dossier de boîte aux lettres spécifié. Vous pouvez préciser le dossier existant en indiquant son nom ou l’ID d’objet du dossier, ainsi qu’une chaîne de chemin d’accès (par exemple, \Inbox\Personal).

MyNameInCcBox

Facultatif

System.Boolean

Le paramètre MyNameInCcBox spécifie une condition de la règle de boîte de réception qui recherche les messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ Cc. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle s’applique aux messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ Cc.

  • $false   La condition n’est pas utilisée.

Le paramètre d’exception correspondant à cette condition est ExceptIfMyNameInCcBox.

MyNameInToBox

Facultatif

System.Boolean

Le paramètre MyNameInToBox spécifie une condition de la règle de boîte de réception qui recherche les messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ À. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle s’applique aux messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ À.

  • $false   La condition n’est pas utilisée.

Le paramètre d’exception correspondant à cette condition est ExceptIfMyNameInToBox.

MyNameInToOrCcBox

Facultatif

System.Boolean

Le paramètre MyNameInToOrCcBox spécifie une condition de la règle de boîte de réception qui recherche les messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ À ou Cc. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle s’applique aux messages pour lesquels le propriétaire de la boîte aux lettres est indiqué dans le champ À ou Cc.

  • $false   La condition n’est pas utilisée.

Le paramètre d’exception correspondant à cette condition est ExceptIfMyNameInToOrCcBox.

MyNameNotInToBox

Facultatif

System.Boolean

Le paramètre MyNameNotInToBox spécifie une condition de la règle de boîte de réception qui recherche les messages pour lesquels le propriétaire de la boîte aux lettres n’est pas indiqué dans le champ À. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle s’applique aux messages pour lesquels le propriétaire de la boîte aux lettres n’est pas indiqué dans le champ À.

  • $false   La condition n’est pas utilisée.

Le paramètre d’exception correspondant à cette condition est ExceptIfMyNameNotInToBox.

PinMessage

Facultatif

System.Boolean

Le paramètre PinMessage spécifie une action de la règle de boîte de réception qui épingle les messages en haut de la boîte de réception. Les valeurs valides sont les suivantes :

  • $true   Les messages qui répondent aux conditions de la règle sont épinglés en haut de la boîte de réception.

  • $false   L’action n’est pas utilisée.

Priority

Facultatif

System.Int32

Le paramètre Priority spécifie une priorité de la règle de boîte de réception qui détermine l’ordre de traitement des règles. Un nombre entier inférieur indique une priorité plus élevée,

ReceivedAfterDate

Facultatif

Microsoft.Exchange.ExchangeSystem.ExDateTime

Le paramètre ReceivedAfterDate spécifie une condition de la règle de boîte de réception qui recherche les messages reçus après la date spécifiée.

Utilisez le format de date courte qui est défini dans les paramètres Options régionales de l’ordinateur sur lequel vous exécutez la commande. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte dd/mm/yyyy, entrez 01/09/2015 pour spécifier le 1er septembre 2015. Vous pouvez entrer la date uniquement, ou la date et l’heure de la journée. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets («  »), par exemple « 01/09/2015 17:00 ».

Le paramètre d’exception correspondant à cette condition est ExceptIfReceivedAfterDate.

ReceivedBeforeDate

Facultatif

Microsoft.Exchange.ExchangeSystem.ExDateTime

Le paramètre ReceivedBeforeDate spécifie une condition de la règle de boîte de réception qui recherche les messages reçus avant la date spécifiée.

Utilisez le format de date courte qui est défini dans les paramètres Options régionales de l’ordinateur sur lequel vous exécutez la commande. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte dd/mm/yyyy, entrez 01/09/2015 pour spécifier le 1er septembre 2015. Vous pouvez entrer la date uniquement, ou la date et l’heure de la journée. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets («  »), par exemple « 01/09/2015 17:00 ».

Le paramètre d’exception correspondant à cette condition est ExceptIfReceivedBeforeDate.

RecipientAddressContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre RecipientAddressContainsWords spécifie une condition de la règle de boîte de réception qui recherche les messages pour lesquels les mots spécifiés sont dans les adresses e-mail des destinataires.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre d’exception correspondant à cette condition est ExceptIfRecipientAddressContainsWords.

RedirectTo

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre RedirectTo spécifie une action de la règle de boîte de réception qui redirige le message au destinataire spécifié. Vous pouvez utiliser n’importe quelle valeur qui identifie le destinataire de manière unique.

Par exemple :

  • Nom

  • Nom complet

  • Nom unique (DN)

  • Nom unique canonique

  • GUID

Vous pouvez spécifier plusieurs destinataires séparés par des virgules.

SendTextMessageNotificationTo

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre SendTextMessageNotificationTo spécifie une action de la règle de boîte de réception qui envoie une notification SMS au numéro de téléphone spécifié.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

SentOnlyToMe

Facultatif

System.Boolean

Le paramètre SentOnlyToMe spécifie une condition de la règle de boîte de réception qui recherche les messages pour lesquels le seul destinataire est le propriétaire de la boîte aux lettres. Les valeurs valides sont les suivantes :

  • $true   L’action de la règle s’applique aux messages pour lesquels le propriétaire de la boîte aux lettres est le seul destinataire.

  • $false   La condition n’est pas utilisée.

Le paramètre d’exception correspondant à cette condition est ExceptIfSentOnlyToMe.

SentTo

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre SentTo spécifie une condition de la règle de rangement qui recherche les messages comportant les destinataires spécifiés. Vous pouvez utiliser n’importe quelle valeur qui identifie le destinataire de manière unique.

Par exemple :

  • Nom

  • Nom complet

  • Nom unique (DN)

  • Nom unique canonique

  • GUID

Vous pouvez spécifier plusieurs destinataires séparés par des virgules.

Le paramètre d’exception correspondant à cette condition est ExceptIfSentTo.

StopProcessingRules

Facultatif

System.Boolean

Le paramètre StopProcessingRules spécifie une action de la règle de boîte de réception qui interrompt le traitement des règles supplémentaires si les conditions de cette règle de boîte de réception sont remplies. Les valeurs valides sont les suivantes : S’il est défini sur $true, le paramètre StopProcessingRules demande à Exchange d’arrêter le traitement des règles supplémentaires si les conditions de cette règle de boîte de réception sont remplies.

  • $true   Ne plus traiter de règles.

  • $false   L’action n’est pas utilisée (continuer à traiter d’autres règles après celle-ci).

SubjectContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre SubjectContainsWords spécifie une condition de la règle de boîte de réception qui recherche les mots ou expressions spécifiés dans le champ Objet des messages.

Si l’expression contient des espaces, vous devez placer la valeur entre guillemets. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre d’exception correspondant à cette condition est ExceptIfSubjectContainsWords.

SubjectOrBodyContainsWords

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre SubjectOrBodyContainsWords spécifie une condition de la règle de boîte de réception qui recherche les mots ou expressions spécifiés dans le champ Objet ou le corps des messages.

Si l’expression contient des espaces, vous devez placer la valeur entre guillemets. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Le paramètre d’exception correspondant à cette condition est ExceptIfSubjectOrBodyContainsWords.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

WithImportance

Facultatif

Microsoft.Exchange.Data.Storage.Importance

Le paramètre WithImportance spécifie une condition qui recherche les messages avec le niveau d’importance spécifié. Les valeurs valides sont les suivantes :

  • High

  • Normal

  • Low

Le paramètre d’exception correspondant à cette condition est ExceptIfWithImportance.

WithinSizeRangeMaximum

Facultatif

Microsoft.Exchange.Data.ByteQuantifiedSize

Le paramètre WithinSizeRangeMaximum spécifie une partie d’une condition de la règle de boîte de réception qui recherche les messages de taille plus petite que la taille maximale spécifiée.

Lorsque vous entrez une valeur, qualifiez-la à l’aide de l’une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

  • TB (téraoctets)

Les valeurs non qualifiées sont généralement traitées comme des octets, mais les petites valeurs peuvent être arrondies au kilo-octet le plus proche.

Vous devez utiliser ce paramètre avec le paramètre WithinSizeRangeMinimum, et la valeur de ce paramètre doit être supérieure à la valeur de WithinSizeRangeMinimum.

Le paramètre d’exception correspondant à cette condition est ExceptIfWithinSizeRangeMaximum.

WithinSizeRangeMinimum

Facultatif

Microsoft.Exchange.Data.ByteQuantifiedSize

Le paramètre WithinSizeRangeMinimum spécifie une partie d’une condition de la règle de boîte de réception qui recherche les messages de taille plus grande que la taille minimale spécifiée.

Lorsque vous entrez une valeur, qualifiez-la à l’aide de l’une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

  • TB (téraoctets)

Les valeurs non qualifiées sont généralement traitées comme des octets, mais les petites valeurs peuvent être arrondies au kilo-octet le plus proche.

Vous devez utiliser ce paramètre avec le paramètre WithinSizeRangeMaximum, et la valeur de ce paramètre doit être inférieure à la valeur de WithinSizeRangeMaximum.

Le paramètre d’exception correspondant à cette condition est ExceptIfWithinSizeRangeMinimum.

WithSensitivity

Facultatif

Microsoft.Exchange.Data.Storage.Sensitivity

Le paramètre WithSensitivity spécifie une condition de la règle de boîte de réception qui recherche les messages avec le niveau de confidentialité spécifié. Les valeurs valides sont les suivantes :

  • Normal

  • Personal

  • Private

  • CompanyConfidential

Le paramètre d’exception correspondant à cette condition est ExceptIfWithSensitivity.

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: