Командлет 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>]] |
Параметры
Параметр | Обязательный | Тип | Описание |
---|---|---|---|
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 |
Используйте этот параметр, чтобы указать, включено ли правило
журнала или отключено. Если правило отключено, оно не применяется к
адресам электронной почты. Значение по умолчанию:
|
Recipient |
Необязательный |
System.Nullable |
Этот параметр определяет SMTP-адрес почтового ящика, контакта или группы рассылки, для которых ведется журнал. Если задана группа рассылки, журнал ведется для всех получателей в ней. Все сообщения, отправляемые получателю и принимаемые от него, будут регистрироваться в журнале. |
Scope |
Необязательный |
Microsoft.Exchange.MessagingPolicies.Journaling.JournalRuleScope |
Этот параметр позволяет указать допустимый адрес электронной почты, к которому применяются правила журнала. Допустимы следующие значения:
|
TemplateInstance |
Необязательный |
System.Management.Automation.PSObject |
Когда существующий объект предоставляется этому параметру, команда использует конфигурацию объекта для создания точной копии объекта на локальном или целевом сервере. Дополнительные сведения см. в разделе Шаблоны. |
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется. |
Подробное описание
Командлет New-JournalRule создает правило журнала, используемое агентом ведения журналов.
По умолчанию новые правила журнала включены, если
параметру Enabled не присвоено значение $False
.
Дополнительные сведения о включение нового правила журнала,
созданного в отключенном состоянии, см. в разделе Enable-JournalRule.
Для выполнения командлета New-JournalRule используемой учетной записи необходимо делегировать следующую роль:
- роль администратора организации Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange 2007, приведены в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Исключения
Исключения | Описание |
---|---|
Пример
В следующем примере показано, как создать новое включенное правило журнала. Правило применяется ко всем адресам электронной почты, проходящим через сервер узлового транспорта и содержащим, по меньшей мере, одного получателя или отправителя, являющегося членом списка рассылки brokers@contoso.com.
Копировать код | |
---|---|
New-JournalRule -Name "Brokerage Communications" -JournalEmailAddress "Brokers Journal Mailbox" -Scope Global -Recipient brokers@contoso.com -Enabled $True |