Création de filtres dans des commandes de destinataire

 

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

Dernière rubrique modifiée : 2007-11-15

Plusieurs commandes de l’environnement de ligne de commande Exchange Management Shell vous permettent de filtrer un ensemble de destinataires. Il existe deux types de filtrage à l'aide de commandes Exchange : Résultats du filtrage et attributs de filtrage dans une commande.

Pour filtrer des résultats, vous devez utiliser un filtre personnalisé. Pour filtrer les attributs d’une commande, vous pouvez utiliser un filtre prédéfini ou un filtre personnalisé.

Un filtre prédéfini est un filtre Exchange 2007 couramment utilisé que vous pouvez utiliser pour répondre à de nombreux critères de filtrage des destinataires. Par exemple, vous pouvez utiliser des filtres prédéfinis :

• Déterminez de la portée des destinataires.

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

• Ajoutez des attributs personnalisés pour les destinataires.

Lorsque votre configuration de filtrage dépasse ces paramètres, vous pouvez définir un filtre personnalisé en utiliser la syntaxe de filtrage OPATH pour référencer l’ensemble des propriétés de l'environnement de ligne de commande Exchange Management Shell.

Résultats du filtrage

Le premier type de filtrage vous permet de filtrer les résultats d’une commande. Par exemple, les cmdlets Get-User, Get-Recipient, Get-Mailbox, Get-MailUser, Get-Contact, Get-MailContact, Get-Group, Get-DistributionGroup et Get-DynamicDistributionGroup ont toutes un paramètre Filter qui vous permet de spécifier les utilisateurs ou les groupes à extraire avec la commande. Au lieu d’extraire tous les utilisateurs ou groupes, vous pouvez spécifier un ensemble d’utilisateurs ou de groupes à extraire à 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.

Pour plus d'informations sur les propriétés filtrables que vous pouvez utiliser avec le paramètre -Filter, consultez les rubriques suivantes :

• Propriétés filtrables pour le paramètre -Filter dans Exchange 2007 SP1 et SP2

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

Notes

L’utilisation du paramètre Filtre pour modifier les résultats de commandes est un 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, dans lequel 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.

Filtrage des attributs dans une commande

Le second type de filtrage vous permet de spécifier les attributs que la commande doit utiliser. Vous pouvez utiliser un filtre prédéfini ou créer votre propre filtre personnalisé. Par exemple, les cmdlets New-DynamicDistributionGroup, Set-DynamicDistributionGroup, New-EmailAddressPolicy, Set-EmailAddressPolicy, New-AddressList, Set-AddressList, New-GlobalAddressList et Set-GlobalAddressList disposent toutes des paramètres IncludedRecipients, ConditionalCompany, ConditionalDepartment et ConditionalStateOrProvince, qui vous permettent de déterminer l'ensemble des utilisateurs auxquels la commande s'applique. Ces cmdlets disposent également du paramètre RecipientFilter, qui vous permet de créer votre propre filtre personnalisé. Avec un filtre prédéfini ou personnalisé, vous pouvez spécifier les destinataires à inclure dans un groupe de distribution dynamique, une stratégie d'adresse de messagerie, une liste d'adresses ou une liste d’adresses globales (LAG).

Pour plus d'informations sur les propriétés filtrables que vous pouvez utiliser avec le paramètre -RecipientFilter, consultez les rubriques suivantes :

• Propriétés filtrables pour le paramètre -RecipientFilter dans Exchange 2007 SP1 et SP2

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

Création de filtres personnalisés

Pour créer un filtre personnalisé pour les résultats d’une commande à l’aide du paramètre Filtre, ou pour créer un filtre personnalisé pour les attributs dans une commande à l’aide du paramètre RecipientFilter, vous devez spécifier une chaîne pour le filtre. L'environnement de ligne de commande Exchange Management Shell utilise la syntaxe de filtrage OPath. Opath est une langue de requête conçue pour interroger des sources de données d’objets. Avec l'environnement de ligne de commande Exchange Management Shell, vous n’avez plus besoin d'utiliser la syntaxe compliquée du protocole LAPD (Lightweight Directory Access Protocol) que vous utilisiez dans Microsoft Exchange Server 2003 pour créer des filtres. Au lieu de cela, vous pouvez créer des filtres à l’aide de la syntaxe OPath simple.

Notes

Pour créer un groupe de distribution dynamique, une stratégie d’adresse de messagerie, une liste d’adresses ou une liste d’adresses globales avec des filtres prédéfinis, vous pouvez utiliser un assistant de la console de gestion Exchange ou de l'environnement de ligne de commande Exchange Management Shell. Pour créer un groupe de distribution dynamique, une stratégie d'adresse de messagerie, une liste d'adresses ou une liste d'adresses globales avec un paramètre personnalisé, vous devez utiliser la cmdlet appropriée de l’environnement de ligne de commande Exchange Management Shell avec le paramètre RecipientFilter.

Exemple de filtre prédéfini

Cet exemple décrit l’utilisation de filtres prédéfinis pour créer un groupe de distribution dynamique. La syntaxe des exemples de commandes est similaire mais pas identique à la syntaxe que vous utiliseriez pour créer une stratégie d'adresse de messagerie, une liste d'adresses ou une liste d'adresses globales.

Lorsque vous créez un groupe de distribution dynamique avec l’Assistant Nouveau Groupe de Distribution Dynamique, vous devez choisir les informations de filtrage suivantes :

• À partir de quelle unité d’organisation voulez-vous inclure des destinataires ?

  Notes

  Le choix de l’unité d’organisation à partir de laquelle vous voulez inclure des destinataires s’applique uniquement à la création de groupes de distribution dynamique et non à la création de stratégies d'adresse de messagerie, de listes d'adresses ou de listes d’adresses globales.

• Quel type de destinataire voulez-vous inclure ?

• Quelles conditions supplémentaires voulez-vous inclure dans le filtre ?

Les figures suivantes présentent les pages de l’Assistant Nouveau groupe de distribution dynamique sur lequel vous choisissez de filtrer les informations.

Figure 1   Page Paramètres de filtre de l’Assistant Nouveau groupe de distribution dynamique

Figure 2   Pour sélectionner l’unité d’organisation, cliquez sur Parcourir dans la page Paramètres de filtre de l’Assistant Nouveau groupe de distribution dynamique

Figure 3   Page Conditions de l’Assistant Nouveau groupe de distribution dynamique

Chacune de ces options de filtrage correspond à l’un des paramètres de filtre prédéfinis de la commande New-DynamicDistributionGroup ou Set-DynamicDistributionGroup.

La première option de filtrage pour l’unité d’organisation correspond au paramètre RecipientContainer de la commande. La deuxième option de filtrage pour les types de destinataires correspond au paramètre IncludedRecipients. La troisième option de filtrage pour les conditions supplémentaires correspond aux paramètres ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince et ConditionalCustomAttribute.

Notes

Le paramètre OrganizationalUnit spécifie l’emplacement du groupe de distribution dynamique après sa création. Le paramètre RecipientContainer est un paramètre de filtre qui spécifie l’unité d’organisation dans laquelle résident les destinataires ajoutés au groupe de distribution dynamique.

Par exemple, dans l’Assistant Nouveau groupe de distribution dynamique, vous pouvez sélectionner des destinataires à partir de l'unité d'organisation Contoso.com/Utilisateurs, sélectionner les objets UserMailbox et sélectionner la condition pour inclure uniquement les destinataires dont le champ Département est défini comme Finances et Société défini comme Contoso.

Pour créer le même groupe de distribution dynamique à l’aide de l’environnement de ligne de commande Exchange Management Shell, exécutez la commande suivante :

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

Pour afficher les propriétés de ce nouveau groupe de distribution, exécutez la commande suivante :

Get-DynamicDistributionGroup -Identity ContosoFinance | format-list *Recipient*,Included*

La propriété RecipientFilter affiche la syntaxe de filtre OPath utilisée pour créer ce groupe. La propriété RecipientFilterType est prédéfinie, ce qui signifie que le filtre pour ce groupe a été créé à l’aide des filtres prédéfinis. La propriété LdapRecipientFilter est une propriété en lecture seule qui affiche le filtre LDAP que vous auriez utilisé dans les versions antérieures d’Exchange pour créer ce groupe.

Exemple de filtre personnalisé

Cet exemple décrit l’utilisation de filtres personnalisés pour créer un groupe de distribution dynamique. La syntaxe des exemples de commandes est similaire mais pas identique à la syntaxe que vous utiliseriez pour créer une stratégie d'adresse de messagerie, une liste d'adresses ou une liste d'adresses globales.

Pour créer un filtre personnalisé pour un groupe de distribution dynamique, vous devez utiliser le paramètre RecipientFilter avec la cmdlet New-DynamicDistributionGroup ou Set-DynamicDistributionGroup.

Par exemple, si vous voulez créer un groupe de distribution dynamique de destinataires de boîte aux lettres dont l’attribut Société est défini comme Contoso et dont le champ Bureau est défini sur Immeuble nord, vous devez utiliser un filtre personnalisé. Pour créer ce groupe de distribution dynamique, exécutez la commande suivante :

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

Notes

Le paramètre OrganizationalUnit spécifie l’emplacement du groupe de distribution dynamique après sa création.

Informations de syntaxe OPath supplémentaires

Pour créer vos propres filtres personnalisés, prenez en compte les éléments suivants :

• Encadrez l’ensemble due la chaîne de syntaxe OPath d'accolades avec le paramètre Filtre ou RecipientFilter.

• Insérez un trait d’union avant tous les opérateurs.

• Les opérations les plus courantes sont les suivantes :

  • -and

  • -or

  • -not

  • -eq (égale)

  • -ne (différent de)

  • -lt (plus petit que)

  • -gt (plus grand que)

  • -like (comparaison de chaînes)

  • -notlike (comparaison de chaînes)

• De nombreuses 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, utilisez l'opérateur -like plutôt que 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.

• Les commandes suivantes permettent d’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 utiliser avec une cmdlet spécifique, consultez les rubriques de référence sur les cmdlets dans Environnement de ligne de commande Exchange Management Shell (SP1 et SP2).

Pour plus d'informations

Pour plus d'informations sur la canalisation de sortie dans l'environnement de ligne de commande Exchange Management Shell, consultez la rubrique Traitement en pipeline.