New-EmailAddressPolicy
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2009-05-12
Verwenden Sie das Cmdlet New-EmailAddressPolicy, um eine neue Richtlinie für E-Mail-Adressen zu erstellen.
Syntax
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -IncludedRecipients <Nullable> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -RecipientFilter <String> [-Confirm [<SwitchParameter>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -RecipientFilter <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -IncludedRecipients <Nullable> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet New-EmailAddressPolicy erstellt eine neue Richtlinie für E-Mail-Adressen und wendet diese an. Die neue Richtlinie für E-Mail-Adressen wird im Konfigurationscontainer der Microsoft Exchange-Organisation im Active Directory-Verzeichnisdienst erstellt.
Damit Sie das Cmdlet New-EmailAddressPolicy ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Organisationsadministrator
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 | ||
|---|---|---|---|---|---|
EnabledEmailAddressTemplates |
Erforderlich |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
Der Parameter EnabledEmailAddressTemplates gibt die Proxyadressen an, die in einer Richtlinie für E-Mail-Adressen enthalten und aktiviert sind. Trennen Sie die einzelnen Werte durch Kommas. Der Domänenteil der einzelnen Proxyadressen muss mit einer vorhandenen akzeptierten Domäne übereinstimmen. |
||
EnabledPrimarySMTPAddressTemplate |
Erforderlich |
System.String |
Der Parameter EnabledPrimarySMTPAddressTemplate gibt die Proxyadresse an, die aktiviert und in einer Richtlinie für E-Mail-Adressen enthalten ist. Der Domänenteil der einzelnen Proxyadressen muss mit einer vorhandenen akzeptierten Domäne übereinstimmen. |
||
IncludedRecipients |
Erforderlich |
System.Nullable |
Der Parameter IncludedRecipients filtert Empfänger, die zum Festlegen der Richtlinie für E-Mail-Adressen verwendet werden. Der AllRecipients-Wert 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 für die Richtlinie für E-Mail-Adressen an. |
||
RecipientFilter |
Erforderlich |
System.String |
Der Parameter RecipientFilter gibt einen Filter für Empfänger an, die in die Richtlinie für E-Mail-Adressen einzubeziehen sind. Dieser Parameter kann nicht zusammen mit einem der folgenden Parameter verwendet werden:
Weitere Informationen über die filterbaren Eigenschaften finden Sie unter Filterbare Eigenschaften für den Parameter "-RecipientFilter". |
||
ConditionalCompany |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter ConditionalCompany filtert nach Unternehmen. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben. |
||
ConditionalCustomAttribute1 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute1 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute10 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute10 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute11 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute11 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute12 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute12 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute13 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute13 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute14 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute14 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute15 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute15 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute2 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute2 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute3 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute3 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute4 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute4 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute5 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute5 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute6 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute6 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute7 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute7 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute8 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute8 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
ConditionalCustomAttribute9 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 nach Abteilung. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben. |
||
ConditionalStateOrProvince |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter ConditionalStateOrProvince filtert nach Bundesland oder Kanton. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben. |
||
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden. |
||
DisabledEmailAddressTemplates |
Optional |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
Der Parameter DisabledEmailAddressTemplates gibt die Proxyadressen an, die in einer Richtlinie für E-Mail-Adressen enthalten und aktiviert sind. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben. |
||
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 dem Befehl den Parameter DomainController hinzu. |
||
Priority |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority |
Mit dem Parameter Priority wird die aktuelle Priorität im Bezug auf die als Argument für diesen Parameter angegebene Priorität erhöht. |
||
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 eines exakten Duplikats des Objekts auf einem lokalen oder Zielserver. |
||
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 Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden. |
.gif "note")
Hinweis:Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
Beispiel
Der folgende Code ist ein Beispiel für den Befehl New-EmailAddressPolicy.
New-EmailAddressPolicy -Name "MyPolicy" -IncludedRecipients MailboxUsers -EnabledPrimarySMTPAddressTemplate SMTP:@contoso.com