Création de filtres dans des commandes de destinataire

S’applique à : Exchange Server 2010 SP2, Exchange Server 2010 SP3

Dernière rubrique modifiée : 2010-07-28

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 Exchange Server 2007 et Exchange Server 2010, la syntaxe de filtrage OPATH remplace la syntaxe de filtrage LDAP. Exchange prend en charge les filtres LDAP existants mais vous ne pouvez pas les modifier. Avant de pouvoir modifier un filtre LDAP, il vous faut le mettre à niveau vers un filtre OPATH. Pour plus d’informations, consultez la rubrique Mettre à niveau des filtres LDAP vers des filtres OPATH.

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

Filtres prédéfinis

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. Grâce aux filtres prédéfinis, vous pouvez utiliser soit l’environnement de ligne de commande Exchange Management Shell, soit un assistant dans la console de gestion Exchange. 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 Présentation des 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 :

• New-DynamicDistributionGroup

• Set-DynamicDistributionGroup

• New-EmailAddressPolicy

• Set-EmailAddressPolicy

• New-AddressList

• Set-AddressList

• New-GlobalAddressList

• Set-GlobalAddressList

Exemple

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 mais n’est pas 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.)

  Remarque :
  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*

Retour au début

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

Si les filtres prédéfinis ne répondent pas à votre besoin de créer ou de modifier des groupes de distribution dynamiques, des stratégies d’adresse de messagerie et des listes d’adresses, vous pouvez créer un filtre personnalisé au moyen du paramètre RecipientFilter.

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

• New-DynamicDistributionGroup

• Set-DynamicDistributionGroup

• New-EmailAddressPolicy

• Set-EmailAddressPolicy

• New-AddressList

• Set-AddressList

• New-GlobalAddressList

• Set-GlobalAddressList

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.

Exemple

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 mais n’est pas 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')) }

Retour au début

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

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 d’une 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 :

• Get-ActiveSyncDevice

• Get-ActiveSyncDeviceClass

• Get-CASMailbox

• Get-Contact

• Get-DistributionGroup

• Get-DynamicDistributionGroup

• Get-Group

• Get-Mailbox

• Get-MailContact

• get-MailPublicFolder

• Get-MailUser

• Get-Message

• Get-Queue

• Get-Recipient

• get-RemoteMailbox

• Get-RoleGroup

• Get-SecurityPrincipal

• Get-StoreUsageStatistics

• Get-ThrottlingPolicyAssociation

• Get-UMMailbox

• Get-User

• Remove-Message

• Resume-Message

• Resume-Queue

• Retry-Queue

• Suspend-Message

• Suspend-Queue

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.

Exemple

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*'}

Retour au début

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

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.

Exemple

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.

Retour au début

Informations supplémentaires sur la syntaxe OPATH

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 2010 (environnement de ligne de commande Exchange Management Shell).

Retour au début

 © 2010 Microsoft Corporation. Tous droits réservés.