Filtres dans les commandes de l’environnement de ligne de commande Exchange Management Shell du destinataire

 

Sapplique à :Exchange Server 2013

Dernière rubrique modifiée :2015-03-09

Plusieurs commandes de l’environnement de ligne de commande Exchange Management Shell vous permettent de filtrer un ensemble de destinataires. Vous pouvez créer les types de filtres suivants dans une commande Exchange :

  • Filtres prédéfinis

  • Filtres personnalisés à l’aide du paramètre RecipientFilter

  • Filtres personnalisés à l’aide du paramètre Filter

  • Filtres personnalisés à l’aide du paramètre ContentFilter

Dans Microsoft Exchange Server 2003 et les versions antérieures, la syntaxe de filtrage LDAP (Lightweight Directory Access Protocol) permet de créer des listes d’adresses personnalisées, des listes d’adresses globales, des stratégies d’adresse de messagerie et des groupes de distribution. Dans les versions ultérieures d’Exchange, la nouvelle syntaxe de filtrage OPATH remplace la syntaxe de filtrage LDAP.

Contenu de cette rubrique

Filtres prédéfinis

Filtres personnalisés à l’aide du paramètre RecipientFilter

Filtres personnalisés à l’aide du paramètre Filter

Filtres personnalisés à l’aide du paramètre ContentFilter

Informations supplémentaires sur la syntaxe OPATH

Documentation du filtrage des destinataires

Un filtre prédéfini est un filtre Exchange à usage courant auquel vous pouvez avoir recours pour répondre à divers critères de filtrage des destinataires pour la création de groupes de distribution dynamiques, de stratégies d’adresse de messagerie, de listes d’adresses ou de listes d’adresses globales. Les filtres prédéfinis vous permettent d’utiliser l’environnement de ligne de commande Exchange Management Shell ou le Centre d’administration Exchange (EAC). Les filtres prédéfinis vous permettent de réaliser les tâches suivantes :

  • Déterminer l’étendue des destinataires.

  • Ajouter un filtrage conditionnel basé sur des propriétés, telles qu’une société, un département, un état ou une région.

  • Ajouter des attributs personnalisés pour les destinataires. Pour plus d’informations, consultez la rubrique Attributs personnalisés.

Les paramètres suivants sont considérés comme des filtres prédéfinis :

  • IncludedRecipients

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • ConditionalCustomAttribute1–15.

Des filtres prédéfinis sont disponibles pour les cmdlets suivantes :

Cet exemple décrit l’utilisation de filtres prédéfinis dans l’environnement de ligne de commande Exchange Management Shell pour la création d’un groupe de distribution dynamique. La syntaxe employée dans cet exemple s’apparente sans être identique à celle que vous utiliseriez pour créer une stratégie d’adresse de messagerie, une liste d’adresses ou une liste d’adresses globale. Lorsque vous créez un filtre prédéfini, vous devez vous poser les questions suivantes :

  • À partir de quelle unité d’organisation souhaitez-vous inclure des destinataires ? (Cette question correspond au paramètre RecipientContainer.)

    RemarqueRemarque :
    La sélection de l’unité d’organisation à cette fin s’applique uniquement lors de la création de groupes de distribution dynamiques et non lorsque vous créez des stratégies d’adresse de messagerie, des listes d’adresses ou des listes d’adresses globales.
  • Quel type de destinataire voulez-vous inclure ? (Cette question correspond au paramètre IncludedRecipients.)

  • Quelles conditions supplémentaires voulez-vous inclure dans le filtre ? (Cette question correspond aux paramètres ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince et ConditionalCustomAttribute.)

Cet exemple crée le groupe de distribution dynamique Contoso Finance pour les boîtes aux lettres des utilisateurs dans l’unité d’organisation Contoso.com/Users et précise la condition pour y inclure uniquement les destinataires dotés de l’attribut Department défini pour Finance et l’attribut Company pour Contoso.

New-DynamicDistributionGroup -Name "Contoso Finance" -OrganizationalUnit Contoso.com/Users -RecipientContainer Contoso.com/Users -IncludedRecipients MailboxUsers -ConditionalDepartment "Finance" -ConditionalCompany "Contoso"

Cet exemple affiche les propriétés de ce nouveau groupe de distribution dynamique.

Get-DynamicDistributionGroup -Identity "Contoso Finance" | Format-List Recipient*,Included*

Filtres prédéfinis

Si des filtres prédéfinis ne répondent pas à vos besoins pour la création ou la modification de groupes de distribution dynamiques, de stratégies d’adresses de messagerie et de listes d’adresses, vous pouvez créer un filtre personnalisé à l’aide du paramètre RecipientFilter.

Le paramètre de filtrage des destinataires est disponible pour les cmdlets suivantes :

Pour plus d’informations sur les propriétés filtrables, vous pouvez utiliser le paramètre RecipientFilter, consultez la rubrique Propriétés filtrables pour le paramètre -RecipientFilter.

L’exemple qui suit utilise le paramètre RecipientFilter pour créer un groupe de distribution dynamique. La syntaxe employée dans cet exemple s’apparente sans être identique à celle que vous utilisez pour créer une stratégie d’adresse de messagerie, une liste d’adresses ou une liste d’adresses globale.

Cet exemple utilise des filtres personnalisés pour créer un groupe de distribution dynamique pour des boîtes aux lettres d’utilisateurs pour lesquels l’attribut Company est défini en tant que valeur Contoso et l’attribut Office en tant que valeur North Building.

