New-AddressList

  • Artikel

 

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-AddressList zum Erstellen einer neuen Adressliste sowie zum Anwenden dieser Liste auf Empfänger.

Syntax

New-AddressList -Name <String> [-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>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-AddressList -Name <String> [-Confirm [<SwitchParameter>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

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

Parameter

Parameter Erforderlich Typ Beschreibung

Name

Erforderlich

System.String

Der Parameter Name gibt den gewünschten Namen für die neue Adressliste an. Der Name darf maximal 64 Zeichen lang sein und darf keine Wagenrückläufe oder umgekehrten Schrägstriche (\) enthalten.

ConditionalCompany

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Der Parameter ConditionalCompany ist ein Filter, mit dem ein Unternehmen angegeben wird. Alle Empfänger mit einem Unternehmensattribut, das dem Wert entspricht, den Sie für diesen Parameter eingeben, werden in die Adressliste aufgenommen. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. Es muss entweder der Parameter RecipientFilter oder einer der folgenden Filterparameter verwendet werden:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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 ist ein Filter, mit dem eine Abteilung angegeben wird. Alle Empfänger mit einem Abteilungsattribut, das dem Wert entspricht, den Sie für diesen Parameter eingeben, werden in die Adressliste aufgenommen. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. Es muss entweder der Parameter RecipientFilter oder einer der folgenden Filterparameter verwendet werden:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

ConditionalStateOrProvince

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Der Parameter ConditionalStateOrProvince ist ein Filter, mit dem ein Bundesland oder ein Kanton angegeben wird. Alle Empfänger mit einem Attribut ConditionalStateOrProvince, das dem Wert entspricht, den Sie für diesen Parameter eingeben, werden in die Adressliste aufgenommen. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. Es muss entweder der Parameter RecipientFilter oder einer der folgenden Filterparameter verwendet werden:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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.

Container

Optional

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Der Parameter Container gibt die Identität der übergeordneten Adressliste an, in der diese neue Adressliste erstellt wird. Wenn keine übergeordnete Adressliste angegeben wird, wird die Adressliste unter dem Stamm "Alle Adresslisten" erstellt.

DisplayName

Optional

System.String

Der Parameter DisplayName gibt den gewünschten Anzeigenamen der Adressliste an. Wird kein Anzeigename zur Verfügung gestellt, ist der Name der Adressliste auch der Anzeigename.

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.

IncludedRecipients

Optional

System.Nullable

Der Parameter IncludedRecipients ist ein Filter, mit dem der Empfängertyp angegeben werden kann, der in die Adressliste aufgenommen werden soll. Einer oder mehrere der folgenden Typen können verwendet werden:

  • Keine

  • UserMail

  • Ressourcen

  • MailGroups

  • MailContacts

  • AllRecipients

Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. Es muss entweder der Parameter RecipientFilter oder einer der folgenden Filterparameter verwendet werden:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

RecipientFilter

Optional

System.String

Der Parameter RecipientFilter gibt einen Filter für Empfänger an, die in die Adressliste aufgenommen werden sollen. Dieser Parameter kann nicht zusammen mit einem der folgenden Parameter verwendet werden:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Es muss entweder dieser Parameter oder einer der vorangehenden Filterparameter verwendet werden.

Weitere Informationen über die filterbaren Eigenschaften finden Sie unter Filterbare Eigenschaften für den Parameter "-RecipientFilter".

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 genauen Duplikats des Objekts auf einem lokalen oder Zielserver.

UseRusServer

Optional

System.String
noteHinweis:
Dieser Parameter steht nur in Exchange Server 2007 SP2 zur Verfügung.

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.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Das erste Beispiel zeigt, wie eine neue Adressliste namens MyAddressList erstellt wird. Diese Adressliste enthält Empfänger, die Postfachbenutzer sind und für die StateOrProvince auf "Washington" oder "Oregon" festgelegt wurde.

Das zweite Beispiel zeigt, wie eine neue Adressliste namens MyAddressList2 erstellt wird, die Postfächer enthält, für die der Parameter ConditionalStateOrProvince auf Washington festgelegt wurde.

New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}
New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers