Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

Командлет Set-AdminAuditLogConfig используется для настройки параметров конфигурации ведения журнала аудита администратора.

Синтаксис

Set-AdminAuditLogConfig [-Identity <OrganizationIdParameter>] [-AdminAuditLogAgeLimit <EnhancedTimeSpan>] [-AdminAuditLogCmdlets <MultiValuedProperty>] [-AdminAuditLogEnabled <$true | $false>] [-AdminAuditLogExcludedCmdlets <MultiValuedProperty>] [-AdminAuditLogParameters <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-Name <String>] [-TestCmdletLoggingEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Параметры

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

AdminAuditLogAgeLimit

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

Microsoft.Exchange.Data.EnhancedTimeSpan

Параметр AdminAuditLogAgeLimit указывает продолжительность хранения каждой записи журнала перед ее удалением. Значение по умолчанию — один год.

Чтобы очистить максимальное время хранения, укажите значение $null. Если снять возрастной предел, записи журнала никогда не будут удаляться.

Внимание!
Задание значения меньше текущего приведет к удалению записей журнала, выходящих за новый предел.

Установка предела 0 приводит к очистке всех записей журнала аудита.

AdminAuditLogCmdlets

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр AdminAuditLogCmdlets указывает, аудит какого командлета необходимо выполнить. Можно указать один или несколько командлетов, разделенных запятыми. Также можно использовать подстановочный знак (*), чтобы указать несколько командлетов в одной или нескольких записях списка командлетов. Чтобы выполнить аудит всех командлетов, укажите только подстановочный знак (*).

AdminAuditLogEnabled

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

System.Boolean

Параметр AdminAuditLogEnabled указывает, включено ли ведение журнала аудита администратора. Значение по умолчанию: $false. Допустимые значения ввода — $true и $false. Перед включением ведения журнала необходимо указать почтовый ящик для журнала аудита администратора.

Примечание.
Изменения в конфигурации журнала административного аудита всегда фиксируются в журнале вне зависимости от того, включен или отключен журнал аудита.

AdminAuditLogExcludedCmdlets

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр AdminAuditLogExcludedCmdlets указывает, какие командлеты необходимо исключить из аудита. Используйте этот параметр, если требуется исключить из аудита отдельные командлеты, даже если они соответствуют подстановочной строке в параметре AdminAuditLogCmdlets.

Можно указать один или несколько командлетов, разделенных запятыми. Также можно использовать подстановочный знак (*), чтобы указать несколько командлетов в одной или нескольких записях списка командлетов. Нельзя указывать только подстановочный знак (*).

Если требуется очистить список, укажите значение $Null.

AdminAuditLogParameters

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр AdminAuditLogParameters указывает, аудит каких параметров необходимо выполнить в командлетах, заданных в параметре AdminAuditLogCmdlets. Можно указать один или несколько параметров, разделенных запятыми. Также можно использовать подстановочный знак (*), чтобы указать несколько параметров в одной или нескольких записях списка параметров. Чтобы выполнить аудит всех параметров, укажите только подстановочный знак (*).

Confirm

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

System.Management.Automation.SwitchParameter

DomainController

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

Microsoft.Exchange.Data.Fqdn

Force

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

System.Management.Automation.SwitchParameter

Параметр Force указывает, необходимо ли предотвращать отображение предупреждающих или подтверждающих сообщений при выполнении определенных изменений конфигурации.

Identity

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

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

Name

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

System.String

Параметр Name указывает имя объекта AdminAuditLogConfig.

Примечание.
При настройке ведения журнала аудита администратора этот параметр указывать необязательно. Он не влияет на конфигурацию или способ ведения журнала административного аудита.

TestCmdletLoggingEnabled

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

System.Boolean

Параметр TestCmdletLoggingEnabled определяет, будет ли выполнение командлетов проверки записываться в журнал. Командлеты проверки начинаются со слова Test. Переменная может иметь значение $true или $false. По умолчанию параметр имеет значение $false.

Важно!
Командлеты проверки могут выводить большое количество данных. В связи с этим запись командлетов проверки в журнал необходимо включать только на короткое время.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Если включено ведение журнала аудита, запись журнала создается для каждого выполненного командлета, кроме командлетов Get. В RTM-версии Microsoft Exchange Server 2010 записи журнала хранятся в указанном почтовом ящике журнала аудита и просматриваются с помощью почтового клиента или Microsoft Office Outlook Web App. В версии Exchange 2010 с пакетом обновления 1 (SP1) записи журнала хранятся в скрытом почтовом ящике и обрабатываются командлетами Search-AdminAuditLog и New-AdminAuditLogSearch. Дополнительные сведения о ведении журнала административного аудита см. в разделе Общие сведения о ведении журнала аудита администратора.

Важно!
Командлеты Set-AdminAuditLogConfig, Enable-CmdletExtensionAgent и Disable-CmdletExtensionAgent заносятся в журнал при запуске вне зависимости от того, включен или выключен журнал административного аудита.

При ведении журнала аудита администратора используется репликация Служба каталогов Active Directory для выполнения репликации параметров конфигурации, указанных для контроллеров домена в организации. В зависимости от параметров репликации выполненные изменения не сразу применяются ко всем серверам Microsoft Exchange 2010 в организации.

На компьютерах, на которых во время изменения конфигурации открыта командная консоль Exchange, изменения конфигурации журнала аудита могут занять до 60 минут. Если изменения необходимо применить немедленно, на каждом компьютере закройте и снова откройте консоль.

Запись «Ведение журнала аудита администратора» в разделе Разрешения инфраструктуры Exchange и командной консоли.

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

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

Ошибки

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

 

Примеры

ПРИМЕР 1

В этом примере выполняется включение ведения журнала административного аудита для каждого командлета и параметра в организации за исключением командлетов Get.

Скопировать код
Set-AdminAuditLogConfig -AdminAuditLogEnabled $true -AdminAuditLogCmdlets * -AdminAuditLogParameters *

ПРИМЕР 2

В этом примере выполняется включение ведения журнала аудита администратора для указанных командлетов, используемых в организации. В журнал заносятся сведения обо всех параметрах, используемых указанными командлетами. При каждом запуске одного из указанных командлетов в журнал аудита добавляется запись.

Скопировать код
Set-AdminAuditLogConfig -AdminAuditLogEnabled $true -AdminAuditLogCmdlets *Mailbox, *Management*, *TransportRule* -AdminAuditLogParameters *

ПРИМЕР 3

В этом примере выполняется включение ведения журнала аудита администратора только для определенных параметров, указанных при запуске определенных командлетов. Имя параметра и имя командлета должны совпадать со строками, указанными в параметрах AdminAuditLogCmdlets и AdminAuditLogParameters. Например, запись журнала создается только в том случае, если параметр, имя которого содержит строку «Address"», указывается в командлете, имя которого содержит строку «Mailbox».

Скопировать код
Set-AdminAuditLogConfig -AdminAuditLogEnabled $true -AdminAuditLogCmdlets *Mailbox* -AdminAuditLogParameters *Address*