Настройка конвейерной трассировкиConfigure pipeline tracing

Применимо к: Exchange Server 2013Applies to: Exchange Server 2013

Конвейерная трассировка записывает копии почтовых сообщений при их перемещении по транспортному конвейеру в транспортной службе или транспортной службе почтовых ящиков на сервере почтовых ящиков и на пограничных транспортных серверах.Pipeline tracing captures copies of email messages as they move through the transport pipeline in the Transport service or the Mailbox Transport service on Mailbox server and on Edge Transport servers.

Что нужно знать перед началом работыWhat do you need to know before you begin?

  • Предполагаемое время для завершения каждой процедуры: 15 минут.Estimated time to complete this procedure: 15 minutes

  • Для выполнения этих процедур необходимы соответствующие разрешения. Сведения о необходимых разрешениях см. в статье Записи "Служба транспорта" и "Транспортная служба почтовых ящиков" в разделе Разрешения потока обработки почты.You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the"Transport Service" and "Mailbox Transport Service" entries in the Mail flow permissions topic.

  • Для выполнения этой процедуры можно использовать только командную консоль.You can only use the Shell to perform this procedure.

  • Функция конвейерной трассировки копирует все содержимое сообщений электронной почты, которые отправляются с адреса электронной почты отправителя. Чтобы избежать раскрытия конфиденциальной информации, необходимо установить для папки конвейерной трассировки соответствующие разрешения системы безопасности.Pipeline tracing copies the complete contents of email messages that are sent from the sender's email address. To avoid unwanted exposure of confidential information, you need to set appropriate security permissions on the location of the pipeline tracing folder.

  • Не следует включать конвейерную трассировку на длительный период времени. Во время конвейерной трассировки создается несколько файлов мгновенных снимков, которые быстро накапливаются. Если включена конвейерная трассировка, всегда следите за объемом свободного дискового пространства.Don't enable pipeline tracing for long periods of time. Pipeline tracing creates multiple message snapshot files that accumulate quickly. Always monitor available disk space when pipeline tracing is enabled.

  • Сочетания клавиш для процедур, описанных в этой статье, приведены в статье Сочетания клавиш в Центре администрирования Exchange.For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.

Совет

Возникли проблемы? Обращение за помощью в форумах Exchange. Посетите форумы Exchange Server, Exchange Onlineили Exchange Online Protection.Having problems? Ask for help in the Exchange forums. Visit the forums at Exchange Server, Exchange Online, or Exchange Online Protection.

Что необходимо сделать?What do you want to do?

Включение и настройка конвейерной трассировкиEnable and configure pipeline tracing

Действие 1. Использование командной консоли для настройки адреса отправителя конвейерной трассировкиStep 1: Use the Shell to configure the pipeline tracing sender address

Чтобы настроить адрес отправителя конвейерной трассировки, введите команду в следующем формате.Use the following syntax to configure the pipeline tracing sender address.

    <Set-TransportService | Set-MailboxTransportService> <ServerIdentity> -PipelineTracingSenderAddress <SMTPAddress | "<>">

Этот пример настраивает конвейерную трассировку для получения мгновенных снимков всех сообщений, отправленных с адреса chris@contoso.com в службе транспорта на сервере почтовых ящиков Mailbox01.This example configures pipeline tracing to capture snapshots of all messages sent by the sender chris@contoso.com in the Transport service on the Mailbox server named Mailbox01.

Set-TransportService Mailbox01 -PipelineTracingSenderAddress chris@contoso.com

В этом примере конвейерная трассировка настраивается для получения мгновенных снимков всех созданных системой сообщений, полученных службой транспорта на сервере почтовых ящиков Mailbox02.This example configures pipeline tracing to capture snapshots of all the system-generated messages received by the Transport service on the Mailbox server named Mailbox02.

Set-TransportService Mailbox02 -PipelineTracingSenderAddress "<>"

Предупреждение

Если настроить конвейерную трассировку для записи всех созданных серверами сообщений в службе транспорта, нагрузка на сервер может сильно возрасти, а свободное место на диске может быстро закончиться. Если включена конвейерная трассировка, всегда следите за объемом свободного дискового пространства.Configuring pipeline tracing to capture all server-generated messages in a transport service may place a significant load on the server and may quickly consume available disk space. Always monitor available disk space when pipeline tracing is enabled.

Действие 2. (Необязательно) Использование командной консоли для указания папки конвейерной трассировкиStep 2: (Optional) Use the Shell to specify a custom pipeline tracing folder

