New-MailContact (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-05

Mithilfe des Befehls New-MailContact können Sie einen neuen E-Mail-aktivierten Kontakt erstellen.

Syntax

New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>]

Detaillierte Beschreibung

Der Befehl New-MailContact erstellt ein neues E-Mail-Kontaktobjekt in Microsoft Active Directory und E-Mail-aktiviert den E-Mail-Kontakt anschließend.

Damit Sie das Cmdlet New-MailContact ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • die Rolle Exchange-Empfängeradministrator

  • Konten-Operator-Rolle für die entsprechenden Active Directory-Container

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

ExternalEmailAddress

Erforderlich

Microsoft.Exchange.Data.ProxyAddress

Die Ziel-E-Mail-Adresse.

Name

Erforderlich

System.String

Der allgemeine Name des E-Mail-Kontakts.

OrganizationalUnit

Erforderlich

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Die Organisationseinheit, der der neue Kontakt hinzugefügt wird. Beispiel: redmond.contoso.com/contacts.

Alias

Optional

System.String

Der Alias des E-Mail-Kontakts.

DisplayName

Optional

System.String

Der Name, der für den E-Mail-Kontakt in Microsoft Outlook angezeigt wird.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen des Domänencontrollers anzugeben, der diese Konfigurationsänderung in Active Directory schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu.

FirstName

Optional

System.String

Der Vorname des E-Mail-Kontakts.

Initials

Optional

System.String

Die Initialen des E-Mail-Kontakts.

LastName

Optional

System.String

Der Nachname des E-Mail-Kontakts.

MacAttachmentFormat

Optional

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

Der Parameter MacAttachmentFormat gibt das Anlagenformat des Apple Macintosh-Betriebssystems für Nachrichten an, die an den E-Mail-Kontakt gesendet werden. Gültige Werte für diesen Parameter:

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

Standardmäßig ist dieser Parameter auf BinHex festgelegt.

Die akzeptablen Werte für den MacAttachmentFormat-Parameter hängen vom Wert des MessageFormat-Parameters ab. Wenn der MessageFormat-Parameter auf Text festgelegt ist, können nur die Werte BinHex oder UUENCODE für diesen Parameter verwendet werden. Wenn der MessageFormat-Parameter auf Mime festgelegt ist, können nur die Werte BinHex, AppleSingle oder AppleDouble für diesen Parameter verwendet werden.

MessageBodyFormat

Optional

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

Der Parameter MessageBodyFormat gibt das Format des Nachrichtentexts für Nachrichten an, die an den E-Mail-Kontakt gesendet werden. Gültige Werte für diesen Parameter:

  • Text

  • HTML

  • TextAndHtml

Standardmäßig ist dieser Parameter auf TextAndHtml festgelegt.

Für die Parameter MessageFormat und MessageBodyFormat bestehen gegenseitige Abhängigkeiten. Wenn der MessageFormat-Parameter auf Mime festgelegt ist, kann der MessageBodyFormat-Parameter auf jeden gültigen Wert festgelegt werden. Wenn der MessageFormat-Parameter jedoch auf Text festgelegt ist, kann der MessageBodyFormat-Parameter nur auf Text festgelegt werden. Wenn Sie diesen Parameter auf Html oder TextAndHtml festlegen möchten, müssen Sie daher auch den MessageFormat-Parameter auf Mime festlegen.

MessageFormat

Optional

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

Der Parameter MessageFormat gibt das Nachrichtenformat für Nachrichten an, die an den E-Mail-Kontakt gesendet werden.

Gültige Werte für diesen Parameter:

  • Text

  • Mime

Standardmäßig ist dieser Parameter auf Mime festgelegt.

Für die Parameter MessageFormat und MessageBodyFormat bestehen gegenseitige Abhängigkeiten. Wenn der MessageFormat-Parameter auf Mime festgelegt ist, kann der MessageBodyFormat-Parameter auf jeden gültigen Wert festgelegt werden. Wenn der MessageFormat-Parameter jedoch auf Text festgelegt ist, kann der MessageBodyFormat-Parameter nur auf Text festgelegt werden. Wenn Sie den MessageFormat-Parameter von Mime in Text ändern möchten, müssen Sie daher auch den MessageBodyFormat-Parameter in Text ändern.

TemplateInstance

Optional

System.Management.Automation.PSObject

Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet der Befehl die Konfiguration des Objekts zum Erstellen eines exakten Duplikats des Objekts auf einem lokalen oder Zielserver.

UsePreferMessageFormat

Optional

System.Boolean

Wenn der Parameter auf true festgelegt ist, werden die globalen Einstellungen durch die vom Empfänger bevorzugten Formateinstellungen für E-Mail-Nachrichten überschrieben, die an diesen Benutzer gesendet werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

Ausnahmen

Ausnahmen Beschreibung

Beispiel

In dem folgenden Beispiel wird mithilfe des Befehls New-MailContact ein neuer E-Mail-aktivierter Kontakt erstellt.

New-MailContact -Name "Ted Bremer" -ExternalEmailAddress "ted@tailspintoys.com" -OrganizationalUnit "Marketing"