Get-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 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 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
SearchObjectIdentity
Get-MailboxSearch
[[-Identity] <SearchObjectIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
EwsStoreObjectIdentity
Get-MailboxSearch
[[-Identity] <EwsStoreObjectIdParameter>]
[-ShowDeletionInProgressSearches]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
InPlaceHoldIdentity
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 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
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 positionnel, ce qui signifie que vous pouvez l’utiliser sans l’étiquette -Identity dans l’emplacement pris en charge dans la commande (dans ce cas, tout d’abord). 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 conservation. 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
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 des paramètres
| 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 |
-Identity
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.
Propriétés des paramètres
| Type: | SearchObjectIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
EwsStoreObjectIdentity
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
SearchObjectIdentity
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-InPlaceHoldIdentity
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
InPlaceHoldIdentity
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ResultSize
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| 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 |
-ShowDeletionInProgressSearches
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 des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
EwsStoreObjectIdentity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
InPlaceHoldIdentity
| 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.