По умолчанию папку конвейерной трассировки не существует, пока не после включения конвейерной трассировки, а также сообщения, которые соответствуют требованиям укажите с помощью потока параметр PipelineTracingSenderAddress через службу транспорта на сервере. Для транспортной службы на сервере почтовых ящиков, расположением по умолчанию является %ExchangeInstallPath%TransportRoles\Logs\Hub\PipelineTracing. Для транспортной службы почтовых ящиков на сервере почтовых ящиков, расположением по умолчанию является %ExchangeInstallPath%TransportRoles\Logs\Mailbox\PipelineTracing. При указании пользовательского пути, путь должен быть на локальном сервере Exchange.The default pipeline tracing folder doesn't exist until after you enable pipeline tracing, and messages that meet the criteria you specify using the PipelineTracingSenderAddress parameter flow through the transport service on the server. For the Transport service on a Mailbox server, the default location is %ExchangeInstallPath%TransportRoles\Logs\Hub\PipelineTracing. For the Mailbox Transport service on a Mailbox server, the default location is %ExchangeInstallPath%TransportRoles\Logs\Mailbox\PipelineTracing. If you specify a custom path, the path must be on the local Exchange server.

Чтобы настроить папку конвейерной трассировки, введите команду в следующем формате.Use the following syntax to configure the pipeline tracing folder.

    <Set-TransportService | Set-MailboxTransportService> <ServerIdentity> -PipelineTracingPath <LocalFilePath>

В этом примере задается папку конвейерной трассировки для транспортной службы на сервере почтовых ящиков с именем Mailbox01 на D:\сервера-концентратора\конвейерной трассировки.This example sets the pipeline tracing folder for the Transport service on the Mailbox server named Mailbox01 to D:\Hub\Pipeline Tracing.

Set-TransportService Mailbox01 -PipelineTracingPath "D:\Hub\Pipeline Tracing"

Действие 3. Использование командной консоли для включения конвейерной трассировкиStep 3: Use the Shell to enable pipeline tracing

По умолчанию конвейерная трассировка отключена на всех серверах Exchange. Включая конвейерную трассировку, вы активируете ее в указанной транспортной службе только на заданном сервере Exchange. Перед включением конвейерной трассировки укажите адрес отправителя, как описано в шаге 1.By default, pipeline tracing is disabled on all Exchange servers. When you enable pipeline tracing, you are enabling pipeline tracing in the specified transport service on the specified Exchange server only. Before you enable pipeline tracing, you need to specify the sender address as described in Step 1.

Для включения конвейерной трассировки введите команду в следующем формате.Use the following syntax to enable pipeline tracing.

    <Set-TransportService | Set-MailboxTransportService> <ServerIdentity> -PipelineTracingEnabled $true

В этом примере активируется конвейерная трассировка в службе транспорта на сервере почтовых ящиков с именем Mailbox01.This example enables pipeline tracing in the Transport service on the Mailbox server named Mailbox01.

Set-TransportService Mailbox01 -PipelineTracingEnabled $true

Как проверить, что все получилось?How do you know this worked?

Чтобы убедиться, что вы успешно настроили конвейерную трассировку, выполните следующие действия:To verify that you have successfully configured pipeline tracing, do the following:

  1. Выполните следующую команду:Run the following command:

        <Get-TransportService | Get-MailboxTransportService> <ServerIdentity> | Format-List PipelineTracing*
    
  2. Убедитесь, что отображаются значения, которые вы настроили.Verify the values displayed are the values you configured.

  3. Проверьте папку конвейерной трассировки для службы транспорта или транспортной службы почтовых ящиков и убедитесь, что файлы снимков сообщений создаются в папке.Check the pipeline tracing folder for the Transport service or the Mailbox Transport service, and verify message snapshot files are being created in the folder.

Отключение конвейерной трассировкиDisable pipeline tracing

Из-за вопросов о месте на диске и безопасности, связанных с конвейерной трассировкой, подобная операция — это временное действие для диагностики или устранения неполадок. Включая конвейерную трассировку, не забывайте отключить ее, завершив ее применение.Because of the disk space and security concerns associated with pipeline tracing, pipeline tracing is a temporary action for diagnostic or troubleshooting purposes. Whenever you enable pipeline tracing, always remember to disable it when you are finished.

Для отключения конвейерной трассировки введите команду в следующем формате.Use the following syntax to disable pipeline tracing.

    <Set-TransportService | Set-MailboxTransportService> <ServerIdentity> -PipelineTracingEnabled $false

В этом примере отключается конвейерная трассировка в службе транспорта на сервере почтовых ящиков с именем Mailbox01.This example disables pipeline tracing in the Transport service on the Mailbox server named Mailbox01.

Set-TransportService Mailbox01 -PipelineTracingEnabled $false

Как проверить, что все получилось?How do you know this worked?

Чтобы убедиться, что вы успешно отключили конвейерную трассировку, выполните следующие действия:To verify that you have successfully disabled pipeline tracing, do the following:

  1. Выполните следующую команду:Run the following command:

        <Get-TransportService | Get-MailboxTransportService> <ServerIdentity> | Format-List PipelineTracingEnabled
    
  2. Убедитесь, что значение параметра PipelineTracingEnabled равно $false.Verify the value of the PipelineTracingEnabled parameter is $false.

  3. Проверьте папку конвейерной трассировки и убедитесь, что файлы снимков сообщений больше не создаются в папке.Check the pipeline tracing folder, and verify message snapshot files are no longer being created in the folder.