Set-DistributionGroup (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-05

Mithilfe des Cmdlets Set-DistributionGroup können Sie die Einstellungen einer vorhandenen Verteilergruppe ändern.

Syntax

Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WindowsEmailAddress <SmtpAddress>]

Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-Instance <DistributionGroup>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WindowsEmailAddress <SmtpAddress>]

Detaillierte Beschreibung

Verteilergruppen werden zum Konsolidieren von Empfängergruppen an einem einzigen Kontaktpunkt für E-Mail-Nachrichten verwendet. Verteilergruppen können nicht zum Zuweisen von Berechtigungen zu Netzwerkressourcen im Active Directory-Verzeichnisdienst verwendet werden. Sie können mithilfe des Cmdlets Set-DistributionGroup vorhandene Einstellungen überschreiben oder neue Einstellungen hinzufügen.

Damit Sie das Cmdlet Set-DistributionGroup 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 Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

Der Parameter Identity gibt das zu ändernde Objekt an. Der Parameter Identity akzeptiert jeden der folgenden Werte für die Verteilergruppe:

  • Distinguished Name (DN)

  • Kanonischer Name

  • GUID

  • Name

  • Anzeigename

  • Alias

  • Exchange-DN

  • Primäre SMTP-Adresse (Simple Mail Transfer Protocol)

Der Parameter Identity kann nicht zusammen mit dem Parameter Instance verwendet werden.

AcceptMessagesOnlyFrom

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Der Parameter AcceptMessagesOnlyFrom gibt an, welche Postfachbenutzer und E-Mail-aktivierten Kontakte E-Mail-Nachrichten an diese Verteilergruppe senden können. Der Parameter AcceptMessagesOnlyFrom akzeptiert jeden der folgenden Werte als gültige Absender:

  • Distinguished Name (DN)

  • Kanonischer Name

  • GUID

  • Name

  • Anzeigename

  • Alias

  • Exchange-DN

  • Primäre SMTP-E-Mail-Adresse

Standardmäßig ist der Wert für diesen Parameter leer. Hierdurch wird es der Verteilergruppe ermöglicht, Nachrichten von allen Postfachbenutzern und allen E-Mail-aktivierten Kontakten zu akzeptieren.

AcceptMessagesOnlyFromDLMembers

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Der Parameter AcceptMessagesOnlyFromDLMembers gibt an, welche Verteilergruppen E-Mail-Nachrichten an die Verteilergruppe senden können. Für die zulässigen Verteilergruppen kann jeder der folgenden Werte verwendet werden:

  • Distinguished Name (DN)

  • Kanonischer Name

  • GUID

  • Name

  • Anzeigename

  • Legacy-Exchange-DN

  • Primäre SMTP-E-Mail-Adresse

Standardmäßig ist der Wert für diesen Parameter leer. Hierdurch wird es der Verteilergruppe ermöglicht, Nachrichten von allen Verteilergruppen zu akzeptieren.

Alias

Optional

System.String

Der Parameter Alias gibt den Aliasnamen des Objekts an. Der Wert von Alias darf keine Leerzeichen enthalten.

CreateDTMFMap

Optional

System.Boolean

Dieser Parameter gibt an, dass eine DTMF-Zuordnung (Dual Tone Multi-Frequency) für die Verteilergruppe erstellt werden soll.

CustomAttribute1

Optional

System.String

Mit dem Parameter CustomAttribute1 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute10

Optional

System.String

Mit dem Parameter CustomAttribute10 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute11

Optional

System.String

Mit dem Parameter CustomAttribute11 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute12

Optional

System.String

Mit dem Parameter CustomAttribute12 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute13

Optional

System.String

Mit dem Parameter CustomAttribute13 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute14

Optional

System.String

Mit dem Parameter CustomAttribute14 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute15

Optional

System.String

Mit dem Parameter CustomAttribute15 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute2

Optional

System.String

Mit dem Parameter CustomAttribute2 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute3

Optional

System.String

Mit dem Parameter CustomAttribute3 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute4

Optional

System.String

Mit dem Parameter CustomAttribute4 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute5

Optional

System.String

Mit dem Parameter CustomAttribute5 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute6

Optional

System.String

Mit dem Parameter CustomAttribute6 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute7

Optional

System.String

Mit dem Parameter CustomAttribute7 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute8

Optional

System.String

Mit dem Parameter CustomAttribute8 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

CustomAttribute9

Optional

System.String

Mit dem Parameter CustomAttribute9 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern.

DisplayName

Optional

System.String

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

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.

EmailAddresses

Optional

Microsoft.Exchange.Data.ProxyAddressCollection

Der Parameter EmailAddresses gibt den E-Mail-Alias der Verteilergruppe an. Alle gültigen Microsoft Exchange Server 2007-E-Mail-Adresstypen können verwendet werden. Sie können mehrere Werte für den Parameter EmailAddresses angeben, wenn Sie eine durch Kommas getrennte Liste verwenden.

EmailAddressPolicyEnabled

Optional

System.Boolean

Der Parameter EmailAddressPolicyEnabled steuert die Anwendung der E-Mail-Adressenrichtlinien für diese Verteilergruppe. Gültige Werte sind $true oder $false. Der Standardwert lautet "$true". Standardmäßig werden alle anwendbaren E-Mail-Adressenrichtlinien auf diese Verteilergruppe angewendet.

ExpansionServer

Optional

System.String

Der Parameter ExpansionServer gibt den Exchange-Server für die Aufgliederung der Verteilergruppe an. Geben Sie den Server für die Aufgliederung als Exchange-Legacy-DN-Wert ein. Standardmäßig wird der nächstgelegene Exchange Server 2003-Computer oder der nächstgelegene Exchange 2007-Server verwendet, auf dem die Serverfunktion Hub-Transport installiert ist.

GrantSendOnBehalfTo

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[]

Der Parameter GrantSendOnBehalfTo gibt einen Postfachbenutzer an, der im Auftrag dieser Verteilergruppe Nachrichten senden kann. Der Parameter GrantSendOnBehalfTo akzeptiert die folgenden Werte:

  • Distinguished Name (DN)

  • GUID

  • Name

  • Anzeigename

  • Kanonischer Name

  • Legacy-Exchange-DN

  • Alias

  • Primäre SMTP-E-Mail-Adresse

Standardmäßig ist der Wert für GrantSendOnBehalfTo leer. Das bedeutet, dass kein anderer Postfachbenutzer berechtigt ist, Nachrichten im Auftrag dieser Verteilergruppe zu senden.

HiddenFromAddressListsEnabled

Optional

System.Boolean

Der Parameter HiddenFromAddressListsEnabled blendet die Verteilergruppe aus allen Exchange-Adresslisten aus. Gültige Werte sind $true oder $false. Der Standardwert lautet "$false".

Instance

Optional

Microsoft.Exchange.Data.Directory.Management.DistributionGroup

Der Parameter Instance ermöglicht das Übergeben eines vollständigen Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an den Befehl übergeben werden muss.

Der Parameter Instance kann nicht zusammen mit dem Parameter Identity verwendet werden.

MaxReceiveSize

Optional

Microsoft.Exchange.Data.Unlimited

Mit dem Parameter MaxReceiveSize können Sie die zulässige Maximalgröße für E-Mail-Nachrichten festlegen, die an diese Verteilergruppe gesendet werden dürfen. Wenn Sie einen Wert eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:

  • B (Byte)

  • KB (Kilobyte)

  • MB (Megabyte)

  • GB (Gigabyte)

  • TB (Terabyte)

Nicht qualifizierte Werte werden als "Byte" behandelt. Gültige Werte sind 0 bis 2147482624 Byte(s).

Standardmäßig ist der Parameter MaxReceiveSize auf unlimited festgelegt.

MaxSendSize

Optional

Microsoft.Exchange.Data.Unlimited

Mit dem Parameter MaxSendSize können Sie die zulässige Maximalgröße für E-Mail-Nachrichten festlegen, die von dieser Verteilergruppe gesendet werden dürfen. Wenn Sie einen Wert eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:

  • B (Byte)

  • KB (Kilobyte)

  • MB (Megabyte)

  • GB (Gigabyte)

  • TB (Terabyte)

Nicht qualifizierte Werte werden als "Byte" behandelt. Gültige Werte sind 0 bis 2147482624 Byte(s).

Standardmäßig ist der Parameter MaxSendSize auf unlimited festgelegt.

Name

Optional

System.String

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

PrimarySmtpAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

Der Parameter PrimarySmtpAddress gibt die primäre SMTP-Absenderadresse für die Verteilergruppe an. Dieser Parameter ist nur dann von Bedeutung, wenn die Verteilergruppe über mehrere SMTP-E-Mail-Adressen verfügt.

RejectMessagesFrom

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Der Parameter RejectMessagesFrom gibt an, welche Postfachbenutzer und E-Mail-aktivierten Kontakte keine E-Mail-Nachrichten an diese Verteilergruppe senden dürfen. Für die nicht zulässigen Absender kann jeder der folgenden Werte verwendet werden:

  • Distinguished Name (DN)

  • Kanonischer Name

  • GUID

  • Name

  • Anzeigename

  • Legacy-Exchange-DN

  • Primäre SMTP-E-Mail-Adresse

Standardmäßig ist der Wert für diesen Parameter leer. Hierdurch wird es der Verteilergruppe ermöglicht, Nachrichten von allen Postfachbenutzern und allen E-Mail-aktivierten Kontakten zu akzeptieren.

RejectMessagesFromDLMembers

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Der Parameter RejectMessagesFromDLMembers gibt an, welche Verteilergruppen keine E-Mail-Nachrichten an die Verteilergruppe senden dürfen. Für die nicht zulässigen Verteilergruppen kann jeder der folgenden Werte verwendet werden:

  • Distinguished Name (DN)

  • Kanonischer Name

  • GUID

  • Name

  • Anzeigename

  • Legacy-Exchange-DN

  • Primäre SMTP-E-Mail-Adresse

Standardmäßig ist der Wert für diesen Parameter leer. Hierdurch wird es der Verteilergruppe ermöglicht, Nachrichten von allen Verteilergruppen zu akzeptieren.

ReportToManagerEnabled

Optional

System.Boolean

Der Parameter ReportToManagerEnabled ermöglicht das Senden von Übermittlungsberichten an den Verteilergruppenleiter. Gültige Werte sind $true oder $false. Der Standardwert lautet $false.

ReportToOriginatorEnabled

Optional

System.Boolean

Der Parameter ReportToOriginatorEnabled ermöglicht das Senden von Übermittlungsberichten an die Absender der an diese Verteilergruppe gesendeten E-Mail-Nachrichten. Gültige Werte sind $true oder $false. Der Standardwert lautet "$true".

RequireSenderAuthenticationEnabled

Optional

System.Boolean

Der Parameter RequireSenderAuthenticationEnabled legt fest, dass nur E-Mail-Nachrichten von authentifizierten Absendern zugestellt werden können. Wenn der Wert $true lautet, werden nur Nachrichten von authentifizierten Absendern akzeptiert. Gültige Werte sind $true oder $false. Der Standardwert lautet "$true".

SamAccountName

Optional

System.String

Der Parameter SamAccountName gibt den Namen für Clients des Objekts an, auf denen ältere Betriebssysteme ausgeführt werden. Der Parameter SamAccountName wird in Active Directory und in der Exchange-Verwaltungskonsole im Feld Gruppenname (Prä-Windows 2000) angezeigt.

SendOofMessageToOriginatorEnabled

Optional

System.Boolean

Der Parameter SendOofMessageToOriginatorEnabled ermöglicht das Senden von Abwesenheitsnachrichten an die Absender der an diese Verteilergruppe gesendeten E-Mail-Nachrichten. Gültige Werte sind $true oder $false. Der Standardwert lautet "$false".

SimpleDisplayName

Optional

System.String

Der Parameter SimpleDisplayName dient zum Anzeigen einer alternativen Beschreibung des Objekts, wenn nur eine begrenzte Menge von Zeichen zulässig ist. Diese begrenzte Zeichenmenge umfasst die ASCII-Zeichen 26 bis (einschließlich) 126.

UMDtmfMap

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter gibt an, ob eine benutzerdefinierte DTMF-Zuordnung für die UM-aktivierte Verteilergruppe erstellt werden soll.

WindowsEmailAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

Der Parameter WindowsEmailAddress gibt den Wert des Felds E-Mail des Active Directory-Objekts an.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Das folgende Codebeispiel zeigt, wie der Befehl Set-DistributionGroup verwendet wird, um den Anzeigenamen für eine vorhandene Verteilergruppe namens Accounting in Accounting Group zu ändern.

Set-DistributionGroup -Identity "Accounting" -DisplayName "Accounting Group"