Erstellen von Filtern in Empfängerbefehlen

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-11-15

Mehrere Befehle der Exchange-Verwaltungsshell ermöglichen das Filtern einer Empfängergruppe. Durch die Exchange-Befehle werden zwei Filterungstypen bereitgestellt: das Filtern von Ergebnissen und das Filtern von Attributen innerhalb eines Befehls.

Um Ergebnisse zu filtern, müssen Sie einen benutzerdefinierten Filter verwenden. Um Attribute innerhalb eines Befehls zu filtern, können Sie entweder einen Musterfilter oder einen benutzerdefinierten Filter verwenden.

Bei einem Musterfilter handelt es sich um einen gängigen Exchange 2007-Filter, dessen Verwendung verschiedene Kriterien der Empfängerfilterung erfüllt. Musterfilter können beispielsweise für die folgenden Vorgänge verwendet werden:

  • Bestimmen des Empfängerbereichs

  • Hinzufügen bedingter Filter auf Grundlage von Eigenschaften, z. B. Firma, Abteilung, Bundesland oder Region

  • Hinzufügen benutzerdefinierter Attribute für Empfänger

Wenn Ihre Filteranforderungen über diesen Rahmen hinausreichen, können Sie mit der OPATH-Filtersyntax einen benutzerdefinierten Filter erstellen, um auf sämtliche Eigenschaften der Exchange-Verwaltungsshell Bezug zu nehmen.

Filterergebnisse

Der erste Filterungstyp ermöglicht das Filtern der Ergebnisse eines Befehls. Beispielsweise verfügen die Cmdlets Get-User, Get-Recipient, Get-Mailbox, Get-MailUser, Get-Contact, Get-MailContact, Get-Group, Get-DistributionGroup und Get-DynamicDistributionGroup alle über den Parameter Filter, mit dem Sie angeben können, welche Benutzer oder Gruppen mit dem jeweiligen Befehl abgerufen werden sollen. Anstatt alle Benutzer oder Gruppen abzurufen, können Sie mehrere Benutzer oder Gruppen angeben, die mit einer Filterzeichenfolge abgerufen werden sollen. Dieser Filtertyp ändert weder die Konfiguration noch Attribute von Objekten. Er ändert lediglich die Gruppe von Objekten, die durch den Befehl zurückgegeben wird.

Weitere Informationen über die filterbaren Eigenschaften, die Sie mit dem Parameter -Filter verwenden können, finden Sie unter folgenden Themen:

Hinweis

Wenn der Parameter Filter zum Ändern der Ergebnisse von Befehlen verwendet wird, ist dies serverseitige Filterung. Bei der serverseitigen Filterung werden der Befehl und der Filter zur Verarbeitung an den Server übergeben. Die Exchange-Verwaltungsshell unterstützt ebenfalls die clientseitige Filterung, bei der der Befehl alle Objekte vom Server abruft und den Filter dann im lokalen Konsolenfenster anwendet. Die clientseitige Filterung wird mit dem Cmdlet Where-Object durchgeführt. Weitere Informationen zu server- und clientseitiger Filterung finden Sie unter "Filtern von Daten" in Arbeiten mit Ausgaben von Befehlen.

Filtern von Attributen innerhalb eines Befehls

Beim zweiten Filterungstyp können Sie angeben, welche Attribute der Befehl verwenden soll. Sie können einen Musterfilter verwenden oder einen eigenen benutzerdefinierten Filter erstellen. Beispielsweise verfügen die Cmdlets New-DynamicDistributionGroup, Set-DynamicDistributionGroup, New-EmailAddressPolicy, Set-EmailAddressPolicy, New-AddressList, Set-AddressList, New-GlobalAddressList und Set-GlobalAddressList alle über die Parameter IncludedRecipients, ConditionalCompany, ConditionalDepartment und ConditionalStateOrProvince. Diese ermöglichen Ihnen die Verwendung von Musterfiltern, um die Gruppe von Benutzern zu bestimmen, auf die der Befehl angewendet wird. Diese Cmdlets besitzen ebenfalls den Parameter RecipientFilter, der Ihnen die Erstellung eines eigenen benutzerdefinierten Filters ermöglicht. Mit dem Musterfilter oder mit dem benutzerdefinierten Filter können Sie die Empfänger angeben, die in eine dynamische Verteilergruppe, eine E-Mail-Adressenrichtlinie, eine Adressliste oder eine globale Adressliste (GAL) eingeschlossen werden sollen.

Weitere Informationen über die filterbaren Eigenschaften, die Sie mit dem Parameter -RecipientFilter verwenden können, finden Sie unter folgenden Themen:

Erstellen benutzerdefinierter Filter

Um mit dem Parameter Filter einen benutzerdefinierten Filter für die Ergebnisse eines Befehls oder mit dem Parameter RecipientFilter einen benutzerdefinierten Filter für die Attribute innerhalb eines Befehls zu erstellen, müssen Sie eine Zeichenfolge für den Filter angeben. Die Exchange-Verwaltungsshell verwendet für die Filtersyntax OPath. OPath ist eine Abfragesprache, die für die Abfrage von Objektdatenquellen konzipiert wurde. Dank der Exchange-Verwaltungshell müssen Sie nicht länger die komplizierte LDAP-Syntax (Lightweight Directory Access Protocol) verwenden, mit der in Microsoft Exchange Server 2003 Filter erstellt wurden. Stattdessen können Sie Filter mit der einfachen OPath-Syntax erstellen.

Hinweis

Wenn Sie eine dynamische Verteilergruppe, eine E-Mailadressenrichtlinie, eine Adressliste oder eine globale Adressliste mit Musterfiltern erstellen möchten, können Sie entweder einen Assistenten in der Exchange-Verwaltungskonsole oder die Exchange-Verwaltungsshell verwenden. Wenn Sie eine dynamische Verteilergruppe, eine E-Mailadressenrichtlinie, eine Adressliste oder eine globale Adressliste mit einem benutzerdefinierten Filter erstellen möchten, müssen Sie das entsprechende Cmdlet in der Exchange-Verwaltungsshell mit dem Parameter RecipientFilter verwenden.

Beispiel für Musterfilter

In diesem Beispiel wird die Erstellung einer dynamischen Verteilergruppe mit Musterfiltern beschrieben. Die Syntax in den Beispielbefehlen ähnelt der Syntax, die zum Erstellen einer neuen E-Mail-Adressenrichtlinie, Adressliste oder globalen Adressliste verwenden wird, stimmt jedoch nicht mit ihr überein.

Wenn Sie eine dynamische Verteilergruppe mit dem Assistenten für neue dynamische Verteilergruppen erstellen, müssen Sie die folgenden Filterinformationen auswählen:

  • Organisationseinheit, aus der Empfänger aufgenommen werden sollen

    Hinweis

    Dies gilt nur für die Erstellung dynamischer Verteilergruppen, nicht für die Erstellung von E-Mail-Adressenrichtlinien, Adresslisten oder globalen Adresslisten.

  • Typ der aufzunehmenden Empfänger

  • Zusätzliche Bedingungen, die in den Filter aufgenommen werden sollen

Die folgenden Abbildungen zeigen die Seiten des Assistenten für neue dynamische Verteilergruppen, auf denen Sie die Filterinformationen auswählen.

Abbildung 1   Seite "Filtereinstellungen" des Assistenten für neue dynamische Verteilergruppen

Seite "Filtereinstellungen"

Abbildung 2   Zur Auswahl der Organisationseinheit auf der Seite "Filtereinstellungen" des Assistenten für neue dynamische Verteilergruppen auf "Durchsuchen" klicken

Auswählen der Seite "Organisationseinheit"

Abbildung 3   Seite "Bedingungen" des Assistenten für neue dynamische Verteilergruppen

Seite "Bedingungen"

Jede dieser Filteroptionen entspricht einem der Musterfilterparameter in dem Befehl New-DynamicDistributionGroup oder Set-DynamicDistributionGroup.

Die erste Filteroption für die Organisationseinheit entspricht dem Parameter RecipientContainer im Befehl. Die zweite Filteroption für den Empfängertyp entspricht dem Parameter IncludedRecipients. Die dritte Filteroption für zusätzliche Bedingungen entspricht den Parametern ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince und ConditionalCustomAttribute.

Hinweis

Der Parameter OrganizationalUnit gibt den Speicherort für die neue dynamische Verteilergruppe nach ihrer Erstellung an. Der Parameter RecipientContainer ist ein Filterparameter, der die Organisationseinheit mit den Empfängern angibt, die der dynamischen Verteilergruppe hinzugefügt werden.

Beispielsweise können Sie im Assistenten für neue dynamische Verteilergruppen Empfänger aus der Organisationseinheit Contoso.com/Users, UserMailbox-Objekte sowie eine Bedingung auswählen, laut der nur Empfänger mit der Abteilung Buchhaltung und der Firma Contoso aufgenommen werden.

Um dieselbe dynamische Verteilergruppe mit der Exchange-Verwaltungsshell zu erstellen, führen Sie den folgenden Befehl aus:

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

Um die Eigenschaften dieser neuen Verteilergruppe anzuzeigen, führen Sie den folgenden Befehl aus:

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

Die Eigenschaft RecipientFilter zeigt die OPath-Filtersyntax an, die zum Erstellen dieser Gruppe verwendet wurde. Die Eigenschaft RecipientFilterType ist auf den Musterfilter gesetzt, d. h., der Filter für diese Gruppe wurde mit den Musterfiltern erstellt. Die Eigenschaft LdapRecipientFilter ist eine schreibgeschützte Eigenschaft, die angibt, welcher LDAP-Filter in vorherigen Versionen von Exchange zum Erstellen dieser Gruppen verwendet wurde.

Beispiel für benutzerdefinierte Filter

In diesem Beispiel wird die Erstellung einer dynamischen Verteilergruppe mit benutzerdefinierten Filtern beschrieben. Die Syntax in den Beispielbefehlen ähnelt der Syntax, die zum Erstellen einer neuen E-Mail-Adressenrichtlinie, Adressliste oder globalen Adressliste verwenden wird, stimmt jedoch nicht mit ihr überein.

Um einen benutzerdefinierten Filter für eine dynamische Verteilergruppe zu erstellen, müssen Sie den Parameter RecipientFilter mit dem Cmdlet New-DynamicDistributionGroup oder Set-DynamicDistributionGroup verwenden.

Wenn Sie beispielsweise eine dynamische Verteilgruppe von Postfachempfängern erstellen möchten, deren Attribut Firma als Contoso definiert und deren Büro das Nordgebäude ist, müssen Sie einen benutzerdefinierten Filter verwenden. Um diese dynamische Verteilergruppe zu erstellen, führen Sie den folgenden Befehl aus:

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

Hinweis

Der Parameter OrganizationalUnit gibt den Speicherort für die neue dynamische Verteilergruppe nach ihrer Erstellung an.

Zusätzliche Informationen zur OPath-Syntax

Bei der Erstellung eigener benutzerdefinierter Filter ist Folgendes zu berücksichtigen:

  • Setzen Sie die gesamte OPath-Syntaxzeichenfolge mit dem Parameter Filter oder RecipientFilter in geschweifte Klammern { }.

  • Setzen Sie vor alle Operatoren einen Bindestrich.

  • Im Folgenden werden die gängigsten Operationen aufgeführt:

    • -and

    • -or

    • -not

    • -eq (gleich)

    • -ne (ungleich)

    • -lt (kleiner als)

    • -gt (größer als)

    • -like (Zeichenfolgenvergleich)

    • -notlike (Zeichenfolgenvergleich)

  • Viele der Eigenschaften für die Parameter -RecipientFilter und -Filter können Platzhalterzeichen annehmen. Wenn Sie ein Platzhalterzeichen verwenden, verwenden Sie den Operator -like anstelle des Operators -eq. Der Operator -like wird zum Suchen nach Musterübereinstimmungen in Rich-Typen (z. B. Zeichenfolgen) verwendet, während der Operator -eq zum Suchen nach einer genauen Übereinstimmung verwendet wird.

  • Mit den folgenden Befehlen können Sie Informationen zu möglichen Operatoren abrufen:

    • Help about_logical_operator

    • Help about_comparison_operator

  • Mit den meisten Eigenschaften von Empfängertypen können Filterzeichenfolgen erstellt werden. Weitere Informationen über filterbare Eigenschaften, die in Verbindung mit einem bestimmten Cmdlet verwendet werden können, finden Sie in den Cmdlet-Referenzthemen in Exchange-Verwaltungsshell (SP1 und SP2).

Weitere Informationen

Weitere Informationen zur Pipeliningausgabe in der Exchange-Verwaltungsshell finden Sie unter Pipelining.