New-DynamicDistributionGroup -Name AllContosoNorth -OrganizationalUnit contoso.com/Users -RecipientFilter { ((RecipientType -eq 'UserMailbox') -and (Company -eq 'Contoso') -and (Office -eq 'North Building')) }

Filtres prédéfinis

Vous pouvez utiliser le paramètre Filter pour filtrer les résultats d’une commande et spécifier les objets à extraire. Par exemple, au lieu d’extraire tous les utilisateurs ou groupes, vous pouvez spécifier un ensemble d’utilisateurs ou de groupes à l’aide d’une chaîne de filtre. Ce type de filtre ne modifie pas la configuration ou les attributs des objets. Il modifie uniquement l’ensemble des objets retournés par la commande.

L’utilisation du paramètre Filter pour modifier des résultats de commande est un processus appelé filtrage côté serveur. Le filtrage côté serveur soumet la commande et le filtre au serveur pour traitement. L’environnement de ligne de commande Exchange Management Shell prend également en charge le filtrage côté client, au cours duquel la commande extrait tous les objets du serveur, puis applique le filtre dans la fenêtre de console locale. Pour effectuer le filtrage côté client, utilisez la cmdlet Where-Object. Pour plus d’informations sur le filtrage côté serveur et côté client, consultez « Filtrage des données » dans la rubrique Utilisation de la sortie de la commande.

Pour rechercher les propriétés filtrables pour les cmdlets dotées du paramètre Filter, vous pouvez exécuter la commande Get par rapport à un objet et mettre en forme la sortie par un traitement en pipeline du paramètre Format-List. La plupart des valeurs renvoyées seront disponibles en vue d’une utilisation dans le paramètre Filter. L’exemple qui suit retourne une liste détaillée pour la boîte aux lettres de l’utilisateur Ayla.

Get-Mailbox -Identity Ayla | Format-List

Le paramètre Filter est disponible pour les cmdlets suivantes :

Pour plus d’informations sur les propriétés filtrables, vous pouvez utiliser le paramètre Filter, consultez la rubrique Propriétés filtrables pour le paramètre -Filter.

Cet exemple utilise le paramètre Filter pour renvoyer des informations sur les utilisateurs dont le titre de fonction renferme le terme « manager ».

Get-User -Filter {Title -like 'Manager*'}

Filtres prédéfinis

Vous pouvez utiliser le paramètre ContentFilter pour sélectionner un contenu de message spécifique à exporter à l’aide de la cmdlet New-MailboxExportRequest. Si la commande trouve un message contenant la correspondance avec le filtre de contenu, elle exporte ce message dans un fichier .pst.

Cet exemple crée une demande d’exportation qui recherche dans la boîte aux lettres de l’utilisateur Ayla des messages dont le corps contient l’expression « company prospectus ». Si l’expression est trouvée, la commande exporte tous les messages qui en sont dotés vers un fichier .pst.

New-MailboxExportRequest -Mailbox Ayla -ContentFilter {Body -like "company prospectus*"}

Pour plus d’informations sur les propriétés filtrables, vous pouvez utiliser le paramètre ContentFilter, consultez la rubrique Propriétés filtrables pour le paramètre -ContentFilter.

Filtres prédéfinis

Pour créer vos propres filtres personnalisés, tenez compte des éléments suivants :

  • Entourez la chaîne de syntaxe OPATH d’accolades {} avec le paramètre Filter ou RecipientFilter.

  • Insérez un trait d’union avant tous les opérateurs. Les opérateurs les plus courants sont notamment les suivants :

    • -and

    • -or

    • -not

    • -eq (égal à)

    • -ne (différent de)

    • -lt (inférieur à)

    • -gt (supérieur à)

    • -like (comparaison de chaînes)

    • -notlike (comparaison de chaînes)

  • La plupart des propriétés des paramètres RecipientFilter et Filter acceptent les caractères génériques. Si vous utilisez un caractère générique, privilégiez l’opérateur like au détriment de l’opérateur eq. L’opérateur like permet de chercher des correspondances au modèle dans des types riches, tels que des chaînes, tandis que l’opérateur eq permet de chercher une correspondance exacte.

  • Exécutez les commandes suivantes pour obtenir des informations sur les opérateurs que vous pouvez utiliser :

    • Help about_logical_operator

    • Help about_comparison_operator

  • Vous pouvez utiliser la plupart des propriétés des types de destinataires pour créer des chaînes de filtre. Pour plus d’informations sur les propriétés filtrables que vous pouvez employer avec une cmdlet spécifique, consultez les rubriques de référence sur les cmdlets dans Utilisation de PowerShell avec Exchange 2013 (Exchange Management Shell).

Les rubriques suivantes contiennent des liens pointant sur des rubriques qui vous aideront à mieux comprendre les propriétés filtrables que vous pouvez utiliser avec des commande de destinataire Exchange.

 

Rubrique Description

Propriétés filtrables pour le paramètre -RecipientFilter

Pour en savoir plus sur les propriétés filtrables pour le paramètre RecipientFilter.

Propriétés filtrables pour le paramètre -Filter

Pour en savoir plus sur les propriétés filtrables pour le paramètre Filter.

Propriétés filtrables pour le paramètre -ContentFilter

Pour en savoir plus sur l’utilisation du paramètre ContentFilter lors de l’utilisation de la cmdlet New-MailboxExportRequest.

Filtres prédéfinis

 
Afficher: