Enable-MailContact

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2010-03-30

Sie können den Befehl Enable-MailContact verwenden, um einen vorhandenen Kontakt in Active Directory für E-Mail zu aktivieren.

Syntax

Enable-MailContact -Identity <ContactIdParameter> -ExternalEmailAddress <ProxyAddress> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-PrimarySmtpAddress <SmtpAddress>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Dieser Befehl aktiviert einen vorhandenen Kontakt in Active Directory für E-Mail, indem die Attribute hinzugefügt werden, die für Microsoft Exchange Server 2007 erforderlich sind. Die Identität eines Kontakts, der zugehörige Alias und die E-Mail-Zieladresse sind erforderlich, um einen Kontakt für E-Mail zu aktivieren.

Damit Sie das Cmdlet Enable-MailContact ausführen können, muss die folgende Rolle an das verwendete Konto delegiert worden sein:

  • Exchange-Empfängeradministrator-Rolle

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

Dieser Parameter gibt die E-Mail-Zieladresse an. Standardmäßig wird die im Parameter ExternalEmailAddress angegebene E-Mail-Adresse als PrimarySMTPAddress festgelegt.

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

Dieser Parameter nimmt einen der folgenden Werte an:

  • ADObjectID

  • GUID

  • Distinguished Name

  • Domäne\SamAccountName

  • Benutzerprinzipalname

  • LegacyExchangeDN

  • E-Mail-Adresse

  • Kontaktalias

Alias

Optional

System.String

Dieser Parameter gibt den Alias des E-Mail-aktivierten Kontakts an.

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden.

DisplayName

Optional

System.String

Dieser Parameter gibt den Anzeigenamen des Kontakts an.

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.

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

  • 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 Parameter MessageFormat auf Text festgelegt ist, können nur die BinHex-Werte für diesen Parameter verwendet werden. Wenn der Parameter MessageFormat 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.

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 des Parameters ExternalEmailAddress 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.

UsePreferMessageFormat

Optional

System.Boolean

Wenn er auf TRUE festgelegt ist, gibt dieser Parameter an, dass die bevorzugten Einstellungen des Empfängers für das Nachrichtenformat die globalen Einstellungen für die an diesem Benutzer gesendete E-Mail außer Kraft setzen.

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 WhatIf-Parameters 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 diesem Beispiel wird der Befehl Enable-MailContact verwendet, um einen vorhandenen Kontakt in Active Directory für E-Mail zu aktivieren und für den Kontakt die externe E-Mail-Adresse ted@tailspintoys.com bereitzustellen.

Enable-MailContact -Identity Ted -ExternalEmailAddress "ted@tailspintoys.com"

Beachten Sie, dass der Befehl Enable-MailContact keinen neuen Kontakt in Active Directory erstellen kann. Verwenden Sie den Befehl New-MailContact, um einen neuen Kontakt zu erstellen.