Freigeben über

New-JournalRule

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2007-08-13

Mit dem Cmdlet New-JournalRule können Sie eine neue Journalregel auf einem Computer erstellen, auf dem die Microsoft Exchange Server 2007-Serverfunktion Hub-Transport installiert ist.

Syntax

New-JournalRule -Name <String> -JournalEmailAddress <RecipientIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Recipient <Nullable>] [-Scope <Internal | External | Global>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit dem Cmdlet New-JournalRule wird eine neue vom Journal-Agent zu verwendende Journalregel erstellt.

Neue Journalregeln sind standardmäßig aktiviert, es sei denn, der Parameter Enabled ist auf $False festgelegt. Weitere Informationen zum Aktivieren einer neuen Journalregel, die mit einem deaktivierten Status erstellt wurde, finden Sie unter Enable-JournalRule.

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

  • Exchange-Organisationsadministrator-Rolle

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

JournalEmailAddress

Erforderlich

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Verwenden Sie diesen Parameter zur Angabe des Empfängerobjekts, an das Journalberichte gesendet werden.

Name

Erforderlich

System.String

Dieser Parameter gibt den Namen der Journalregel an. Der Regelname darf maximal 64 Zeichen umfassen.

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 diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu.

Enabled

Optional

System.Boolean

Dieser Parameter gibt an, ob die Journalregel aktiviert oder deaktiviert ist. Ist die Regel deaktiviert, wird sie nicht auf E-Mail-Nachrichten angewendet. Der Standardwert ist $False.

Recipient

Optional

System.Nullable

Verwenden Sie diesen Parameter zur Angabe der SMTP-Adresse eines Postfachs, eines Kontakts oder einer Verteilergruppe, für die ein Journal erstellt werden soll. Wenn Sie eine Verteilergruppe angeben, wird ein Journal für alle Empfänger in dieser Verteilergruppe erstellt. Auf alle Nachrichten, die an einen Empfänger oder von einem Empfänger gesendet werden, wird die Journalfunktion angewendet.

Scope

Optional

Microsoft.Exchange.MessagingPolicies.Journaling.JournalRuleScope

Dieser Parameter gibt die E-Mail-Nachrichten an, für welche die Journalregel gilt. Gültige Werte für diesen Parameter sind:

  • Global   Globale Regeln verarbeiten alle E-Mail-Nachrichten, die einen Hub-Transport-Server durchlaufen. Dazu zählen auch E-Mail-Nachrichten, die bereits von den externen und internen Regeln verarbeitet wurden. Der Standardwert ist Global.

  • Intern   Interne Regeln verarbeiten E-Mail-Nachrichten, die von Empfängern in der Exchange Server 2007-Organisation gesendet und empfangen werden.

  • Extern   Externe Regeln verarbeiten E-Mail-Nachrichten, die an Empfänger oder von Absendern außerhalb der Exchange Server 2007-Organisation gesendet werden.

TemplateInstance

Optional

System.Management.Automation.PSObject

Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet der Befehl die Konfiguration des Objekts zum Erstellen einer identischen Kopie des Objekts auf einem lokalen oder Zielserver. Weitere Informationen finden Sie unter Vorlagen.

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

Das folgende Beispiel zeigt, wie eine neue aktivierte Journalregel erstellt wird. Die Regel gilt für alle E-Mail-Nachrichten, die den Hub-Transport-Server durchlaufen und mindestens einen Empfänger oder Absender enthalten, der zur Verteilerliste "brokers@contoso.com" gehört.

New-JournalRule -Name "Brokerage Communications" -JournalEmailAddress "Brokers Journal Mailbox" -Scope Global -Recipient brokers@contoso.com -Enabled $True