New-DynamicDistributionGroup (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-10-23
Verwenden Sie das Cmdlet New-DynamicDistributionGroup, um eine neue dynamische Verteilergruppe zu erstellen.
Syntax
New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]
New-DynamicDistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -RecipientFilter <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]
Detaillierte Beschreibung
Eine dynamische Verteilergruppe fragt E-Mail-aktivierte Objekte des Active Directory-Verzeichnisdiensts ab und erstellt die Gruppenmitgliedschaft basierend auf den Ergebnissen. Die Gruppenmitgliedschaft wird jeweils neu berechnet, wenn eine E-Mail-Nachricht an die Gruppe gesendet wird. Die mit Exchange bereitgestellten Abfragefilter sind auf eine beliebige Kombination der folgenden Parameter beschränkt:
ConditionalCompany
ConditionalCustomAttribute N (wobei N ein Wert von 1 bis 15 ist)
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients
Sie können auch eine beliebige benutzerdefinierte Abfrage mithilfe des Parameters RecipientFilter erstellen.
Damit Sie das Cmdlet New-DynamicDistributionGroup ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Empfängeradministrator
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
IncludedRecipients |
Erforderlich |
System.Nullable |
Der Parameter IncludedRecipients filtert die Empfängertypen, aus denen die dynamische Verteilergruppe erstellt wird. Der Parameter IncludedRecipients kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. Die verfügbaren Werte für den Parameter IncludedRecipients sind AllRecipients, MailboxUsers, Resources, MailContacts, MailGroups, Mail Users und None. Der Wert AllRecipients kann nur alleine verwendet werden. Werden mehrere Werte des Parameters IncludedRecipients durch Kommas getrennt, wird der Boolesche Operator OR angewendet. |
Name |
Erforderlich |
System.String |
Der Parameter Name gibt den Namen der dynamischen Verteilergruppe an. Wenn der Parameter DisplayName nicht angegeben wird, wird der Wert von Name ebenfalls für DisplayName verwendet. Der Wert Name darf 64 Zeichen nicht überschreiten. Wenn die Werte von Name und DisplayName unterschiedlich sind:
|
OrganizationalUnit |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Der Parameter OrganizationalUnit gibt an, wo die dynamische Verteilergruppe in Active Directory erstellt werden soll, indem die Syntax mit kanonischem Namen verwendet wird. |
RecipientFilter |
Erforderlich |
System.String |
Der Parameter RecipientFilter filtert die E-Mail-aktivierten Empfänger, aus denen die dynamische Verteilergruppe erstellt wird. RecipientFilter kann nicht verwendet werden, wenn einer der folgenden Parameter angegeben wurde:
RecipientFilter verwendet die Weitere Informationen über die filterbaren Eigenschaften finden Sie unter Filterbare Eigenschaften für den Parameter "-RecipientFilter". |
Alias |
Optional |
System.String |
Der Parameter Alias gibt den Alias der dynamischen Verteilergruppe an. Der Wert von Alias wird verwendet, um die primäre SMTP-E-Mail-Adresse (Simple Mail Transfer Protocol) für die dynamische Verteilergruppe zu generieren. Der Wert von Alias darf keine Leerzeichen enthalten. Wenn der Parameter Alias nicht angegeben wird, wird der Wert von Name als Wert des Parameters Alias verwendet, wobei eventuell im Parameter Name enthaltene Leerzeichen in Unterstrichzeichen (_) konvertiert werden. |
ConditionalCompany |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter ConditionalCompany filtert die Postfachbenutzer oder E-Mail-aktivierten Kontakte, aus denen die dynamische Verteilergruppe erstellt wird. Werden mehrere Werte des Parameters ConditionalCompany durch Kommas getrennt, wird der Boolesche Operator OR angewendet. |
ConditionalCustomAttribute1 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute1 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute10 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute10 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute11 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute11 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute12 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute12 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute13 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute13 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute14 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute14 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute15 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute15 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute2 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute2 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute3 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute3 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute4 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute4 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute5 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute5 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute6 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute6 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute7 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute7 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute8 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute8 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalCustomAttribute9 |
Optional |
System.String |
Mit dem Parameter ConditionalCustomAttribute9 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
ConditionalDepartment |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter ConditionalDepartment filtert die Postfachbenutzer oder E-Mail-aktivierten Kontakte, aus denen die dynamische Verteilergruppe erstellt wird. ConditionalDepartment kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. Werden mehrere Werte des Parameters ConditionalDepartment durch Kommas getrennt, wird der Boolesche Operator OR angewendet. |
ConditionalStateOrProvince |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter ConditionalStateOrProvince filtert die Postfachbenutzer oder E-Mail-aktivierten Kontakte, aus denen die dynamische Verteilergruppe erstellt wird. ConditionalStateOrProvince kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. Werden mehrere Werte des Parameters ConditionalStateOrProvince durch Kommas getrennt, wird der Boolesche Operator OR angewendet. |
DisplayName |
Optional |
System.String |
Der Parameter DisplayName gibt den Namen der dynamischen Verteilergruppe in der Exchange-Verwaltungskonsole und in der globalen Adressliste (GAL) von Exchange an. Wenn der Parameter DisplayName nicht angegeben wird, wird der Wert des Parameters Name ebenfalls für DisplayName verwendet. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in Active Directory schreibt, fügen Sie den Parameter DomainController hinzu. |
RecipientContainer |
Optional |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Der Parameter RecipientContainer filtert die Empfänger, aus denen die dynamische Verteilergruppe erstellt wird, basierend auf ihrem Standort in Active Directory. Der Wert von RecipientContainer kann der kanonische Name einer Organisationseinheit (Organizational Unit, OU) oder Domäne sein. Wenn kein Wert für RecipientContainer angegeben wird, ist der Standardsuchfilter der Speicherort der dynamischen Verteilergruppe in Active Directory. Dieser Speicherort wird mithilfe des Parameters OrganizationalUnit angegeben. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Wenn ein vorhandenes Objekt an den Parameter TemplateInstance übergeben wird, verwendet der Befehl die Konfiguration dieses Objekts zum Erstellen einer Kopie des Objekts. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Das folgende Codebeispiel zeigt die Verwendung des Befehls New-DynamicDistributionGroup.
Das erste Beispiel erstellt eine neue dynamische Verteilergruppe namens Marketing Group im Benutzercontainer in der Domäne "Contoso.com". Die dynamische Verteilergruppe Marketing Group enthält alle Postfachbenutzer bzw. E-Mail-aktivierten Kontakte, die in der gesamten Domäne Contoso.com zu finden sind, die über ein Feld Abteilung mit dem Wert Marketing oder Sales verfügen.
Das zweite Beispiel erstellt mithilfe des Parameters RecipientFilter eine dynamische Verteilergruppe namens Pacific Northwest im Benutzercontainer in der Domäne Contoso.com. Die dynamische Verteilergruppe Pacific Northwest enthält alle Postfachbenutzer, die in der gesamten Domäne Contoso.com zu finden sind, die über ein Feld Bundesland/Kanton mit dem Wert Washington oder Oregon verfügen.
New-DynamicDistributionGroup -Name "Marketing Group" -Alias "Marketing_Group" -IncludedRecipients "MailboxUsers,MailContacts" -OrganizationalUnit "Contoso.com/Users" -ConditionalDepartment "Marketing","Sales" -RecipientContainer "Contoso.com"
New-DynamicDistributionGroup -Name "Pacific Northwest" -Alias "Pacific_Northwest" -OrganizationalUnit "Contoso.com/Users" -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington' -or StateOrProvince -eq 'Oregon')))} -RecipientContainer "Contoso.com"