New-EmailAddressPolicy (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-05
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 <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>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -RecipientFilter <String> [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -RecipientFilter <String> [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -IncludedRecipients <Nullable> [-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>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
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 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 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 |
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 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. |
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. |
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