Test-ExchangeSearch

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2009-05-05

La cmdlet Test-ExchangeSearch permet de vérifier que la recherche est actuellement activée et indexe de nouveaux messages électroniques dans un délai raisonnable.

Syntaxe

Test-ExchangeSearch [-Identity <MailboxIdParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IndexingTimeout <Int32>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]

Test-ExchangeSearch [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IndexingTimeout <Int32>] [-MonitoringContext <$true | $false>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Test-ExchangeSearch [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IndexingTimeout <Int32>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Test-ExchangeSearch créé un message et une pièce jointe que seule la recherche Microsoft Exchange peut trouver. À moins qu'une boîte aux lettres ne soit spécifiée dans le paramètre Identity, le message est stocké dans la boîte aux lettres de la Surveillance du système. La commande attend l'indexation du message puis recherche le contenu. La commande indique une réussite si le contenu du message est trouvé. La commande indique un échec si le contenu est introuvable après que l'intervalle défini dans le paramètre IndexingTimeout est écoulé.

Pour exécuter la cmdlet Test-ExchangeSearch, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur des destinataires Exchange ;

  • le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données du service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande.

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Identity spécifie le destinataire pour lequel vous voulez tester la recherche. Si ce paramètre n'est pas spécifié, la boîte aux lettres de la Surveillance du système est utilisée.

IndexingTimeout

Facultatif

System.Int32

Le paramètre IndexingTimeout spécifie le délai maximal d'attente entre l'ajout d'un nouveau message électronique dans la boîte aux lettres de test et le renvoi de ce message dans un résultat de recherche. La valeur par défaut est 2 minutes. Si ce paramètre n'est pas spécifié, l'intervalle par défaut est utilisé.

MonitoringContext

Facultatif

System.Boolean

Le paramètre MonitoringContext spécifie un fichier de sortie XML dans lequel Microsoft Operations Manager peut écrire.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre Server spécifie le serveur Exchange du destinataire pour lequel vous voulez tester la recherche.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

Exceptions

Exceptions Description

Exemple

Cet exemple teste l'activation de la recherche pour l'utilisateur John@contoso.com.

Test-ExchangeSearch -Identity john@contoso.com