Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

New-MailboxSearch

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-02-27

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.

noteRemarque :
Sur le 1 juillet 2017, vous ne serez n’est plus en mesure d’utiliser l’applet de commande New-MailboxSearch pour créer des recherches d’e-Discovery In situ et In situ contient dans Exchange Online. Pour créer des recherches d’e-Discovery et contient des cas d’e-Discovery, démarrez à l’aide de New-ComplianceSearch et New-CaseHoldPolicy de la sécurité pour Microsoft Office 365 et le centre de conformité. Vous serez toujours en mesure d’utiliser Set-MailboxSearch pour modifier des recherches d’e-Discovery Place existants et Place contient. Création de nouvelles recherches et des blocages dans Exchange Server 2013 est toujours pris en charge et exécuter à partir de votre organisation sur place dans un déploiement hybride de Exchange des recherches ne sont pas affectés par cette modification.

Utilisez l’applet de commande New-MailboxSearch pour créer une recherche de boîte aux lettres et obtenir une estimation des résultats de la recherche, placer ces derniers en archive permanente ou les copier dans une boîte aux lettres de découverte. Vous pouvez également mettre en attente tout le contenu dans une boîte aux lettres en ne spécifiant pas de requête de recherche, ce qui donne des résultats semblables à la conservation pour litige.

CautionAttention :
Par défaut, les recherches de boîte aux lettres sont effectuées sur tous les serveurs de boîtes aux lettres Exchange 2016 et Exchange 2013 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. Pour effectuer des recherches dans les boîtes aux lettres sur les serveurs de boîte aux lettres Exchange 2010, exécutez la commande sur un serveur Exchange 2010.

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.

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

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

Cet exemple crée la recherche de boîte aux lettres Legal-ProjectX. La recherche utilise plusieurs paramètres pour limiter la requête de recherche :

  • SourceMailboxes   Ce paramètre limite la recherche aux membres des groupes de distribution DG-Marketing et DG-Executives.

  • Recipients   Ce paramètre spécifie que la recherche inclut tous les messages envoyés au domaine contoso.com.

  • SearchQuery   Ce paramètre spécifie une requête KQL pour les messages contenant les mots projet ou rapport et pour les messages avec pièces jointes.

  • StartDate et EndDate   Ces paramètres permettent de spécifier la date de début (1er janvier 2015) et la date de fin (31 décembre 2015) de la recherche.

  • TargetMailbox   Ce paramètre spécifie que les résultats de la recherche doivent être copiés dans la boîte aux lettres de découverte LegalDiscovery.

  • StatusMailRecipeints   Ce paramètre spécifie que le groupe de distribution DG-DiscoveryTeam recevra une notification lorsque la recherche sera terminée.

New-MailboxSearch -Name "Legal-ProjectX" -SourceMailboxes DG-Marketing,DG-Executives -TargetMailbox LegalDiscovery@contoso.com -StartDate "01/01/2015" -EndDate "12/31/2015" -Recipients "@contoso.com" -SearchQuery "project report hasattachments:true" -StatusMailRecipients "DG-DiscoveryTeam"

Cet exemple crée une archive permanente Hold-ProjectX et place tous les membres du groupe de distribution DG-Finance en attente. La recherche ne spécifiant pas les paramètres SearchQuery et ItemHoldPeriod, tous les messages des boîtes aux lettres renvoyées sont mis en archive permanente indéfinie.

New-MailboxSearch -Name "Hold-ProjectX" -SourceMailboxes DG-Finance -InPlaceHoldEnabled $true

Cete exemple crée une archive permanente Hold-tailspintoys et place tous les membres du groupe de distribution DG-Research en attente. La recherche spécifiant le paramètre SearchQuery, seuls les messages correspondant à la requête sont placés en archive permanente indéfinie.

New-MailboxSearch -Name "Hold-tailspintoys" -SourceMailboxes DG-Research -SearchQuery "'Patent' AND 'Project tailspintoys'" -InPlaceHoldEnabled $true

Dans Exchange sur site, l’exemple suivant crée une archive permanente nommée Hold for all PFs qui place l’ensemble du contenu de tous les dossiers publics dans une archive permanente pour une durée illimité.

New-MailboxSearch -Name "Hold for all PFs" -AllPublicFolderSources $true -InPlaceHoldEnabled $true

La cmdlet New-MailboxSearch crée une recherche par découverte électronique locale ou une archive permanente. Sauf indication contraire, les boîtes aux lettres de tous les serveurs de boîtes aux lettres d’une organisation sont soumises à la recherche. Vous pouvez arrêter, démarrer, modifier ou supprimer la recherche.

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

