Benutzerdefinierte AttributeCustom attributes

Zusammenfassung: Erfahren Sie, wie benutzerdefinierte Attribute in Exchange 2016 zum Hinzufügen von Informationen über den E-Mail-Empfänger verwendet werden.Summary: Learn to use the custom attributes in Exchange 2016 to add information about a mail recipient.

Exchange 2016 umfasst 15 Erweiterungsattribute, die Sie verwenden können, um Informationen über einen Empfänger hinzuzufügen, z. B. eine Mitarbeiter-ID, eine Organisationseinheit (Organizational Unit, OU) oder einen anderen benutzerdefinierten Wert, für den kein Attribut vorhanden ist.Exchange 2016 includes 15 extension attributes that you can use to add information about a recipient, such as an employee ID, organizational unit (OU), or some other custom value for which there isn't an existing attribute.

Wenn Sie in früheren Versionen von Exchange diese Informationen in Active Directory speichern wollten, mussten Sie ein Attribut durch Erweitern des Active Directory-Schemas erstellen. Eine Schemaerweiterung erfordert Planung, die Beschaffung von Objekt-IDs (OIDs) für neue Attribute sowie das Testen des Erweiterungsprozesses in einer Testumgebung, bevor die Erweiterung in einer Produktionsumgebung implementiert werden kann. In Exchange 2016 können Schemaerweiterungen nicht in Empfängerfiltern verwendet werden, die von Adresslisten, E-Mail-Adressrichtlinien und dynamischen Verteilergruppen genutzt werden.In earlier versions of Exchange, if you wanted to store this information in Active Directory, you had to create an attribute by extending the Active Directory schema. Schema extension requires planning, procuring object identifiers (OIDs) for new attributes, and testing the extension process in a test environment before you implement it in a production environment. Exchange 2016 doesn't let you use schema extensions in recipient filters that are used by address lists, e-mail address policies, and dynamic distribution groups.

Die benutzerdefinierte Attribute für Exchange 2016 verfügbar sind in Active Directory als Ms-Exch-Erweiterung-Attribut1 über Ms-Exch-Erweiterung-Attribute15gekennzeichnet. In der Exchange-Verwaltungsshell werden die entsprechenden Parameter CustomAttribute1 über CustomAttribute15. Diese Attribute werden keine Exchange-Komponenten verwendet. Sie können zum Speichern von Active Directory-Daten ohne Active Directory-Schema erweitern verwendet werden.The custom attributes available to Exchange 2016 are labeled in Active Directory as ms-Exch-Extension-Attribute1 through ms-Exch-Extension-Attribute15. In the Exchange Management Shell, the corresponding parameters are CustomAttribute1 through CustomAttribute15. These attributes aren't used by any Exchange components. They can be used to store Active Directory data without having to extend the Active Directory schema.

Vorteile von benutzerdefinierten AttributenAdvantages of custom attributes

Bei der Verwendung von benutzerdefinierten Attributen gibt es mehrere Vorteile:There are several advantages to using custom attributes:

  • Sie vermeiden das Erweitern des Active Directory-Schemas.You avoid extending the Active Directory schema.

  • Sie müssen die Arbeit nicht erledigen, da die Attribute vom Exchange Setup erstellt werden.You don't have to do the work, because the attributes are created by Exchange Setup.

  • Sie können die Attribute über die Exchange-Verwaltungskonsole (EAC) oder die Exchange-Verwaltungsshell verwalten. Sie müssen zum Füllen und Anzeigen der Attribute keine benutzerdefinierten Steuerelemente erstellen oder Skripts schreiben.You can use the Exchange admin center (EAC) or the Exchange Management Shell to manage the attributes. You don't need to build custom controls or write scripts to populate and display these attributes.

  • Sie können filtern und die Attribute aufgeführt, wiederverwenden, wie Attribute filterbaren Eigenschaften sind, die in dem Filterparameter mit Empfänger Cmdlets wie Get-Mailbox verwendet werden können. Sie können auch in der Exchange-Verwaltungskonsole und der Exchange-Verwaltungsshell verwendet werden, um Filter für E-mail-Adressrichtlinien, Adresslisten und dynamische Verteilergruppen zu erstellen.You can filter and reuse the attributes, as attributes are filterable properties that can be used in the Filter parameter with recipient cmdlets such as Get-Mailbox. They can also be used in the EAC and the Exchange Management Shell to create filters for e-mail address policies, address lists, and dynamic distribution groups.

Mehrwertige benutzerdefinierte AttributeMultivalued custom attributes

Starten WithExchange 2010 Servicepack 2 (SP2), fünf mehrwertige benutzerdefinierte Attribute wurden Exchange zu ermöglichen das Speichern zusätzlicher Informationen für e-Mail-Empfänger, wenn die traditionelle benutzerdefinierte Attribute Ihre Bedürfnisse nicht hinzugefügt. Die ExtensionCustomAttribute1 ExtensionCustomAttribute5 -Parameter kann bis zu 1.300 Werte enthalten. Sie können mehrere Werte als eine durch Trennzeichen getrennte Liste angeben. Die folgenden Cmdlets unterstützen diese neuen Parameter:Starting withExchange 2010 Service Pack 2 (SP2), five multivalued custom attributes were added to Exchange to allow you to store additional information for mail recipients if the traditional custom attributes didn't meet your needs. The ExtensionCustomAttribute1 to ExtensionCustomAttribute5 parameters can hold up to 1,300 values each. You can specify multiple values as a comma-delimited list. The following cmdlets support these new parameters:

Weitere Informationen zu mehrwertigen Eigenschaften finden Sie unter Modifying multivalued properties.For more information about multivalued properties, see Modifying multivalued properties.

Beispiele für benutzerdefinierte AttributeCustom attribute examples

Ein allgemeines Szenario in vielen Exchange-Bereitstellungen ist, erstellen Sie eine E-mail-Adressenrichtlinie für alle Empfänger in einer Organisationseinheit. Die Organisationseinheit ist nicht filterable-Eigenschaft, die in einer E-mail-Adressrichtlinie oder eine Adressliste des Parameters recipientfilter verwendet werden kann.A common scenario in many Exchange deployments is that of creating an e-mail address policy for all recipients in an OU. The OU isn't a filterable property that can be used in the RecipientFilter parameter of an e-mail address policy or an address list.

Hinweis

Dynamische Verteilergruppen verfügen über einen zusätzlichen Parameter, mit dem Sie diese auf Empfänger in einer bestimmten Organisationseinheit oder einem bestimmten Container beschränken können.Dynamic distribution groups have an additional parameter that you can use to restrict it to recipients in a particular OU or container.

Wenn die Empfänger in einer bestimmten Organisationseinheit nicht über gemeinsame Eigenschaften wie Abteilung oder Standort verfügen, nach denen Sie filtern können, können Sie eines der benutzerdefinierten Attribute mit einem gemeinsamen Wert füllen, wie in diesem Beispiel gezeigt.If the recipients in a particular OU don't share any common properties that you can filter by, such as department or location, you can populate one of the custom attributes with a common value, as shown in this example.

Get-Mailbox -OrganizationalUnit Sales | Set-Mailbox CustomAttribute1 "SalesOU"

Anschließend können jetzt Sie eine E-mail-Adressenrichtlinie für alle Empfänger erstellen, die CustomAttribute1 -Eigenschaft, die gleich SalesOU, wie im folgenden Beispiel dargestellt.With that done, now you can create an e-mail address policy for all recipients that have the CustomAttribute1 property that equals SalesOU, as shown in this example.

New-EmailAddressPolicy -Name "Sales" -RecipientFilter { CustomAttribute1 -eq "SalesOU"} -EnabledEmailAddressTemplates "SMTP:%s%2g@sales.contoso.com"

Beispiel für benutzerdefiniertes Attribut mit dem Parameter "ConditionalCustomAttributes"Custom attribute example using the ConditionalCustomAttributes parameter

Wenn Sie dynamische Verteilergruppen, e-Mail-Adressrichtlinien oder Adresslisten zu erstellen, müssen Sie den RecipeintFilter -Parameter verwenden, um benutzerdefinierte Attribute angeben. Sie können stattdessen auf ConditionalCustomAttribute15 -Parameter der conditionalcustomattribute1 hinzu .When creating dynamic distribution groups, email address policies, or address lists, you don't need to use the RecipeintFilter parameter to specify custom attributes. You can use the ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters instead.

Dieses Beispiel erstellt eine dynamische Verteilergruppe basierend auf den Empfänger, deren CustomAttribute1 auf SalesOU festgelegt ist.This example creates a dynamic distribution group based on the recipients whose CustomAttribute1 is set to SalesOU.

New-DynamicDistributionGroup -Name "Sales Users and Contacts" -IncludedRecipients "MailboxUsers,MailContacts" -ConditionalCustomAttribute1 "SalesOU"

Hinweis

Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie den Parameter Conditional verwenden. Außerdem können Sie nicht den Parameter Conditional verwenden, wenn Sie den Parameter RecipientFilter verwenden. Wenn Sie weitere Filter hinzufügen möchten, um dynamische Verteilergruppen, E-Mail-Adressrichtlinien oder Adresslisten zu erstellen, sollten Sie den Parameter RecipientFilter verwenden.You need to use the IncludedRecipients parameter if you use a Conditional parameter. In addition, you can't use Conditional parameters if you use the RecipientFilter parameter. If you want to include additional filters to create your dynamic distribution group, email address policies, or address lists, you should use the RecipientFilter parameter.

Beispiel für benutzerdefiniertes Attribut mit dem Parameter "ExtensionCustomAttributes"Custom attribute example using ExtensionCustomAttributes parameter

In diesem Beispiel wird das Postfach für Kweku ExtensionCustomAttribute1 aktualisiert, um darauf hinzuweisen, dass er die folgenden Klassen informative registriert ist haben: MATH307, ECON202 und ENGL300.In this example, the mailbox for Kweku will have ExtensionCustomAttribute1 updated to reflect that he's enrolled in the following educational classes: MATH307, ECON202, and ENGL300.

Set-Mailbox -Identity Kweku -ExtensionCustomAttribute1 MATH307,ECON202,ENGL300

Im nächsten Schritt wird eine dynamische Verteilergruppe für alle Teilnehmer MATH307 registriert erstellt mithilfe des Parameters recipientfilter wobei ExtensionCustomAttribute1 MATH307 gleich ist. Wenn Sie die ExtentionCustomAttributes -Parameter verwenden, können Sie die -eq Operator anstatt der -like Operator.Next, a dynamic distribution group for all students enrolled MATH307 is created by using the RecipientFilter parameter where ExtensionCustomAttribute1 is equal to MATH307. When using the ExtentionCustomAttributes parameters, you can use the -eq operator instead of the -like operator.

New-DynamicDistributionGroup -Name Students_MATH307 -RecipientFilter {ExtensionCustomAttribute1 -eq "MATH307"}

In diesem Beispiel werden Kweku ExtensionCustomAttribute1 Werte aktualisiert, um darauf hinzuweisen, dass er die Klasse ENGL210 hinzugefügt und die ECON202-Klasse entfernt.In this example, Kweku's ExtensionCustomAttribute1 values are updated to reflect that he's added the class ENGL210 and removed the class ECON202.

Set-Mailbox -Identity Kweku -ExtensionCustomAttribute1 @{Add="ENGL210"; Remove="ECON202"}