New-JournalRule

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2007-08-13

Командлет New-JournalRule предназначен для создания нового правила журнала на компьютере с установленной ролью транспортного сервера-концентратора Microsoft Exchange Server 2007.

Синтаксис

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

Подробное описание

Командлет New-JournalRule создает правило журнала, используемое агентом ведения журналов.

По умолчанию новые правила журнала включены, если параметру Enabled не присвоено значение $False. Дополнительные сведения о включение нового правила журнала, созданного в отключенном состоянии, см. в разделе Enable-JournalRule.

Для выполнения командлета New-JournalRule используемой учетной записи необходимо делегировать следующую роль:

  • роль администратора организации Exchange.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange 2007, приведены в разделе Вопросы, связанные с разрешениями.

Параметры

Параметр Обязательный Тип Описание

JournalEmailAddress

Обязательный

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Этот параметр определяет объект получателя, которому отправляются отчеты журнала.

Name

Обязательный

System.String

Используйте этот параметр для указания имени правила журнала. Имя правила может состоять максимум из 64 символов.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Указывать значение параметра Confirm не требуется.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController.

Enabled

Необязательный

System.Boolean

Используйте этот параметр, чтобы указать, включено ли правило журнала или отключено. Если правило отключено, оно не применяется к адресам электронной почты. Значение по умолчанию: $False.

Recipient

Необязательный

System.Nullable

Этот параметр определяет SMTP-адрес почтового ящика, контакта или группы рассылки, для которых ведется журнал. Если задана группа рассылки, журнал ведется для всех получателей в ней. Все сообщения, отправляемые получателю и принимаемые от него, будут регистрироваться в журнале.

Scope

Необязательный

Microsoft.Exchange.MessagingPolicies.Journaling.JournalRuleScope

Этот параметр позволяет указать допустимый адрес электронной почты, к которому применяются правила журнала. Допустимы следующие значения:

  • Global.   Глобальные правила обрабатывают все сообщения электронной почты, которые проходят через сервер узлового транспорта. Это также сообщения электронной почты, которые уже были обработаны с помощью внешних или внутренних правил. Значение по умолчанию: Global.

  • Internal.   Внутренние правила обрабатывают сообщения электронной почты, которые были направлены или получены получателями организации Exchange Server 2007.

  • External.   Внешние правила обрабатывают сообщения электронной почты, которые посылаются или принимаются от отправителей вне организации Exchange Server 2007.

TemplateInstance

Необязательный

System.Management.Automation.PSObject

Когда существующий объект предоставляется этому параметру, команда использует конфигурацию объекта для создания точной копии объекта на локальном или целевом сервере. Дополнительные сведения см. в разделе Шаблоны.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

Исключения

Исключения Описание

Пример

В следующем примере показано, как создать новое включенное правило журнала. Правило применяется ко всем адресам электронной почты, проходящим через сервер узлового транспорта и содержащим, по меньшей мере, одного получателя или отправителя, являющегося членом списка рассылки brokers@contoso.com.

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