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.