name

Obligatoire

System.String

Le paramètre Name spécifie un nom convivial pour la recherche. Si la valeur contient des espaces, mettez le nom entre guillemets (").

La valeur de ce paramètre est utilisée pour créer le dossier de niveau supérieur qui contient les résultats de recherche dans la boîte aux lettres cible qui est spécifiée par le paramètre TargetMailbox.

AllPublicFolderSources

Facultatif

System.Boolean

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

Le paramètre AllPublicFolderSources détermine si tous les dossiers publics de l’organisation doivent être inclus dans la recherche. Les valeurs valides sont les suivantes :

  • $true   Tous les dossiers publics sont inclus dans la recherche. Cette valeur est requise dans les cas suivants :

    •  La valeur du paramètre AllSourceMailboxes est $false.

    Et

    •  Vous ne spécifiez pas de boîtes aux lettres source à l’aide du paramètre SourceMailboxes (la valeur du paramètre est vide [$null]).

  • $false   Aucun dossier public n’est inclus dans la recherche. Il s’agit de la valeur par défaut. Vous pouvez utiliser cette valeur dans les cas suivants :

    •  La valeur du paramètre AllSourceMailboxes est $true.

    Ou

    •  Vous spécifiez des boîtes aux lettres source à l’aide du paramètre SourceMailboxes (la valeur du paramètre n’est pas vide [$null]).

AllSourceMailboxes

Facultatif

System.Boolean

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

Le paramètre AllSourceMailboxes indique si toutes les boîtes aux lettres doivent être incluses dans la recherche. Les valeurs valides sont les suivantes :

  • $true   Toutes les boîtes aux lettres sont incluses dans la recherche. Cette valeur est requise dans les cas suivants :

    •  La valeur du paramètre AllPublicFolderSources est $false.

    Et

    •  Vous ne spécifiez pas de boîtes aux lettres source à l’aide du paramètre SourceMailboxes (la valeur du paramètre est vide [$null]).

  • $false   Toutes les boîtes aux lettres ne sont pas incluses dans la recherche. Il s’agit de la valeur par défaut. Vous pouvez utiliser cette valeur dans les cas suivants :

    •  La valeur du paramètre AllPublicFolderSources est $true.

    Ou

    •  Vous spécifiez des boîtes aux lettres source à l’aide du paramètre SourceMailboxes (la valeur du paramètre n’est pas vide [$null]).

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 permet de fournir une description de la recherche. La description n’est pas visible par les utilisateurs. Si la valeur contient des espaces, mettez-la entre guillemets (").

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.Management.Automation.SwitchParameter

Le commutateur EstimateOnly précise que seule une estimation du nombre d’éléments à retourner est fournie. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si vous n’utilisez pas ce commutateur, les messages sont copiés dans la boîte aux lettres cible.

ExcludeDuplicateMessages

Facultatif

System.Boolean

Le paramètre ExcludeDuplicateMessages élimine la duplication des messages dans les résultats de recherche. Les valeurs valides sont les suivantes :

  • $true   Permet de copier une instance unique d’un message si le même message existe dans plusieurs dossiers ou boîtes aux lettres. Il s’agit de la valeur par défaut.

  • $false   Permet de copier toutes les instances d’un message si le même message existe dans plusieurs dossiers ou boîtes aux lettres.

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.

IncludeKeywordStatistics

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur IncludeKeywordStatistics renvoie des statistiques de mots clés (nombre d’instances de chaque mot clé) dans les résultats de la recherche. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

IncludeUnsearchableItems

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur IncludeUnsearchableItems indique que les éléments qui n’ont pas pu être indexés par la recherche Exchange doivent être inclus dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

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

InPlaceHoldEnabled

Facultatif

System.Boolean

Le paramètre InPlaceHoldEnabled indique si une conservation inaltérable doit être définie pour des éléments figurant dans les résultats de recherche. Les valeurs valides sont les suivantes :

  • $true   La conservation inaltérable est activée dans les résultats de recherche.

  • $false   La conservation inaltérable est désactivée dans les résultats de recherche. Il s’agit de la valeur par défaut.

Vous ne pouvez pas définir une conservation inaltérable dans les résultats de recherche lorsque le paramètre AllSourceMailboxes est $true.

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.

InPlaceHoldIdentity

Facultatif

System.String

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

ItemHoldPeriod

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ItemHoldPeriod indique le nombre de jours pour la conservation inaltérable dans les éléments de boîte aux lettres (tous les éléments de boîte aux lettres ou les éléments qui sont renvoyés dans les résultats 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. Les valeurs valides sont les suivantes :

  • Nombre entier.

  • Valeur unlimited. Il s’agit de la valeur par défaut. Les éléments sont conservés jusqu’à ce que vous supprimiez l’archive permanente en effectuant l’une des actions suivantes :

    •  Supprimer la recherche en utilisant l’applet de commande Remove-MailboxSearch.

    •  Supprimer la boîte aux lettres source de la recherche en utilisant l’applet de commande Set-MailboxSearch et le paramètre SourceMailboxes.

    •  Dans Exchange sur site, supprimer tous les dossiers publics de la recherche en utilisant l’applet de commande Set-MailboxSearch afin de faire passer le paramètre AllPublicFolderSources de $true à $false.

Language

Facultatif

System.Globalization.CultureInfo

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

Une entrée valide pour ce paramètre est une valeur de code de culture prise en charge de la classe CultureInfo Microsoft .NET Framework. Par exemple, da-DK pour le danois ou ja-JP pour le japonais. Pour plus d’informations, consultez la rubrique relative à la classe CultureInfo.

LogLevel

Facultatif

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

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

  • Suppress   Aucun journal n’est conservé.

  • Basic   Les informations de base sur la requête et sur son auteur sont conservées. Il s’agit de la valeur par défaut.

  • Full   Outre les informations conservées par le niveau de journal Basic, le niveau de journal Full ajoute la liste complète des résultats de recherche.

MessageTypes

Facultatif

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

Le paramètre MessageTypes spécifie les types de messages à inclure dans la requête de recherche. Les valeurs valides sont les suivantes :

  • Contacts

  • Docs

  • Email

  • IM

  • Journals

  • Meetings

  • Notes

  • Tasks

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

La valeur par défaut est vide ($null), ce qui signifie que tous les types de messages sont inclus.

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 indique les destinataires à inclure dans la requête de recherche. Les messages dans lesquels figurent les destinataires spécifiés dans les champs À, Cc et Cci sont renvoyés dans les résultats de recherche.

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

SearchQuery

Facultatif

System.String

Le paramètre SearchQuery spécifie des mots clés pour la requête de recherche en utilisant la syntaxe KQL (Keyword Query Language). Pour plus d’informations sur la syntaxe KQL, consultez la rubrique Référence de syntaxe de langage de requête de mot clé (KQL).

Si vous utilisez ce paramètre avec d’autres paramètres de requête de recherche, la requête combine ces paramètres à l’aide de l’opérateur AND.

Les autres paramètres de requête de recherche sont les suivants :

  • EndDate

  • MessageTypes

  • Recipients

  • Senders

  • StartDate

Senders

Facultatif

System.String[]

Le paramètre Senders indique les expéditeurs à inclure dans la requête de recherche. Les messages dans lesquels figure l’expéditeur spécifié sont renvoyés dans les résultats de recherche. Les expéditeurs peuvent inclure des utilisateurs, des groupes de distribution (messages envoyés par des membres du groupe), des adresses SMTP ou des domaines.

Vous pouvez spécifier plusieurs expéditeurs séparés par des virgules. Si la valeur contient des espaces, mettez-la entre guillemets (").

SourceMailboxes

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre SourceMailboxes spécifie l’identité d’une ou de plusieurs boîtes aux lettres soumises à la recherche. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • Adresse de messagerie

  • GUID

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

Pour utiliser ce paramètre, le paramètre AllSourceMailboxes doit être défini sur $false (valeur par défaut).

La valeur par défaut est vide ($null), ce qui signifie qu’aucune boîte aux lettres source n’a été indiquée. Pour effacer les boîtes aux lettres source, utilisez la valeur $null.

noteRemarque :
Pour activer la conservation inaltérable dans les résultats de recherche, vous devez définir le paramètre AllSourceMailboxes sur $false (valeur par défaut) et configurer l’un des paramètres suivants ou les deux :
  • Spécifiez une ou plusieurs boîtes aux lettres source à l’aide du paramètre SourceMailboxes.

  • Dans Exchange sur site, définissez le paramètre AllPublicFolderSources sur $true.

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

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. Vous pouvez utiliser une valeur quelconque qui identifie le destinataire.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • Adresse de messagerie

  • GUID

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

TargetMailbox

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre TargetMailbox indique la boîte aux lettres de destination dans laquelle les résultats de recherche sont copiés. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique.

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)

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: