Erstellen von Filtern in Empfängerbefehlen
Gilt für: Exchange Server 2010 SP2, Exchange Server 2010 SP3
Letztes Änderungsdatum des Themas: 2010-07-28
Es stehen mehrere Exchange-Verwaltungsshellbefehle zur Verfügung, um eine Empfängergruppe zu filtern. Sie können in einem Exchange-Befehl die folgenden Filtertypen erstellen:
Musterfilter
Mit dem Parameter RecipientFilter erstellte benutzerdefinierte Filter
Mit dem Parameter Filter erstellte benutzerdefinierte Filter
Mit dem Parameter ContentFilter erstellte benutzerdefinierte Filter
In Microsoft Exchange Server 2003 und früheren Versionen wird die LDAP-Filtersyntax verwendet, um benutzerdefinierte Adresslisten, globale Adresslisten (GAL), E-Mail-Adressrichtlinien und Verteilergruppen zu erstellen. In Exchange Server 2007 und Exchange Server 2010 ersetzt die OPATH-Filtersyntax die LDAP-Filtersyntax. Exchange unterstützt vorhandene LDAP-Filter, Sie können diese jedoch nicht bearbeiten. Sie können einen LDAP-Filter erst nach einem Upgrade auf einen OPATH-Filter ändern. Weitere Informationen finden Sie unter Aktualisieren benutzerdefinierter LDAP-Filter auf OPATH-Filter.
Inhalt
Musterfilter
Mit dem Parameter "RecipientFilter" erstellte benutzerdefinierte Filter
Mit dem Parameter "Filter" erstellte benutzerdefinierte Filter
Mit dem Parameter "ContentFilter" erstellte benutzerdefinierte Filter
Weitere Informationen zur OPATH-Syntax
Musterfilter
Ein Musterfilter ist ein häufig verwendeter Exchange-Filter, den Sie zur Erfüllung einer Vielzahl von Empfängerfilterkriterien für das Erstellen dynamischer Verteilergruppen, E-Mail-Adressrichtlinien, Adresslisten oder GALs einsetzen können. Musterfilter können entweder mit der Exchange-Verwaltungsshell oder einem Assistenten in der Exchange-Verwaltungskonsole eingesetzt werden. Mit Musterfiltern können Sie die folgenden Vorgänge ausführen:
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 Weitere Informationen finden Sie unter Benutzerdefinierte Attribute.
Die folgenden Parameter werden als Musterfilter betrachtet:
IncludedRecipients
ConditionalCompany
ConditionalDepartment
ConditionalStateOrProvince
ConditionalCustomAttribute1–15.
Musterfilter stehen für die folgenden Cmdlets zur Verfügung:
Beispiel
In diesem Beispiel wird mithilfe von Musterfiltern und unter Verwendung der Shell eine dynamische Verteilergruppe erstellt. Die Syntax in diesem Beispiel ähnelt der Syntax zum Erstellen einer E-Mail-Adressrichtlinie, Adressrichtlinie oder GAL, ist aber nicht mit dieser identisch. Wenn Sie einen Musterfilter erstellen, sollten Sie sich die folgenden Fragen stellen:
Aus welcher Organisationseinheit (Organizational Unit, OU) sollen Empfänger eingeschlossen werden? (Diese Frage entspricht dem Parameter RecipientContainer.)
Hinweis
Das Auswählen der OU für diesen Zweck gilt nur für das Erstellen dynamischer Verteilergruppen, nicht für das Erstellen von E-Mail-Adressrichtlinien, Adresslisten oder GALs.
Welche Empfängertypen sollen einbezogen werden? (Diese Frage entspricht dem Parameter IncludedRecipients.)
Welche zusätzlichen Bedingungen sollen in den Filter aufgenommen werden? (Diese Frage entspricht den Parametern ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince und ConditionalCustomAttribute.)
In diesem Beispiel wird die dynamische Verteilergruppe "Contoso Finance" für Postfächer in der OU "Contoso.com/Users" erstellt. Zusätzlich wird eine Bedingung angegeben, nach der nur Empfänger einbezogen werden, bei denen das Attribut Department als "Finance" definiert ist und deren Attribut Company den Wert "Contoso" aufweist.
New-DynamicDistributionGroup -Name "Contoso Finance" -OrganizationalUnit Contoso.com/Users -RecipientContainer Contoso.com/Users -IncludedRecipients MailboxUsers -ConditionalDepartment "Finance" -ConditionalCompany "Contoso"
In diesem Beispiel werden die Eigenschaften dieser neuen dynamischen Verteilergruppe angezeigt.
Get-DynamicDistributionGroup -Identity "Contoso Finance" | Format-List *Recipient*,Included*
Zurück zum Seitenanfang
Mit dem Parameter "RecipientFilter" erstellte benutzerdefinierte Filter
Wenn Musterfilter nicht Ihren Anforderungen für das Erstellen oder Ändern dynamischer Verteilergruppen, E-Mail-Adressrichtlinien und Adresslisten entsprechen, können Sie mithilfe des Parameters RecipientFilter einen benutzerdefinierten Filter erstellen.
Der Empfängerfilterparameter steht für die folgenden Cmdlets zur Verfügung:
Weitere Informationen zu den filterbaren Eigenschaften, die Sie mit dem Parameter RecipientFilter verwenden können, finden Sie unter Filterbare Eigenschaften für den Parameter "-RecipientFilter".
Beispiel
In diesem Beispiel wird der Parameter RecipientFilter zum Erstellen einer dynamischen Verteilergruppe verwendet. Die Syntax in diesem Beispiel ähnelt der Syntax zum Erstellen einer E-Mail-Adressrichtlinie, Adressliste oder GAL, ist aber nicht mit dieser identisch.
In diesem Beispiel wird anhand von benutzerdefinierten Filtern eine dynamische Verteilergruppe für Postfächer erstellt, deren Attribut Company als "Contoso" definiert ist und deren Attribut Office den Wert "North Building" aufweist.
New-DynamicDistributionGroup -Name AllContosoNorth -OrganizationalUnit contoso.com/Users -RecipientFilter { ((RecipientType -eq 'UserMailbox') -and (Company -eq 'Contoso') -and (Office -eq 'North Building')) }
Zurück zum Seitenanfang
Mit dem Parameter "Filter" erstellte benutzerdefinierte Filter
Sie können mit dem Parameter Filter die Ergebnisse eines Befehls filtern und so angeben, welche Objekte abgerufen werden sollen. Anstatt beispielsweise alle Benutzer oder Gruppen abzurufen, können Sie mehrere Benutzer oder Gruppen angeben, die mit einer Filterzeichenfolge abgerufen werden sollen. Mit diesem Filtertyp werden weder die Konfiguration noch Attribute von Objekten geändert. Es wird lediglich die Gruppe von Objekten geändert, die durch den Befehl zurückgegeben wird.
Wenn der Parameter Filter zum Ändern der Ergebnisse von Befehlen verwendet wird, ist dies eine sogenannte serverseitige Filterung. Bei der serverseitigen Filterung werden der Befehl und der Filter zur Verarbeitung an den Server übergeben. Die Shell unterstützt auch 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.
Um die filterbaren Eigenschaften für Cmdlets zu ermitteln, die den Parameter Filter verwenden, können Sie den Befehl Get für ein Objekt ausführen und die Ausgabe durch Weiterleitung des Parameters Format-List formatieren. Die meisten der zurückgegebenen Werte stehen zur Verwendung im Parameter Filter zur Verfügung. Das folgende Beispiel gibt eine detaillierte Liste für das Postfach "Ayla" zurück.
Get-Mailbox -Identity Ayla | Format-List
Der Parameter Filter steht für die folgenden Cmdlets zur Verfügung:
Weitere Informationen zu den filterbaren Eigenschaften, die Sie mit dem Parameter Filter verwenden können, finden Sie unter Filterbare Eigenschaften für den Parameter "-Filter".
Beispiel
In diesem Beispiel wird der Parameter Filter verwendet, um Informationen zu Benutzern zurückzugeben, bei denen das Wort "Manager" im Titel erscheint.
Get-User -Filter {Title -like '*Manager*'}
Zurück zum Seitenanfang
Mit dem Parameter "ContentFilter" erstellte benutzerdefinierte Filter
Sie können den Parameter ContentFilter verwenden, um bei Verwendung des Cmdlets New-MailboxExportRequest spezifische Nachrichteninhalte zu exportieren. Wenn über den Befehl eine Nachricht gefunden wird, die mit dem Inhaltsfilter übereinstimmt, wird die Nachricht in eine PST-Datei exportiert.
Beispiel
In diesem Beispiel wird eine Exportanforderung erstellt, die das Postfach von Ayla nach Nachrichten durchsucht, deren Text die Zeichenfolge "company prospectus" enthält. Wird diese Zeichenfolge gefunden, exportiert der Befehl alle entsprechenden Nachrichten in eine PST-Datei.
New-MailboxExportRequest -Mailbox Ayla -ContentFilter {Body -like "*company prospectus*"}
Weitere Informationen zu den filterbaren Eigenschaften, die Sie mit dem Parameter ContentFilter verwenden können, finden Sie unter Filterbare Eigenschaften für den Parameter "-ContentFilter".
Zurück zum Seitenanfang
Weitere 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 Klammern { }.
Setzen Sie vor alle Operatoren einen Bindestrich. Zu den am häufigsten verwendeten Operatoren gehören:
-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. Bei Verwendung eines Platzhalterzeichens müssen Sie den Operator like anstelle des Operators eq verwenden. 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.
Führen Sie die folgenden Befehle aus, um Informationen zu den verwendbaren Operatoren abzurufen:
Help about_logical_operator
Help about_comparison_operator
Mit den meisten Eigenschaften von Empfängertypen können Filterzeichenfolgen erstellt werden. Weitere Informationen zu filterbaren Eigenschaften, die in Verbindung mit einem bestimmten Cmdlet verwendet werden können, finden Sie in den Cmdlet-Referenzthemen unter Verwenden von PowerShell mit Exchange 2010 (Exchange-Verwaltungsshell).
Zurück zum Seitenanfang
© 2010 Microsoft Corporation. Alle Rechte vorbehalten.