Destinataire filtre les commandes Management Shell dans ExchangeRecipient filters in Exchange Management Shell commands

Vous pouvez utiliser plusieurs commandes d’Exchange Management Shell pour filtrer un ensemble de destinataires. Vous pouvez créer les types de filtres suivants dans une commande d’Exchange :You can use several Exchange Management Shell commands to filter a set of recipients. You can create the following types of filters in an Exchange command:

  • Filtres prédéfinisPrecanned filters

  • Filtres personnalisés à l’aide du paramètre RecipientFilterCustom filters using the RecipientFilter parameter

  • Filtres personnalisés en utilisant le paramètre de filtreCustom filters using the Filter parameter

  • Filtres personnalisés en utilisant le paramètre ContentFilterCustom filters using the ContentFilter parameter

Les versions antérieures d’Exchange utilisaient LDAP filtrage de syntaxe pour créer des listes d’adresses personnalisées, les listes d’adresses globales (GAL), les stratégies d’adresse de courrier électronique et les groupes de distribution. Dans Exchange Server 2007 et les versions ultérieures, OPATH filtrage de syntaxe remplacé LDAP syntaxe de filtrage.Older versions of Exchange used LDAP filtering syntax to create custom address lists, global address lists (GALs), email address policies, and distribution groups. In Exchange Server 2007 and later versions, OPATH filtering syntax replaced LDAP filtering syntax.

Filtres prédéfinisPrecanned filters

Un filtre prédéfini est un filtre Exchange couramment utilisé que vous pouvez utiliser pour répondre à une variété de critères de filtrage des destinataires pour la création de groupes de distribution dynamiques, des stratégies d’adresse de messagerie, des listes d’adresses ou des listes d’adresses globales. Avec les filtres prédéfinis, vous pouvez utiliser soit Exchange Management Shell ou le centre d’administration Exchange (FAC). À l’aide de filtres prédéfinis, vous pouvez effectuer les opérations suivantes :A precanned filter is a commonly used Exchange filter that you can use to meet a variety of recipient-filtering criteria for creating dynamic distribution groups, email address policies, address lists, or GALs. With precanned filters, you can use either the Exchange Management Shell or the Exchange admin center (EAC). Using precanned filters, you can do the following:

  • Déterminer l’étendue des destinataires.Determine the scope of recipients.

  • Ajouter un filtrage conditionnel basé sur des propriétés, telles qu’une société, un département, un état ou une région.Add conditional filtering based on properties such as company, department, and state or region.

  • Ajouter des attributs personnalisés pour les destinataires. Pour plus d’informations, consultez Attributs personnalisés.Add custom attributes for recipients. For more information, see Custom Attributes.

Les paramètres suivants sont considérés comme des filtres prédéfinis :The following parameters are considered precanned filters:

  • IncludedRecipientsIncludedRecipients

  • ConditionalCompanyConditionalCompany

  • ConditionalDepartmentConditionalDepartment

  • ConditionalStateOrProvinceConditionalStateOrProvince

  • ConditionalCustomAttribute1 à ConditionalCustomAttribute15.ConditionalCustomAttribute1 to ConditionalCustomAttribute15.

Des filtres prédéfinis sont disponibles pour les cmdlets suivantes :Precanned filters are available for the following cmdlets:

ExempleExample

Cet exemple décrit l’utilisation de filtres prédéfinis dans Exchange Management Shell pour créer un groupe de distribution dynamique. La syntaxe de cet exemple est similaire mais pas identique à la syntaxe serait permet de 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 :This example describes using precanned filters in the Exchange Management Shell to create a dynamic distribution group. The syntax in this example is similar but not identical to the syntax you would use to create an email address policy, address list, or GAL. When creating a precanned filter, you should ask the following questions:

  • Quelle unité d’organisation (UO) vous voulez inclure les destinataires ? (Cette question correspond au paramètre RecipientContainer ne .)From which organizational unit (OU) do you want to include recipients? (This question corresponds to the RecipientContainer parameter.)

Note

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.Selecting the OU for this purpose applies only when creating dynamic distribution groups, and not when creating email address policies, address lists, or GALs.

  • Le type de destinataires que vous souhaitez inclure ? (Cette question correspond au paramètre IncludedRecipients .)What type of recipients do you want to include? (This question corresponds to the IncludedRecipients parameter.)

  • Quelles conditions supplémentaires que vous souhaitez inclure dans le filtre ? (Cette question correspond à la ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince_et _ConditionalCustomAttribute paramètres.)What additional conditions do you want to include in the filter? (This question corresponds to the ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince, and ConditionalCustomAttribute parameters.)

Cet exemple crée le groupe de distribution dynamique Contoso Finance pour les boîtes aux lettres de l’utilisateur dans l’unité d’organisation Contoso.com/Users et spécifie la condition d’inclure uniquement les destinataires qui ont cet attribut défini comme la Finance et de la **société ** attribut défini en tant que Contoso.This example creates the dynamic distribution group Contoso Finance for user mailboxes in the OU Contoso.com/Users and specifies the condition to include only recipients who have the Department attribute defined as Finance and the Company attribute defined as 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.This example displays the properties of this new dynamic distribution group.

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

Filtres personnalisés à l’aide du paramètre RecipientFilterCustom filters using the RecipientFilter parameter

Si les filtres prédéfinis ne répondent pas à vos besoins pour créer ou modifier des groupes de distribution dynamiques, des stratégies d’adresse de messagerie, et les listes d’adresses, vous pouvez créer un filtre personnalisé en utilisant le paramètre RecipientFilter .If precanned filters don't meet your needs for creating or modifying dynamic distribution groups, email address policies, and address lists, you can create a custom filter by using the RecipientFilter parameter.

Le paramètre de filtrage des destinataires est disponible pour les cmdlets suivantes :The recipient filter parameter is available for the following cmdlets:

Pour plus d’informations sur les propriétés filtrables, que vous pouvez utiliser avec le paramètre RecipientFilter , consultez les propriétés filtrables pour le paramètre RecipientFilter.For more information about the filterable properties you can use with the RecipientFilter parameter, see Filterable properties for the RecipientFilter parameter.

ExempleExample

L’exemple suivant utilise le paramètre RecipientFilter pour créer un groupe de distribution dynamique. La syntaxe de cet exemple est similaire mais pas identique à la syntaxe que vous utilisez pour créer une stratégie d’adresse de messagerie, une liste d’adresses ou une liste d’adresses globale.The following example uses the RecipientFilter parameter to create a dynamic distribution group. The syntax in this example is similar but not identical to the syntax you use to create an email address policy, address list, or GAL.

Cet exemple utilise les filtres personnalisés pour créer un groupe de distribution dynamique des boîtes aux lettres qui ont l’attribut société défini en tant que Contoso et l’attribut Office défini en tant que construction du Nord.This example uses custom filters to create a dynamic distribution group for user mailboxes that have the Company attribute defined as Contoso and the Office attribute defined as North Building.

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

Filtres personnalisés à l’aide du paramètre FilterCustom filters using the Filter parameter

Vous pouvez utiliser le paramètre de filtre pour filtrer les résultats d’une commande pour spécifier les objets à récupérer. Par exemple, au lieu d’extraire tous les utilisateurs ou les groupes, vous pouvez spécifier un ensemble d’utilisateurs ou de groupes à l’aide d’une chaîne de filtrage. Ce type de filtre ne modifie pas une configuration ou les attributs des objets. Il modifie uniquement le jeu d’objets renvoyée par la commande.You can use the Filter parameter to filter the results of a command to specify which objects to retrieve. For example, instead of retrieving all users or groups, you can specify a set of users or groups by using a filter string. This type of filter doesn't modify any configuration or attributes of objects. It only modifies the set of objects that the command returns.

À l’aide du paramètre de filtre pour modifier la commande résultats est appelé filtrage côté serveur. Filtrage côté serveur envoie la commande et le filtre au serveur pour traitement. Exchange Management Shell prend également en charge le filtrage côté client, dans lequel la commande récupère tous les objets du serveur, puis applique le filtre dans la fenêtre de la console locale. Pour effectuer un filtrage côté client, utilisez l’applet de commande Where-Object . Pour plus d’informations sur le filtrage côté serveur et côté client, reportez-vous à la section « Comment pour filtrer des données » dans utilisation de sortie de la commande.Using the Filter parameter to modify command results is known as server-side filtering. Server-side filtering submits the command and the filter to the server for processing. The Exchange Management Shell also supports client-side filtering, in which the command retrieves all objects from the server and then applies the filter in the local console window. To perform client-side filtering, use the Where-Object cmdlet. For more information about server-side and client-side filtering, see "How to Filter Data" in Working with Command Output.

