Set-SystemMessage (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-08

Verwenden Sie das Cmdlet Set-SystemMessage in Microsoft Exchange Server 2007, um angepasste DSN- (Delivery Status Notification, Benachrichtigung über den Übermittlungsstatus) oder Kontingentmeldungen in der angegebenen Sprache auf Computern zu ändern, auf denen die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Set-SystemMessage -Identity <SystemMessageIdParameter> [-DomainController <Fqdn>] [-Name <String>] [-Original <SwitchParameter>] [-Text <String>]

Set-SystemMessage [-DomainController <Fqdn>] [-Instance <SystemMessage>] [-Name <String>] [-Original <SwitchParameter>] [-Text <String>]

Detaillierte Beschreibung

Mit diesem Cmdlet können Sie angepasste DSN- und Kontingentmeldungen ändern. DSN-Meldungen werden an die Absender von E-Mail-Nachrichten ausgegeben, die ihren beabsichtigen Empfänger nicht erreicht haben. Kontingentmeldungen werden an Benutzer ausgegeben, deren Postfächer oder Öffentliche Ordner die spezifischen Kontingentwerte für "Warnung", "Senden verbieten" oder "Empfangen verbieten" erreicht haben. Angepasste DSN- und Kontingentmeldungen ersetzen die integrierten DSN- bzw. Kontingentmeldungen, die in Exchange Server enthalten sind.

Hinweis   Der Exchange-Server ist mit mehreren DSN-Standardmeldungen konfiguriert, die nicht mithilfe dieses Cmdlets geändert werden können. Stattdessen muss eine neue DSN-Meldung mit dem gleichen DSN-Code konfiguriert werden, um die vorkonfigurierten Meldungen zu ersetzen.

In der folgenden Liste werden die Fehlerbedingungen beschrieben, die DSN-Meldungen mit einem Übermittlungsstatus als permanenter temporärer Fehler und permanenter Fehler auslösen.

  • 4.X.X. DSN-Meldungen   Dieser Typ von DSN-Meldung wird generiert, wenn ein temporäres Problem mit dem Empfängerpostfach oder dem Server besteht. Diese Probleme lösen sich normalerweise bei Gelegenheit selbst und ermöglichen eine erfolgreiche Übermittlung der E-Mail-Nachricht. Ein Beispiel für einen permanenten temporären Fehler vom Typ 4.X.X. ist ein Server, der offline gesetzt wurde und nicht erreicht werden kann.

  • 5.X.X. DSN-Meldungen   Dieser Typ von DSN-Meldung wird generiert, wenn ein permanenter oder schwerwiegender Fehler beim Empfängerpostfach oder dem Server besteht. Diese Fehler können nicht vom sendenden E-Mail-Server überwunden werden; daher wird die E-Mail-Nachricht an den Absender zurück gesendet. Ein Beispiel für einen permanenten Fehler vom Typ 5.X.X. ist eine nicht vorhandene SMTP-Adresse.

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

  • die Rolle Exchange-Organisationsadministrator

Um das Cmdlet Set-SystemMessage auf einem Computer ausführen zu können, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf diesem Computer ist.

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

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.SystemMessageIdParameter

Dieser Parameter gibt die Identität der zu ändernden DSN- oder Kontingentmeldung an.

Verwenden Sie das folgende Format, um eine DSN-Meldung zu ändern: Sprache\interner | externer\Systemcode. Weitere Informationen zur Syntax der DSN-Meldungsidentität finden Sie unter DSN-Nachrichtenidentität.

Verwenden Sie das folgende Format, um eine angepasste Kontingentmeldung zu ändern: Sprache\QuotaMessageType. Die Sprache wird durch das aus zwei Zeichen bestehende Gebietsschema angegeben. Der Parameter QuotaMessageType nimmt die folgenden Werte an:

  • WarningMailboxUnlimitedSize   Wird ausgegeben, wenn ein Postfach, für das keine Kontingente für "Senden verbieten" oder "Empfangen verbieten" festgelegt sind, den für Postfächer angegebenen Grenzwert für Warnungen überschreitet.

  • WarningPublicFolderUnlimitedSize    Wird ausgegeben, wenn ein Öffentlicher Ordner, für den keine Kontingente für "Senden verbieten" oder "Empfangen verbieten" festgelegt sind, den für Öffentliche Ordner angegebenen Warngrenzwert überschreitet.

  • WarningMailbox    Wird ausgegeben, wenn ein Postfach, für das Kontingente für "Senden verbieten" oder "Empfangen verbieten" festgelegt sind, den für Postfächer angegebenen Grenzwert für Warnungen überschreitet.

  • WarningPublicFolder    Wird ausgegeben, wenn ein Öffentlicher Ordner, für den ein Kontingent für "Senden verbieten" oder "Empfangen verbieten" festgelegt ist, den für den Öffentlichen Ordner angegebenen Warngrenzwert überschreitet.

  • ProhibitSendMailbox    Issued when a mailbox that has a prohibit send quota exceeds the specified mailbox size limit.

  • ProhibitPostPublicFolder    Issued when a public folder that has a prohibit send quota exceeds the specified public folder size limit.

  • ProhibitSendReceiveMailBox    Wird ausgegeben, wenn ein Postfach, für das ein Kontingent für "Senden verbieten" und für "Empfangen verbieten" festgelegt ist, den für das Postfach angegebenen Grenzwert für die Sende- oder Empfangsgröße überschreitet.

Sie können die Parameterbeschriftung Identity weglassen.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der Daten in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. Der Parameter DomainController wird nicht auf Computern unterstützt, auf denen die Serverfunktion Edge-Transport ausgeführt wird. Die Serverfunktion Edge-Transport schreibt und liest nur in der lokalen ADAM-Instanz (Active Directory Application Mode).

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.SystemMessage

Dieser Parameter ermöglicht das Übergeben der DSN- oder Kontingentmeldung an den zu verarbeitenden Befehl. Er ist in Skripts von Nutzen, in denen ein vollständiges Objekt an den Befehl übergeben werden muss.

Name

Optional

System.String

Dieser Parameter gibt einen Namen an, der zum Beschreiben der DSN- oder Kontingentmeldung verwendet werden kann.

Original

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter stellt die DSN- oder Kontingentmeldung mit dem ursprünglichen Text wieder her. Dieser Parameter ist nützlich, wenn Sie einen angepassten DSN- oder Kontingenteintrag nicht entfernen, aber auf den ursprünglichen Text zurücksetzen möchten.

Text

Optional

System.String

Dieser Parameter gibt den Text der Meldung an, die Absendern oder Postfachbesitzern angezeigt wird. Der Text sollte erläutern, warum die Meldung erstellt wurde und welche Aktionen der Absender oder Postfachbesitzer gegebenenfalls ausführen soll.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

Ausnahmen

Ausnahmen Beschreibung

Beispiel

Im folgenden Beispielcode ändert das erste Beispiel den englischen Text einer vorhandenen angepassten DSN-Meldung mit dem DSN-Code 5.3.5. Diese DSN-Meldung wird nur für externe Benutzer angezeigt. Der Text für die DSN-Meldung ist in der Befehlszeile enthalten.

Im zweiten Beispiel wird der englische Text einer vorhandenen angepassten WarningMailbox-Kontingentmeldung geändert.

Set-SystemMessage En\Internal\5.3.5 -Text "The recipient e-mail system can't process this e-mail message. Please contact your system administrator for more information."
Set-SystemMessage En\WarningMailbox -Text "Your mailbox has exceeded the warning limit specified by your e-mail administrator. Please reduce the size of your mailbox."