Freigeben über


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:

  • Name gibt den Namen der dynamischen Verteilergruppe in Active Directory-Benutzer und -Computer und im Feld Gruppenname in der Exchange-Verwaltungskonsole an.

  • DisplayName gibt den Namen der dynamischen Verteilergruppe in der Exchange-Verwaltungskonsole und in der globalen Adressliste (GAL) von Exchange an.

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:

  • IncludedRecipients

  • ConditionalCompany

  • ConditionalCustomAttribute N (wobei N ein Wert von 1 bis 15 ist)

  • ConditionalDepartment

  • ConditionalStateOrProvince

RecipientFilter verwendet die OPath-Syntax für die Abfrage von Active Directory und zum Filtern der Empfänger.

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"