New-MailboxSearch
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 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.
Remarque : Depuis octobre 2020, les applets de commande *-MailboxSearch sont mises hors service dans Exchange Online PowerShell. Utilisez plutôt les applets de commande *-ComplianceSearch dans Security & Compliance PowerShell. Pour plus d’informations, consultez Mise hors service des outils eDiscovery hérités.
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)
New-MailboxSearch
[-Name] <String>
[-AllPublicFolderSources <Boolean>]
[-AllSourceMailboxes <Boolean>]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-DoNotIncludeArchive]
[-EndDate <ExDateTime>]
[-EstimateOnly]
[-ExcludeDuplicateMessages <Boolean>]
[-Force]
[-IncludeKeywordStatistics]
[-IncludeUnsearchableItems]
[-InPlaceHoldEnabled <Boolean>]
[-InPlaceHoldIdentity <String>]
[-ItemHoldPeriod <Unlimited>]
[-Language <CultureInfo>]
[-LogLevel <LoggingLevel>]
[-MessageTypes <KindKeyword[]>]
[-Recipients <String[]>]
[-SearchDumpster]
[-SearchQuery <String>]
[-Senders <String[]>]
[-SourceMailboxes <RecipientIdParameter[]>]
[-StartDate <ExDateTime>]
[-StatusMailRecipients <RecipientIdParameter[]>]
[-TargetMailbox <MailboxIdParameter>]
[-WhatIf]
[<CommonParameters>]
Description
La cmdlet New-MailboxSearch crée une recherche par découverte électronique locale ou une archive permanente. Vous pouvez arrêter, démarrer, modifier ou supprimer la recherche.
Par défaut, les recherches de boîtes aux lettres sont effectuées sur tous les serveurs de boîtes aux lettres Exchange 2013 ou ultérieur dans un organization, sauf si vous limitez la recherche à moins de boîtes aux lettres à l’aide du paramètre SourceMailboxes. Pour rechercher des boîtes aux lettres sur des serveurs de boîtes aux lettres Exchange 2010, exécutez la commande sur un serveur Exchange 2010.
Pour plus d’informations, consultez In-Place eDiscovery in Exchange Server et In-Place Hold and Litigation Hold in Exchange Server.
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
New-MailboxSearch -Name "Legal-ProjectX" -SourceMailboxes DG-Marketing,DG-Executives -TargetMailbox LegalDiscovery@contoso.com -StartDate "01/01/2018" -EndDate "12/31/2018" -Recipients "@contoso.com" -SearchQuery "project report hasattachments:true" -StatusMailRecipients "DG-DiscoveryTeam"
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.
- Destinataires : 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 avec les mots projet ou rapport et pour les messages avec des pièces jointes.
- StartDate et EndDate : ces paramètres spécifient la date de début du 1er janvier 2018 et la date de fin du 31 décembre 2018 pour 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.
- StatusMailRecipients : ce paramètre spécifie que le groupe de distribution DG-DiscoveryTeam doit recevoir une notification une fois la recherche terminée.
Exemple 2
New-MailboxSearch -Name "Hold-ProjectX" -SourceMailboxes DG-Finance -InPlaceHoldEnabled $true
Cet exemple crée une In-Place mise en attente nommée 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.
Exemple 3
New-MailboxSearch -Name "Hold-tailspintoys" -SourceMailboxes DG-Research -SearchQuery '"Patent" AND "Project tailspintoys"' -InPlaceHoldEnabled $true
Cet exemple crée une In-Place Hold nommée 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.
Exemple 4
New-MailboxSearch -Name "Hold for all PFs" -AllPublicFolderSources $true -InPlaceHoldEnabled $true
Dans Exchange local, cet exemple crée une conservation In-Place nommée Hold pour tous les fichiers DEP qui place tout le contenu de tous les dossiers publics sur In-Place conservation, avec une durée de conservation illimitée.
Paramètres
-AllPublicFolderSources
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 lorsque la valeur du paramètre AllSourceMailboxes est $false et que vous ne spécifiez pas une ou plusieurs boîtes aux lettres sources à l’aide du paramètre SourceMailboxes (la valeur du paramètre est vide [$null]).
- $false : aucun dossier public n’est inclus dans la recherche. Cette valeur est la valeur par défaut. Vous pouvez utiliser cette valeur lorsque la valeur du paramètre AllSourceMailboxes est $true ou que vous spécifiez une ou plusieurs boîtes aux lettres sources à l’aide du paramètre SourceMailboxes (la valeur du paramètre n’est pas vide [$null]).
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 |
-AllSourceMailboxes
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 lorsque la valeur du paramètre AllPublicFolderSources est $false et que vous ne spécifiez pas une ou plusieurs boîtes aux lettres sources à 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. Cette valeur est la valeur par défaut. Vous pouvez utiliser cette valeur lorsque la valeur du paramètre AllPublicFolderSources est $true ou que vous spécifiez une ou plusieurs boîtes aux lettres sources à l’aide du paramètre SourceMailboxes (la valeur du paramètre n’est pas vide [$null]).
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 |
-Confirm
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Module complémentaire de sécurité intégré pour l’environnement local Boîtes aux lettres
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 |
-Description
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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, placez-la 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 |
-DomainController
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 |
-DoNotIncludeArchive
Applicable : Exchange Server 2010
Ce paramètre n'est disponible que dans Exchange Server 2010.
Le commutateur DoNotIncludeArchive spécifie que les boîtes aux lettres d’archivage ne sont pas incluses dans la recherche. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Par défaut, les boîtes aux lettres d’archivage sont incluses dans la recherche. Pour exclure les boîtes aux lettres d’archivage, utilisez 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 |
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 |
-EndDate
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre EndDate indique la fin de la plage de dates définies.
Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".
Propriétés du paramètre
| Type: | ExDateTime |
| 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 |
-EstimateOnly
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le commutateur EstimateOnly spécifie 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.
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 |
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 |
-ExcludeDuplicateMessages
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre ExcludeDuplicateMessages élimine la duplication des messages dans les résultats de recherche. Les valeurs valides sont les suivantes :
- $true : copiez une seule instance d’un message si le même message existe dans plusieurs dossiers ou boîtes aux lettres. Cette valeur est la valeur par défaut.
- $false : copiez toutes les instances d’un message si le même message existe dans plusieurs dossiers ou boîtes aux lettres.
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 |
-Force
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée.
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 |
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 |
-IncludeKeywordStatistics
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
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 |
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 |
-IncludeUnsearchableItems
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le commutateur IncludeUnsearchableItems spécifie que les éléments qui n’ont pas pu être indexés par recherche Exchange doivent être inclus dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
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).
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 |
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 |
-InPlaceHoldEnabled
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 : In-Place conservation est activée sur les résultats de la recherche.
- $false : In-Place conservation n’est pas activée sur les résultats de la recherche. Cette valeur est 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.
Si vous essayez de placer une conservation mais que vous ne spécifiez pas de boîtes aux lettres à l’aide du paramètre SourceMailboxes, la commande peut réussir, mais les boîtes aux lettres ne sont pas placées sur In-Place mise en attente.
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 |
-InPlaceHoldIdentity
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Ce paramètre est réservé à l’usage interne chez Microsoft.
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 |
-ItemHoldPeriod
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 :
- Le paramètre SyncSchedule indique ???. Les valeurs valides pour ce paramètre sont les suivantes :
- Valeur unlimited. Cette valeur est la valeur par défaut. Les éléments sont conservés jusqu’à ce que vous supprimiez l'In-Place Hold en supprimant la recherche à l’aide de l’applet de commande Remove-MailboxSearch, en supprimant la boîte aux lettres source de la recherche à l’aide de l’applet de commande Set-MailboxSearch et du paramètre SourceMailboxes, ou dans Exchange local, vous supprimez tous les dossiers publics de la recherche à l’aide de l’applet de commande Set-MailboxSearch pour remplacer le paramètre AllPublicFolderSources de $true par $false.
Propriétés du paramètre
| Type: | Unlimited |
| 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 |
-Language
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre Language spécifie des paramètres régionaux pour la recherche.
L’entrée valide pour ce paramètre est une valeur de code de culture prise en charge à partir de la classe CultureInfo de Microsoft .NET Framework. Par exemple, da-DK pour le danois ou ja-JP pour le japonais. Pour plus d’informations, consultez Classe CultureInfo.
Propriétés du paramètre
| Type: | CultureInfo |
| 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 |
-LogLevel
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre LogLevel spécifie un niveau de journalisation pour la recherche. Les valeurs valides sont les suivantes :
- Supprimer : aucun journal n’est conservé.
- De base : les informations de base sur la requête et la personne qui l’a exécutée sont conservées. Cette valeur est la valeur par défaut.
- Complet : en plus des informations conservées par le niveau de journal de base, le niveau de journal complet ajoute une liste complète des résultats de la recherche.
Propriétés du paramètre
| Type: | LoggingLevel |
| 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 |
-MessageTypes
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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
- IM (Messagerie instantanée)
- Revues
- Réunions
- Notes
- Tâches
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.
Propriétés du paramètre
| Type: | KindKeyword[] |
| 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre Name spécifie un nom convivial pour la recherche. Si la valeur contient des espaces, placez-la 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.
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: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Recipients
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
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 |
-SearchDumpster
Applicable : Exchange Server 2010
Ce paramètre n'est disponible que dans Exchange Server 2010.
Le commutateur SearchDumpster spécifie si la dumpster fait l’objet d’une recherche. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
La dumpster est une zone de stockage dans la boîte aux lettres où les éléments supprimés sont stockés temporairement après avoir été supprimés ou supprimés du dossier Éléments supprimés, ou après avoir été supprimés de manière définitive et avant d’être vidés de la boîte aux lettres en fonction des paramètres de rétention des éléments supprimés.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | True |
| 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 |
-SearchQuery
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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, consultez Informations de référence sur la syntaxe Langage de requête par mots-clés (KQL) et Requêtes par mot clé et conditions de recherche pour eDiscovery.
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
- Expéditeurs
- StartDate
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 |
-Senders
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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, placez-la 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 |
-SourceMailboxes
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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
- Alias
- Nom unique
- Nom unique
- Nom unique canonique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
Pour utiliser ce paramètre, le paramètre AllSourceMailboxes doit être $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.
Pour activer In-Place conservation sur les résultats de la 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 local, définissez le paramètre AllPublicFolderSources sur $true.
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: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-StartDate
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre StartDate indique le début de la plage de dates définies.
Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".
Propriétés du paramètre
| Type: | ExDateTime |
| 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 |
-StatusMailRecipients
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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
- Alias
- Nom unique
- Nom unique
- Nom unique canonique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
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 |
-TargetMailbox
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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
- 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 |
-WhatIf
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Module complémentaire de sécurité intégré pour l’environnement local Boîtes aux lettres
Le commutateur WhatIf ne fonctionne pas sur cette applet de commande.
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.
Entrées
Input types
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.
Sorties
Output types
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.