Set-MailboxSearch

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-12-20

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 Set-MailboxSearch permet de modifier une recherche de boîte aux lettres existante.

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

Set-MailboxSearch -Identity <EwsStoreObjectIdParameter> [-AllPublicFolderSources <$true | $false>] [-AllSourceMailboxes <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DomainController <Fqdn>] [-EndDate <ExDateTime>] [-EstimateOnly <$true | $false>] [-ExcludeDuplicateMessages <$true | $false>] [-Force <SwitchParameter>] [-IncludeKeywordStatistics <SwitchParameter>] [-IncludeUnsearchableItems <$true | $false>] [-InPlaceHoldEnabled <$true | $false>] [-ItemHoldPeriod <Unlimited>] [-Language <String>] [-LogLevel <Suppress | Basic | Full>] [-MessageTypes <KindKeyword[]>] [-Name <String>] [-PublicFolderSources <PublicFolderIdParameter[]>] [-Recipients <String[]>] [-SearchQuery <String>] [-Senders <String[]>] [-SourceMailboxes <RecipientIdParameter[]>] [-StartDate <ExDateTime>] [-StatisticsStartIndex <Int32>] [-StatusMailRecipients <RecipientIdParameter[]>] [-TargetMailbox <MailboxIdParameter>] [-WhatIf [<SwitchParameter>]]

Cet exemple modifie la date de début d'une recherche de boîte aux lettres.

Set-MailboxSearch -Identity "Legal-ProjectX" -StartDate "01/01/2010"

Dans les instances Exchange locales et Exchange Online, les recherches de boîtes aux lettres sont utilisées pour la conservation inaltérable et la découverte électronique inaltérable. Pour la découverte électronique inaltérable, sauf indication contraire, les boîtes aux lettres se trouvant sur tous les serveurs de boîtes aux lettres d’une organisation peuvent faire l’objet d’une recherche. Pour créer une conservation inaltérable, vous devez spécifier les boîtes aux lettres à placer en attente à l’aide du paramètre SourceMailboxes. La recherche peut être arrêtée, démarrée, modifiée et supprimée.

importantImportant :
Cette cmdlet n’effectue pas de recherche de boîtes aux lettres sur des serveurs de boîtes aux lettres Exchange Server 2010. Pour effectuer des recherches dans ces boîtes aux lettres, exécutez la commande sur un serveur Exchange 2010.
CautionAttention :
Les recherches de boîte aux lettres sont effectuées sur tous les serveurs de boîtes aux lettres d’une organisation Exchange, sauf si vous limitez la recherche à un nombre réduit de boîtes aux lettres à l’aide du paramètre SourceMailboxes.
Si la recherche de découverte électronique locale à modifier est en cours d'exécution, arrêtez-la avant d'utiliser la cmdlet Set-MailboxSearch. Lorsque vous redémarrez une recherche, les résultats de la recherche précédente sont supprimés de la boîte aux lettres cible.

Pour plus d'informations, consultez les rubriques Découverte électronique inaltérable dans Exchange 2016 et Conservation inaltérable et conservation pour litige dans Exchange 2016.

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 les entrées « Découverte électronique locale » et « Archive permanente » dans la rubrique Stratégie de messagerie et autorisations de conformité dans Exchange 2016.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.EwsStoreObjectIdParameter

Le paramètre Identity spécifie le nom de la recherche de boîte aux lettres.

AllPublicFolderSources

Facultatif

System.Boolean

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

AllSourceMailboxes

Facultatif

System.Boolean

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

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.

Description

Facultatif

System.String

Le paramètre Description spécifie des paramètres régionaux pour la recherche.

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.

EndDate

Facultatif

Microsoft.Exchange.ExchangeSystem.ExDateTime

Le paramètre EndDate indique la fin de la plage de dates définies.

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 ».

EstimateOnly

Facultatif

System.Boolean

Le paramètre EstimateOnly précise que seule une estimation du nombre d'éléments à renvoyer est fournie. Les messages ne sont pas copiés dans la boîte aux lettres cible.

ExcludeDuplicateMessages

Facultatif

System.Boolean

Le paramètre ExcludeDuplicateMessages élimine la duplication des messages entre boîtes aux lettres dans une recherche électronique locale.

Force

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Force supprime l'affichage d'une boîte de confirmation avant la modification d'une recherche. Lorsque vous modifiez une recherche, les résultats de la recherche précédente sont supprimés de la boîte aux lettres cible et la recherche est redémarrée après modification. Le commutateur Force ne nécessite aucune valeur.

IncludeKeywordStatistics

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur IncludeKeywordStatistics indique que la commande génère et renvoie des statistiques sur les mots clés pour la recherche.

IncludeUnsearchableItems

Facultatif

System.Boolean

Le paramètre IncludeUnsearchableItems indique si les éléments impossibles à rechercher sont inclus dans les résultats de la recherche. Si cette option est définie sur $true, les éléments impossibles à rechercher sont inclus dans les résultats de la recherche.

