New-SystemMessage
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-07-27
Verwenden Sie das Cmdlet New-SystemMessage in Microsoft Exchange Server 2007, um neue angepasste DSN- (Delivery Status Notification, Benachrichtigung über den Übermittlungsstatus) oder Kontingentmeldungen in der angegebenen Sprache auf Computern zu erstellen, auf denen die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.
Syntax
New-SystemMessage -DsnCode <EnhancedStatusCode> -Internal <$true | $false> -Language <CultureInfo> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
New-SystemMessage -Language <CultureInfo> -QuotaMessageType <WarningMailboxUnlimitedSize | WarningPublicFolderUnlimitedSize | WarningMailbox | WarningPublicFolder | ProhibitSendMailbox | ProhibitPostPublicFolder | ProhibitSendReceiveMailBox> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit diesem Cmdlet können Sie neue angepasste DSN- und Kontingentmeldungen erstellen. 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.
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 New-SystemMessage ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Organisationsadministrator
Um das Cmdlet New-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 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
DsnCode |
Erforderlich |
Microsoft.Exchange.Data.EnhancedStatusCode |
Dieser Parameter gibt an, für welchen DSN-Code die DSN-Meldung gilt. Bei diesem Parameter kann es sich um integrierten Code oder um angepassten Code handeln, der von einem Administrator definiert wurde. Hinweis Dieser Parameter ist nicht erforderlich und kann nicht verwendet werden, wenn der Parameter QuotaMessageType angegeben wird. |
Internal |
Erforderlich |
System.Boolean |
Dieser Parameter gibt an, ob die Meldung Benutzern angezeigt wird, die sich in der Exchange Server-Organisation befinden. Für Meldungen, die nur intern angezeigt werden, geben Sie Hinweis Dieser Parameter ist nicht erforderlich und kann nicht verwendet werden, wenn der Parameter QuotaMessageType angegeben wird. |
Language |
Erforderlich |
System.Globalization.CultureInfo |
Dieser Parameter gibt die Sprache der Meldung an. Die Meldung kann in jeder Sprache erstellt werden, die von Exchange Server unterstützt wird. Die Sprachen werden anhand ihres Gebietsschemanamens angegeben, z. B. "en" für Englisch und "ja" für Japanisch. Eine vollständige Liste der Gebietsschemas finden Sie unter Unterstützte Gebietsschemas für die Verwendung mit Systemmeldungen. |
QuotaMessageType |
Erforderlich |
Microsoft.Exchange.Data.Directory.SystemConfiguration.QuotaMessageType |
Dieser Parameter wählt den Typ der zu erstellenden Kontingentmeldung aus. Der Parameter QuotaMessageType nimmt die folgenden Werte an:
Hinweis Dieser Parameter ist nicht erforderlich und kann nicht verwendet werden, wenn der Parameter DsnCode angegeben wird. |
Text |
Erforderlich |
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. |
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. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der Daten aus dem Active Directory-Verzeichnisdienst abruft, 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). |
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. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
Beispiel
Im folgenden Beispielcode fügt das erste Beispiel eine neue angepassten DSN-Meldung mit dem DSN-Code 5.3.5 hinzu. Diese DSN-Meldung wird nur für externe Benutzer angezeigt. Der Text für die DSN-Meldung ist zusammen mit der Sprache der Meldung (Englisch) in der Befehlszeile enthalten.
Im zweiten Beispiel wird eine neue angepasste WarningMailbox-Kontingentmeldung hinzugefügt. Die Meldung wird Benutzern angezeigt, die die folgenden Kriterien erfüllen:
Das Postfach hat den für das Postfach konfigurierten Warngrenzwert überschritten.
Es sind keine Postfachkontingente für "Senden verbieten" oder "Empfangen verbieten" konfiguriert.
Das Postfach befindet sich auf einem Server, auf dem das Gebietsschema "Englisch" verwendet wird.
New-SystemMessage -DsnCode 5.3.5 -Language En -Internal $false -Text "The recipient e-mail system can't process this e-mail message. Please contact your system administrator for more information."
New-SystemMessage -QuotaMessageType WarningMailbox -Language En -Text "Your mailbox has exceeded the warning limit specified by your e-mail administrator. Please reduce the size of your mailbox."