New-MailContact

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2009-05-14

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

Syntax

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

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:

  • Exchange-Empfängeradministrator-Rolle

  • 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.

Alias

Optional

System.String

Der Alias des E-Mail-Kontakts.

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.

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.

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

PrimarySmtpAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

Verwenden Sie diesen Parameter, um die primäre SMTP-Adresse für den E-Mail-Kontakt anzugeben. Standardmäßig wird die primäre SMTP-Adresse basierend auf der E-Mail-Standardadressrichtlinie generiert. Wenn Sie mithilfe dieses Parameters eine primäre SMTP-Adresse angeben, legt das Cmdlet das Attribut EmailAddressPolicyEnabled des E-Mail-Kontakts auf $false fest, und die E-Mail-Adressen dieses E-Mail-Kontakts werden nicht automatisch basierend auf den E-Mail-Richtlinien aktualisiert.

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.

UseRusServer

Optional

System.String
noteHinweis:
Dieser Parameter steht nur in Exchange 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

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"