Pour rechercher les propriétés filtrables d’applets de commande qui ont le paramètre de filtre , vous pouvez exécuter la commande Get par rapport à un objet et le format de la sortie par le paramètre de Format-List de traitement « pipeline ». La plupart des valeurs renvoyées seront disponible pour une utilisation dans le paramètre de filtre . L’exemple suivant renvoie une liste détaillée de la boîte aux lettres de Florence.To find the filterable properties for cmdlets that have the Filter parameter, you can run the Get command against an object and format the output by pipelining the Format-List parameter. Most of the returned values will be available for use in the Filter parameter. The following example returns a detailed list for the mailbox Ayla.

Get-Mailbox -Identity Ayla | Format-List

Le paramètre de filtre est disponible pour les applets de commande destinataire suivant :The Filter parameter is available for the following recipient cmdlets:

Pour plus d’informations sur les propriétés filtrables, que vous pouvez utiliser le paramètre de filtre , consultez propriétés filtrables pour le paramètre de filtre.For more information about the filterable properties you can use with the Filter parameter, see Filterable properties for the Filter parameter.

ExempleExample

Cet exemple utilise le paramètre de filtre pour retourner des informations sur les utilisateurs dont le titre contient le mot « gestionnaire ».This example uses the Filter parameter to return information about users whose title contains the word "manager".

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

Filtres personnalisés à l’aide du paramètre ContentFilterCustom filters using the ContentFilter parameter

Vous pouvez utiliser le paramètre ContentFilter pour sélectionner le contenu de message spécifique à exporter à l’aide de l’applet de commande New-MailboxExportRequest . Si la commande trouve un message qui contient la correspondance avec le filtre de contenu, elle exporte le message dans un fichier .pst.You can use the ContentFilter parameter to select specific message content to export when using the New-MailboxExportRequest cmdlet. If the command finds a message that contains the match to the content filter, it exports the message to a .pst file.

ExempleExample

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.This example creates an export request that searches Ayla's mailbox for messages where the body contains the phrase "company prospectus". If that phrase is found, the command exports all messages with that phrase to a .pst file.

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

Pour plus d’informations sur les propriétés filtrables, que vous pouvez utiliser avec le paramètre ContentFilter , consultez Propriétés filtrables pour le paramètre ContentFilter.For more information about the filterable properties you can use with the ContentFilter parameter, see Filterable Properties for the ContentFilter Parameter.

Informations supplémentaires sur la syntaxe OPATHAdditional OPATH syntax information

Pour créer vos propres filtres personnalisés, tenez compte des éléments suivants :When creating your own custom filters, be aware of the following:

  • Utilisation d’accolades {} autour de toute la chaîne de filtre OPATH avec les paramètres de filtre ou RecipientFilter .Use braces { } around the entire OPATH filter string with the Filter or RecipientFilter parameters.

  • Insérez un trait d’union avant tous les opérateurs. Les opérateurs les plus courants sont notamment les suivants :Include the hyphen before all operators. The most common operators include:

    • - et-and

    • - ou-or

    • -pas-not

    • -eq (signe égal)-eq (equals)

    • -ne (non égal)-ne (not equal)

    • -lt (inférieur à)-lt (less than)

    • -gt (supérieur à)-gt (greater than)

    • -comme (comparaison de chaînes)-like (string comparison)

    • -notlike (comparaison de chaînes)-notlike (string comparison)

  • La plupart des propriétés des paramètres de filtre et RecipientFilter 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 est utilisé pour rechercher le modèle correspond à dans les types complexes, telles que des chaînes, tandis que l’opérateur eq est utilisé pour rechercher une correspondance exacte.Many of the properties for the RecipientFilter and Filter parameters accept wildcard characters. If you use a wildcard character, use the like operator instead of the eq operator. The like operator is used to find pattern matches in rich types, such as strings, whereas the eq operator is used to find an exact match.

  • Pour plus d’informations sur les opérateurs que vous pouvez utiliser, consultez :For more information about operators you can use, see:

Documentation du filtrage des destinatairesRecipient filter documentation

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.The following table contains links to topics that will help you learn more about the filterable properties that you can use with Exchange recipient commands.

RubriqueTopic DescriptionDescription
Propriétés filtrables pour le paramètre RecipientFilterFilterable properties for the RecipientFilter parameter Pour en savoir plus sur les propriétés filtrables pour le paramètre RecipientFilter .Learn more about the filterable properties for the RecipientFilter parameter.
Propriétés filtrables pour le paramètre de filtreFilterable properties for the Filter parameter Pour en savoir plus sur les propriétés filtrables pour le paramètre de filtre .Learn more about the filterable properties for the Filter parameter.