Get-MailboxSearch

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.

Utilisez l’applet de commande Get-MailboxSearch pour afficher les recherches de boîte aux lettres en cours, terminées ou arrêtées.

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 PowerShell de conformité de la sécurité & . 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.

Syntax

Get-MailboxSearch
   [[-Identity] <SearchObjectIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-MailboxSearch
   [[-Identity] <EwsStoreObjectIdParameter>]
   [-ShowDeletionInProgressSearches]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-MailboxSearch
   -InPlaceHoldIdentity <String>
   [-ShowDeletionInProgressSearches]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

Dans Exchange local, une recherche de boîte aux lettres est utilisée pour effectuer une In-Place eDiscovery ou pour placer les utilisateurs en attente In-Place. Utilisez la cmdlet Get-MailboxSearch pour extraire les paramètres, quel que soit le type de recherche menée sur une boîte aux lettres.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, 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 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

Get-MailboxSearch -ResultSize "unlimited"

Cet exemple obtient la liste de toutes les recherches de boîtes aux lettres.

Exemple 2

Get-MailboxSearch "Project Hamilton" | Format-List

Cet exemple récupère toutes les propriétés de la recherche de boîtes aux lettres intitulée Project Hamilton.

Le paramètre Identity est un paramètre positionnel. Les paramètres de position peuvent être utilisés sans l’étiquette (Identité). Pour plus d’informations sur les paramètres positionnels, consultez À propos des paramètres.

Exemple 3

(Get-Mailbox Mark).InPlaceHolds

Get-MailboxSearch -InPlaceHoldIdentity 9953d0f0fd03415e949d4b41c5a28cbb

Cet exemple permet d’obtenir des In-Place Holds attribuées à un utilisateur. La première commande génère des GUID de In-Place Holds. La dernière commande récupère une recherche de boîte aux lettres en fonction du GUID de la In-Place Hold sur laquelle l’utilisateur est placé.

Paramètres

-DomainController

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

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Le paramètre Identity spécifie le nom de la requête de recherche. Si aucun nom n’est fourni, toutes les requêtes de recherche de boîte aux lettres sont renvoyées.

Pour améliorer les performances de cette applet de commande dans Exchange Online, certaines propriétés de recherche de boîte aux lettres ne sont pas retournées si vous ne spécifiez pas le nom d’une recherche de boîte aux lettres. Ces propriétés sont les suivantes :

  • SourcesMailboxes
  • Sources
  • SearchQuery
  • ResultsLink
  • PreviewResultsLink
  • Erreurs

Pour afficher ces propriétés, vous devez fournir le nom d’une recherche de boîte aux lettres.

Type:SearchObjectIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-InPlaceHoldIdentity

Le paramètre InPlaceHoldIdentity permet de définir le GUID d’un In-Place Hold. Utilisez ce paramètre pour rechercher steph In-place Hold. Les GUID de toutes les conservations inaltérables dans lesquelles un utilisateur est placé sont rajoutés à la propriété InPlaceHolds de l’utilisateur. Vous pouvez récupérer l’information au moyen de la cmdlet Get-Mailbox.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Pour retourner toutes les demandes correspondant à la requête, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ShowDeletionInProgressSearches

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.