Set-SweepRule
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et paramètres peuvent être exclusifs à un environnement ou à l’autre.
Utilisez la cmdlet Set-SweepRule pour modifier les règles de rangement dans les boîtes aux lettres.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
Set-SweepRule
[-Identity] <SweepRuleIdParameter>
[-Confirm]
[-DestinationFolder <MailboxFolderIdParameter>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-ExceptIfFlagged <Boolean>]
[-ExceptIfPinned <Boolean>]
[-KeepForDays <Int32>]
[-KeepLatest <Int32>]
[-Mailbox <MailboxIdParameter>]
[-Name <String>]
[-Provider <String>]
[-Sender <RecipientIdParameter>]
[-SourceFolder <MailboxFolderIdParameter>]
[-SystemCategory <SystemCategoryType>]
[-WhatIf]
[<CommonParameters>]
Description
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
Set-SweepRule -Identity x2hlsdpGmUifjFgxxGIOJw== -KeepForDays 15 -ExceptIfPinned $true
Cet exemple modifie la règle existante qui a la valeur d’ID de règle x2hlsdpGmUifjFgxxGIOJw== avec la valeur spécifiée.
Paramètres
-Confirm
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le commutateur Confirme 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 applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DestinationFolder
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le paramètre DestinationFolder spécifie une action pour la règle De balayage qui déplace les messages vers le dossier spécifié. La syntaxe pour cela est MailboxID:\ParentFolder[\SubFolder].
Pour la valeur de MailboxID, vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la boîte aux lettres. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (UPN)
Les exemples de valeurs de ce paramètre sont john@contoso.com:\Unimportant ou John:\Inbox\Misc. La valeur par défaut est MailboxID:\Deleted Items.
Propriétés du paramètre
| Type: | MailboxFolderIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DomainController
Applicable : Exchange Server 2016, Exchange Server 2019
Ce paramètre est disponible uniquement dans Exchange 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 ».
Propriétés du paramètre
| Type: | Fqdn |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Enabled
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExceptIfFlagged
Applicable : Exchange Server 2016, Exchange Server 2019
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ExceptIfFlagged spécifie une exception pour la règle de rangement qui recherche les messages auxquels a été appliqué un indicateur de message. Les valeurs valides sont les suivantes :
- $true : l’action de règle n’est pas appliquée aux messages auxquels un indicateur de message est appliqué.
- $false : l’exception n’est pas utilisée.
Les valeurs d’indicateur de message classiques sont les suivantes :
- N’importe lequel
- Appel
- DoNotForward
- FollowUp
- ForYourInformation
- Transférer
- NoResponseNecessary
- Lire
- Répondre
- ReplyToAll
- Révision
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExceptIfPinned
Applicable : Exchange Server 2016, Exchange Server 2019
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre PinMessage spécifie une exception pour la règle de rangement qui recherche les messages épinglés. Les valeurs valides sont les suivantes :
- $true : l’action de règle n’est pas appliquée aux messages épinglés en haut de la boîte de réception.
- $false : l’exception n’est pas utilisée.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le paramètre Identity permet de définir la règle de rangement à modifier. Vous pouvez utiliser une valeur quelconque qui identifie distinctement la règle. Par exemple :
- propriété RuleId (par exemple, x2hlsdpGmUifjFgxxGIOJw==).
- Exchange Online :
MailboxAlias\RuleID(par exemple,rzaher\2hlsdpGmUifjFgxxGIOJw==). - Exchange local :
MailboxCanonicalName\RuleID(par exemple,contoso.com/Users/Rick Zaher\x2hlsdpGmUifjFgxxGIOJw==).
Vous pouvez obtenir ces valeurs d’identité en utilisant la cmdlet Get-SweepRule.
Propriétés du paramètre
| Type: | SweepRuleIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-KeepForDays
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le paramètre KeepForDays spécifie une action pour la règle Sweep qui spécifie le nombre de jours pendant lesquels conserver les messages qui correspondent aux conditions de la règle. Une fois que le nombre de jours s’est écoulé, les messages sont déplacés vers l’emplacement spécifié par le paramètre DestinationFolder (par défaut, le dossier Éléments supprimés).
Vous ne pouvez pas utiliser ce paramètre avec le paramètre KeepLatest et la règle de rangement doit contenir une valeur KeepForDays ou KeepLatest.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-KeepLatest
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le paramètre KeepLatest spécifie une action pour la règle Sweep qui spécifie le nombre de messages à conserver qui correspondent aux conditions de la règle. Une fois le nombre de messages dépassé, les messages les plus anciens sont déplacés vers l’emplacement spécifié par le paramètre DestinationFolder (par défaut, le dossier Éléments supprimés).
Vous ne pouvez pas utiliser ce paramètre avec le paramètre KeepForDays et la règle de rangement doit contenir une valeur KeepForDays ou KeepLatest.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Mailbox
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le paramètre Mailbox spécifie la boîte aux lettres contenant la règle que vous voulez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (UPN)
Propriétés du paramètre
| Type: | MailboxIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le paramètre Name spécifie le nom de la règle de rangement. Si la valeur contient des espaces, mettez le nom entre guillemets.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Provider
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le paramètre Provider spécifie le fournisseur pour la règle Sweep. Si la valeur contient des espaces, mettez le nom entre guillemets.
Pour les règles de balayage que vous créez dans Outlook sur le web, la valeur par défaut est Exchange16.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Sender
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le paramètre Sender spécifie une condition qui recherche l’expéditeur spécifié dans les messages pour la règle de rangement. Pour les expéditeurs internes, vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique l’expéditeur. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Nom unique canonique
- GUID
Pour les expéditeurs externes, utilisez leur adresse de messagerie.
Propriétés du paramètre
| Type: | RecipientIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SourceFolder
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le paramètre SourceFolder spécifie une condition pour la règle Sweep qui recherche les messages dans le dossier spécifié. La syntaxe pour cela est MailboxID:\ParentFolder[\SubFolder].
Pour la valeur de MailboxID, vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la boîte aux lettres. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (UPN)
Les exemples de valeurs de ce paramètre sont john@contoso.com:\Marketing ou John:\Inbox\Reports. La valeur par défaut est MailboxID:\Inbox.
Propriétés du paramètre
| Type: | MailboxFolderIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SystemCategory
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
Le paramètre SystemCategory spécifie une condition pour la règle de balayage qui recherche les messages avec la catégorie système spécifiée. Les catégories système sont disponibles pour toutes les boîtes aux lettres de l’organisation. Les valeurs valides sont les suivantes :
- NotDefined
- Factures
- Document
- DocumentPlus
- Événement
- Famille
- Fichier
- Vol
- FromContact
- Importante
- LiveView
- Hébergement
- MailingList
- Bulletin d’informations
- Photo
- Achat
- RentalCar
- RestaurantReservation
- RetiredPromotion
- ShippingNotification
- Achats
- SocialUpdate
- Voyager
- Vidéo
Propriétés du paramètre
| Type: | SystemCategoryType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.