New-JournalRule

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-08-13

La cmdlet New-JournalRule permet de créer une règle de journal sur un ordinateur sur lequel le rôle serveur de transport Hub Microsoft Exchange Server 2007 est installé.

Syntaxe

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

Description détaillée

La cmdlet New-JournalRule crée une règle de journal à utiliser avec l'agent de journalisation.

Par défaut, les nouvelles règles de journal sont activées sauf si le paramètre Enabled est défini sur $False. Pour plus d'informations sur la procédure d'activation d'une nouvelle règle de journal désactivée, consultez la rubrique Enable-JournalRule.

Pour exécuter la cmdlet New-JournalRule, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateur d'organisation Exchange.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

JournalEmailAddress

Obligatoire

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Utilisez ce paramètre pour spécifier un objet destinataire valide auquel les états de journal sont envoyés.

Name

Obligatoire

System.String

Ce paramètre permet de spécifier le nom de la règle de journal. Le nom de la règle peut comporter jusqu'à 64 caractères.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande.

Enabled

Facultatif

System.Boolean

Ce paramètre permet de spécifier si la règle de journal est activée ou désactivée. Si la règle est désactivée, elle n'est pas appliquée aux messages électroniques. La valeur par défaut est $False.

Recipient

Facultatif

System.Nullable

Utilisez ce paramètre pour spécifier l'adresse SMTP d'une boîte aux lettres, d'un contact ou d'un groupe de distribution à journaliser. Si vous spécifiez un groupe de distribution, tous les destinataires de ce groupe de distribution sont journalisés. Tous les messages échangés avec ce destinataire sont journalisés.

Scope

Facultatif

Microsoft.Exchange.MessagingPolicies.Journaling.JournalRuleScope

Utilisez ce paramètre pour spécifier les messages électroniques auxquels la règle de journal est appliquée. Les valeurs valides pour ce paramètre sont les suivantes :

  • Globale   Les règles globales traitent tous les messages électroniques qui transitent par un serveur de transport Hub. Ceci inclut les messages électroniques déjà traités par les règles externes et internes. La valeur par défaut est Global.

  • Interne   Les règles internes traitent les messages électroniques échangés par des destinataires au sein de l'organisation Exchange Server 2007.

  • Externe   Les règles externes traitent les messages électroniques échangés entre des destinataires ou des expéditeurs externes à l'organisation Exchange Server 2007.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Lorsqu'un objet existant est fourni pour ce paramètre, la commande utilise la configuration de l'objet pour créer une copie identique de l'objet sur un serveur local ou cible. Pour plus d'informations, consultez la rubrique Modèles.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exceptions

Exceptions Description

Exemple

L'exemple suivant montre comment créer une règle de journal activée. La règle s'applique à tous les messages électroniques qui transitent via le serveur de transport Hub et contiennent au moins un destinataire ou expéditeur membre de la liste de distribution courtiers@contoso.com.

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