CautionAttention :
Les éléments impossibles à rechercher ne sont pas mis en attente pour une conservation inaltérable basée sur des requêtes. Si vous devez mettre des éléments impossibles à rechercher en attente, vous devez créer une conservation pour une durée indéterminée (c’est-à-dire, une conservation sans paramètre de recherche, ce qui offre une fonctionnalité semblable à la conservation pour litige dans Exchange 2010).

InPlaceHoldEnabled

Facultatif

System.Boolean

Le paramètre InPlaceHoldEnabled indique si une archive permanente doit être placée sur des éléments correspondant à la requête de recherche. Définissez le paramètre sur $true pour activer l'archive permanente. Si le paramètre ItemHoldPeriod n'est pas spécifié, les éléments sont mis en attente jusqu'à la suppression de la mise en attente en supprimant la recherche ou une boîte aux lettres de la recherche. Vous pouvez ajouter ou supprimer des boîtes aux lettres d'une recherche de boîtes aux lettres en modifiant le paramètre SourceMailboxes. Si vous ne spécifiez pas de requête de recherche, toutes les boîtes aux lettres spécifiées sont mises en suspens.

importantImportant :
Si vous essayez de placer une boîte aux lettres en attente, mais que vous ne spécifiez pas de boîtes aux lettres à l’aide du paramètre SourceMailboxes, la commande peut aboutir, mais les boîtes aux lettres ne sont pas placées en conservation inaltérable.

ItemHoldPeriod

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ItemHoldPeriod spécifie le nombre de jours pendant lesquels mettre en attente les éléments de boîte aux lettres correspondant à la requête de recherche. La durée est calculée à compter de la date de réception ou de création de l'élément dans la boîte aux lettres.

Language

Facultatif

System.String

Le paramètre Language spécifie des paramètres régionaux pour la recherche de boîte aux lettres.

LogLevel

Facultatif

Microsoft.Exchange.Data.Storage.Infoworker.MailboxSearch.LoggingLevel

Le paramètre LogLevel spécifie un niveau de journalisation pour la recherche de boîte aux lettres. Les valeurs valides sont les suivantes :

  • Basic   Les informations de base de la recherche sont conservées.

  • Full   Outre les informations du niveau de journalisation de base, une liste complète de tous les messages renvoyés est incluse.

  • Suppress   La journalisation est supprimée. Aucun journal n'est conservé.

MessageTypes

Facultatif

Microsoft.Exchange.Data.Search.AqsParser.KindKeyword[]

Le paramètre MessageTypes spécifie les types de messages qui doivent être inclus dans la recherche de boîte aux lettres. Les valeurs valides sont les suivantes :

  • Email

  • Meetings

  • Tasks

  • Notes

  • Docs

  • Journals

  • Contacts

  • IM

Name

Facultatif

System.String

Le paramètre Name spécifie un nom pour la recherche. Le dossier de niveau supérieur créé dans la boîte aux lettres cible, où les éléments renvoyés par la recherche sont copiés, est également nommé d'après le nom de recherche.

PublicFolderSources

Facultatif

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter[]

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

Recipients

Facultatif

System.String[]

Le paramètre Recipients spécifie un ou plusieurs destinataires et fait partie de la requête de recherche de boîte aux lettres. Les messages adressés à tout destinataire spécifié dans le paramètre Recipients sont renvoyés.

SearchQuery

Facultatif

System.String

Le paramètre SearchQuery spécifie une requête de recherche en langage KQL (Keyword Query Language). Si une requête n'est pas spécifiée, la boîte aux lettres entière est copiée dans la boîte aux lettres cible.

Si d'autres paramètres de recherche tels que Senders, Recipients, StartDate et EndDate sont spécifiés, ils sont combinés à l'aide de l'opérateur AND avec le paramètre SearchQuery.

Senders

Facultatif

System.String[]

Le paramètre Senders spécifie un ou plusieurs expéditeurs. Les messages envoyés par les expéditeurs spécifiés sont renvoyés par la recherche. Les expéditeurs peuvent inclure des utilisateurs, des groupes de distribution, des adresses SMTP ou des domaines.

Si des groupes de distribution sont spécifiés, les messages envoyés par les membres du groupe de distribution sont renvoyés dans les résultats de la recherche.

SourceMailboxes

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre SourceMailboxes spécifie les boîtes aux lettres devant faire l'objet d'une recherche. Si aucune boîte aux lettres n’est spécifiée explicitement à l’aide du paramètre SourceMailboxes, la recherche est effectuée parmi toutes les boîtes aux lettres résidant sur les serveurs de boîtes aux lettres de l’ensemble de l’organisation.

StartDate

Facultatif

Microsoft.Exchange.ExchangeSystem.ExDateTime

Le paramètre StartDate indique le début de la plage de dates définies.

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 ».

StatisticsStartIndex

Facultatif

System.Int32

Le paramètre StatisticsStartIndex est utilisé par le Centre d’administration Exchange (CAE) pour récupérer des statistiques sur les mots clés dans une opération paginée.

StatusMailRecipients

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre StatusMailRecipients spécifie un ou plusieurs destinataires devant recevoir un message électronique d'état à la fin de la recherche.

TargetMailbox

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre TargetMailbox spécifie la boîte aux lettres dans laquelle les éléments renvoyés par la recherche sont copiés.

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.

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: