Set-DistributionGroup
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2010-10-20
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>] [-Confirm [<SwitchParameter>]] [-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>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-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>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <DistributionGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-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 Microsoft 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:
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, E-Mail-Benutzer und E-Mail-Kontakte E-Mail-Nachrichten an diese Verteilergruppe senden können. Sie können für diesen Parameter auch Microsoft Exchange als gültigen Empfänger angeben. Wenn Sie eine Verteilergruppe so konfigurieren, dass sie Nachrichten nur vom Microsoft Exchange-Empfänger akzeptiert, empfängt sie nur vom System generierte Nachrichten. Der Parameter AcceptMessagesOnlyFrom akzeptiert jeden der folgenden Werte als gültige Absender:
Standardmäßig ist der Wert für diesen Parameter leer. Hierdurch wird es der Verteilergruppe ermöglicht, Nachrichten von allen Absendern zu akzeptieren. |
||
AcceptMessagesOnlyFromDLMembers |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Der Parameter AcceptMessagesOnlyFromDLMembers gibt die Verteilergruppen an, deren Mitglieder E-Mail-Nachrichten an diese Verteilergruppe senden können. Für die zulässigen Verteilergruppen kann jeder der folgenden Werte verwendet werden:
Standardmäßig ist der Wert für diesen Parameter leer. Hierdurch wird es der Verteilergruppe ermöglicht, Nachrichten von allen Absendern zu akzeptieren. |
||
Alias |
Optional |
System.String |
Der Parameter Alias gibt den Aliasnamen des Objekts an. Der Wert von Alias darf keine Leerzeichen enthalten. |
||
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden. |
||
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. Wichtig Exchange 2007 überprüft keine benutzerdefinierten Adressen auf ordnungsgemäße Formatierung. Sie müssen sicherstellen, dass die von Ihnen angegebene benutzerdefinierte Adresse die Formatanforderungen für den jeweiligen Adresstyp erfüllt. Da X.400-Adressen in Exchange 2007 als benutzerdefinierte Adressen eingestuft werden, werden sie ebenfalls nicht überprüft. Daher müssen Sie beim Angeben einer X.400-Adresse die richtige Syntax 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.RecipientIdParameter |
Der Parameter GrantSendOnBehalfTo gibt einen Postfachbenutzer an, der im Auftrag dieser Verteilergruppe Nachrichten senden kann. Der Parameter GrantSendOnBehalfTo kann die folgenden Werte annehmen:
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". |
||
IgnoreDefaultScope |
Optional |
System.Management.Automation.SwitchParameter |
Mit dem IgnoreDefaultScope-Parameter wird der Befehl angewiesen, die Standardeinstellung für den Empfängerbereich für die Exchange-Verwaltungsshell zu ignorieren und die ganze Gesamtstruktur als Bereich zu verwenden. Dadurch kann der Befehl auf Active Directory-Objekte zugreifen, die sich aktuell nicht im Standardbereich befinden. Die Verwendung des IgnoreDefaultScope-Parameters bringt die folgenden Einschränkungen mit sich:
|
||
Instance |
Optional |
Microsoft.Exchange.Data.Directory.Management.DistributionGroup |
Der Parameter Instance ermöglicht das Übergeben eines gesamten Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein gesamtes Objekt an den Befehl übergeben werden muss. Der Parameter Instance kann nicht zusammen mit dem Parameter Identity verwendet werden. |
||
ManagedBy |
Optional |
Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter |
Der Parameter ManagedBy gibt den Namen des Postfachbenutzers, der E-Mail-aktivierten Gruppe oder des E-Mail-aktivierten Kontakts an, der auf der Registerkarte Verwaltet von des Objekts Active Directory angezeigt wird. Für diesen Parameter kann jeder der folgenden Werte 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:
Nicht qualifizierte Werte werden als "Byte" behandelt. Gültige Werte sind 0 bis 2147482624 Byte. Standardmäßig ist der Parameter MaxReceiveSize auf |
||
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:
Nicht qualifizierte Werte werden als "Byte" behandelt. Gültige Werte sind 0 bis 2147482624 Byte. Standardmäßig ist der Parameter MaxSendSize auf |
||
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-E-Mail-Rückgabeadresse 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:
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:
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 |
||
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 folgenden Zeichen: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:? |
||
UMDtmfMap |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter gibt an, ob eine benutzerdefinierte DTMF-Zuordnung für die UM-aktivierte Verteilergruppe erstellt werden soll. |
||
UseRusServer |
Optional |
System.String |
Der Parameter UseRusServer weist den Befehl an, den angegebenen Postfachserver, auf dem der Adresslistendienst ausgeführt wird, zum Abrufen und Festlegen von Postfach- und Active Directory-Benutzerattributen zu verwenden. Der Adresslistendienst ist eine Komponente des Exchange-Systemaufsichtsdiensts. Der Adresslistendienst erstellt und verwaltet Exchange-spezifische Attributwerte in Active Directory. Sie können den Adresslistendienst zum Aktualisieren von Empfängerobjekten in einer Domäne mithilfe bestimmter Informationen verwenden, z. B. anhand von Adresslistenmitgliedschaft und E-Mail-Adressen. |
||
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden. |
||
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"