Set-MailContact
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2011-01-26
Verwenden Sie das Cmdlet Set-MailContact, um einen vorhandenen E-Mail-aktivierten Kontakt im Active Directory-Verzeichnisdienst zu ändern.
Syntax
Set-MailContact -Identity <MailContactIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
Set-MailContact [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <MailContact>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
Detaillierte Beschreibung
Mithilfe des Cmdlets Set-MailContact wird ein vorhandener E-Mail-aktivierter Kontakt in Active Directory geändert, indem die Identität und die zu ändernden Attribute angegeben werden.
Damit Sie das Cmdlet Set-MailContact ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Empfängeradministrator
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 | ||
---|---|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter |
Der Parameter Identity akzeptiert einen der folgenden Werte:
|
||
AcceptMessagesOnlyFrom |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Der Parameter AcceptMessagesOnlyFrom gibt an, welche Postfachbenutzer, E-Mail-Benutzer und E-Mail-Kontakte E-Mail-Nachrichten an diesen E-Mail-Kontakt senden können. Sie können für diesen Parameter auch Microsoft Exchange als gültigen Empfänger angeben. Wenn Sie einen E-Mail-Kontakt so konfigurieren, dass Nachrichten nur vom Microsoft Exchange-Empfänger akzeptiert werden, empfängt dieser nur vom System generierte Nachrichten. Der Parameter AcceptMessagesOnlyFrom akzeptiert jeden der folgenden Werte als gültige Absender:
In der Standardeinstellung ist dieser Parameter leer. Mithilfe dieses Standardwerts wird der E-Mail-Kontakt für das Annehmen von Nachrichten von allen Sendern aktiviert. |
||
AcceptMessagesOnlyFromDLMembers |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Der AcceptMessagesOnlyFromDLMembers-Parameter gibt die Verteilergruppen an, deren Mitglieder E-Mail-Nachrichten an diesen E-Mail-Kontakt senden dürfen. Für die zulässigen Verteilergruppen kann jeder der folgenden Werte verwendet werden:
In der Standardeinstellung ist dieser Parameter leer. Mithilfe dieses Standardwerts wird der E-Mail-Kontakt für das Annehmen von Nachrichten von allen Sendern aktiviert. |
||
Alias |
Optional |
System.String |
Der Parameter Alias gibt den Alias des E-Mail-aktivierten Kontakts an. Ein Alias kann Buchstaben, Zahlen sowie folgende Satzzeichen und Symbole enthalten:
|
||
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. |
||
CreateDTMFMap |
Optional |
System.Boolean |
Dieser Parameter gibt an, dass eine DTMF-Zuordnung (Dual Tone Multi-Frequency) für den Kontakt erstellt werden soll. |
||
CustomAttribute1 |
Optional |
System.String |
Mit dem Parameter CustomAttribute1 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute10 |
Optional |
System.String |
Mit dem Parameter CustomAttribute10 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute11 |
Optional |
System.String |
Mit dem Parameter CustomAttribute11 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute12 |
Optional |
System.String |
Mit dem Parameter CustomAttribute12 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute13 |
Optional |
System.String |
Mit dem Parameter CustomAttribute13 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute14 |
Optional |
System.String |
Mit dem Parameter CustomAttribute14 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute15 |
Optional |
System.String |
Mit dem Parameter CustomAttribute15 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute2 |
Optional |
System.String |
Mit dem Parameter CustomAttribute2 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute3 |
Optional |
System.String |
Mit dem Parameter CustomAttribute3 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute4 |
Optional |
System.String |
Mit dem Parameter CustomAttribute4 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute5 |
Optional |
System.String |
Mit dem Parameter CustomAttribute5 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute6 |
Optional |
System.String |
Mit dem Parameter CustomAttribute6 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute7 |
Optional |
System.String |
Mit dem Parameter CustomAttribute7 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute8 |
Optional |
System.String |
Mit dem Parameter CustomAttribute8 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
CustomAttribute9 |
Optional |
System.String |
Mit dem Parameter CustomAttribute9 werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. |
||
DisplayName |
Optional |
System.String |
Der Parameter DisplayName gibt den Anzeigenamen des Benutzers an. |
||
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. |
||
EmailAddresses |
Optional |
Microsoft.Exchange.Data.ProxyAddressCollection |
Der Parameter EmailAddresses gibt den E-Mail-Alias des E-Mail-Kontakts an. Alle gültigen Microsoft Exchange 2007-E-Mail-Adresstypen können verwendet werden. Sie können mehrere Werte für den Parameter EmailAddresses angeben, wenn Sie eine durch Kommas getrennte Liste verwenden. Wichtig Exchange 2007 überprüft keine benutzerdefinierten Adressen auf ordnungsgemäße Formatierung. Sie müssen sicherstellen, dass die von Ihnen angegebene benutzerdefinierte Adresse die Formatanforderungen für den jeweiligen Adresstyp erfüllt. Da X.400-Adressen in Exchange 2007 als benutzerdefinierte Adressen eingestuft werden, werden sie ebenfalls nicht überprüft. Daher müssen Sie beim Angeben einer X.400-Adresse die richtige Syntax verwenden. |
||
EmailAddressPolicyEnabled |
Optional |
System.Boolean |
Der Parameter EmailAddressPolicyEnabled gibt an, ob die E-Mail-Adressen für das Postfach automatisch basierend auf den definierten E-Mail-Adressrichtlinien aktualisiert werden sollen. |
||
Extensions |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter gibt eine oder mehrere Durchwahlnummern für den Kontakt an. Wenn der Parameter festgelegt ist, müssen alle Durchwahlnummern innerhalb des Wählplans eindeutig sein. |
||
ExternalEmailAddress |
Optional |
Microsoft.Exchange.Data.ProxyAddress |
Der Parameter ExternalEmailAddress gibt die externe E-Mail-Adresse des Empfängers an. |
||
GrantSendOnBehalfTo |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
Der Parameter GrantSendOnBehalfTo gibt die Distinguished Names (DNs) von Empfängern an, die im Auftrag dieses Kontakts senden dürfen. |
||
HiddenFromAddressListsEnabled |
Optional |
System.Boolean |
Der Parameter HiddenFromAddressListsEnabled gibt an, ob der Kontakt in Adresslisten angezeigt wird. Wenn der Wert $true ist, wird der Kontakt nicht in der Adressliste angezeigt. Der Standardwert lautet $false. |
||
IgnoreDefaultScope |
Optional |
System.Management.Automation.SwitchParameter |
Mit dem IgnoreDefaultScope-Parameter wird der Befehl angewiesen, die Standardeinstellung für den Empfängerbereich für die Exchange-Verwaltungsshell zu ignorieren und die ganze Gesamtstruktur als Bereich zu verwenden. Dadurch kann der Befehl auf Active Directory-Objekte zugreifen, die sich aktuell nicht im Standardbereich befinden. Die Verwendung des IgnoreDefaultScope-Parameters bringt die folgenden Einschränkungen mit sich:
|
||
Instance |
Optional |
Microsoft.Exchange.Data.Directory.Management.MailContact |
Der Parameter Instance ermöglicht das Übergeben eines gesamten Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein gesamtes Objekt an den Befehl übergeben werden muss. |
||
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:
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 BinHex-Werte 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. |
||
MaxReceiveSize |
Optional |
Microsoft.Exchange.Data.Unlimited |
Der Parameter MaxReceiveSize gibt die maximale Größe von E-Mail-Nachrichten an, die empfangen werden können, von 1 KB bis zu 2.097.151 KB. Wenn kein Wert angegeben ist, ist der Grenzwert auf den Maximalwert festgelegt. |
||
MaxRecipientPerMessage |
Optional |
Microsoft.Exchange.Data.Unlimited |
Der MaxRecipientPerMessage-Parameter gibt die maximale Anzahl der Empfänger für Nachrichten von diesem E-Mail-Kontakt an. |
||
MaxSendSize |
Optional |
Microsoft.Exchange.Data.Unlimited |
Der Parameter MaxSendSize gibt die maximale Größe von E-Mail-Nachrichten an, die gesendet werden können, von 1 KB bis zu 2.097.151 KB. Wenn kein Wert angegeben ist, ist der Grenzwert auf den Maximalwert festgelegt. |
||
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:
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:
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. |
||
Name |
Optional |
System.String |
Der Name-Parameter gibt den Namen des E-Mail-aktivierten Kontakts an. |
||
PrimarySmtpAddress |
Optional |
Microsoft.Exchange.Data.SmtpAddress |
Der PrimarySmtpAddress-Parameter gibt die primäre SMTP-E-Mail-Adresse an. |
||
RejectMessagesFrom |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Der Parameter RejectMessagesFrom gibt die Empfänger an, von denen Nachrichten abgelehnt werden sollen. |
||
RejectMessagesFromDLMembers |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Der Parameter RejectMessagesFromDLMembers gibt die Verteilergruppenmitglieder an, von denen Nachrichten abgelehnt werden sollen. |
||
RequireSenderAuthenticationEnabled |
Optional |
System.Boolean |
Der RequireSenderAuthenticationEnabled-Parameter gibt an, ob Nachrichten nur von authentifizierten Empfängern angenommen werden sollen. Der Standardwert lautet $false. |
||
SecondaryAddress |
Optional |
System.String |
Dieser Parameter gibt die sekundäre Adresse an, die von dem UM-aktivierten Kontakt verwendet wird. |
||
SecondaryDialPlan |
Optional |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
Dieser Parameter gibt einen sekundären UM-Wählplan an, der verwendet werden soll. Dieser Parameter wird angegeben, um eine sekundäre Proxyadresse zu erstellen. |
||
SimpleDisplayName |
Optional |
System.String |
Der Parameter SimpleDisplayName dient zum Anzeigen einer alternativen Beschreibung des Objekts, wenn nur eine begrenzte Menge von Zeichen zulässig ist. Diese begrenzte Zeichenmenge umfasst die ASCII-Zeichen 26 bis 126. |
||
UMDtmfMap |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter gibt an, ob Sie eine benutzerdefinierte DTMF-Zuordnung für den UM-aktivierten Kontakt erstellen möchten. |
||
UseMapiRichTextFormat |
Optional |
Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat |
Der UseMapiRichTextFormat-Parameter gibt an, wie Nachrichten im MAPI-RTF-Format für diesen E-Mail-Kontakt behandelt werden. Legen Sie diesen Parameter auf Nie fest, um alle an diesen Kontakt gesendeten Nachrichten in unformatierten Text umzuwandeln. Legen Sie diesen Parameter auf Immer fest, um Nachrichten an diesen Kontakt immer in MAPI-RTF zu senden. Legen Sie diesen Parameter auf UseDefaultSettings fest, um das Format auf der Grundlage der Einstellung zu wählen, die im MAPI-Client konfiguriert ist, der die Nachricht gesendet hat. |
||
UsePreferMessageFormat |
Optional |
System.Boolean |
Der UsePreferMessageFormat-Parameter gibt an, ob die für den E-Mail-Kontakt konfigurierten Einstellungen für das Nachrichtenformat die globalen Einstellungen außer Kraft setzen sollen, die für die Remotedomäne konfiguriert sind. Legen Sie diesen Parameter auf $true fest, wenn die für den E-Mail-Kontakt konfigurierten Nachrichtenformateinstellungen alle globalen Einstellungen außer Kraft setzen sollen. |
||
UseRusServer |
Optional |
System.String |
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 WhatIf-Parameter muss kein Wert angegeben werden. |
||
WindowsEmailAddress |
Optional |
Microsoft.Exchange.Data.SmtpAddress |
Der Parameter WindowsEmailAddress gibt die Windows-E-Mail-Adresse für dieses Postfach an. Diese Adresse wird von Exchange nicht verwendet. |
Eingabetypen
Rückgabetypen
Fehler
Fehler | Beschreibung |
---|---|
|
Ausnahmen
Ausnahmen | Beschreibung |
---|---|
|
Beispiel
In diesem Beispiel wird der Befehl Set-MailContact verwendet, um die externe E-Mail-Adresse von John Peoples auf john@contoso.com festzulegen.
Set-MailContact -Identity "John Peoples" -ExternalEmailAddress "john@contoso.com"