Set-JournalRule

  • Статья

 

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

Последнее изменение раздела: 2009-04-09

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

Синтаксис

Set-JournalRule -Identity <RuleIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-JournalEmailAddress <RecipientIdParameter>] [-Name <String>] [-Recipient <Nullable>] [-Scope <Internal | External | Global>] [-WhatIf [<SwitchParameter>]]

Set-JournalRule [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <JournalRuleObject>] [-JournalEmailAddress <RecipientIdParameter>] [-Name <String>] [-Recipient <Nullable>] [-Scope <Internal | External | Global>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

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

Параметры

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

Identity

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

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

Используйте этот параметр для указания идентификатора GUID или имени правила, которое необходимо изменить.

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Instance

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

Microsoft.Exchange.MessagingPolicies.Journaling.JournalRuleObject

Этот параметр позволяет отправить целый объект на обработку команде. Он обычно используется в сценариях, где целый объект должен быть отправлен команде.

JournalEmailAddress

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Этот параметр определяет объект получателя, которому отправляются отчеты журнала. Отчеты журналов можно отправлять в почтовый ящик, контакту, пользователю электронной почты или в группу рассылки. При этом, однако, в качестве адреса электронной почты журнала JournalEmailAddress нельзя использовать общую папку — этот вариант не поддерживается.

Name

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

System.String

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

Recipient

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

System.Nullable

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

Scope

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

Microsoft.Exchange.MessagingPolicies.Journaling.JournalRuleScope

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

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

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

 

Исключения

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

 

Пример

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

Set-JournalRule "Brokerage Communications" -JournalEmailAddress "Archive Mailbox"