Get-MessageTrackingLog

 

적용 대상:Exchange Server 2016

마지막으로 수정된 항목:2015-11-19

이 cmdlet은 온-프레미스 Exchange Server 2016에서만 제공됩니다.

Get-MessageTrackingLog cmdlet을 사용하면 메시지 추적 로그에 저장된 메시지 배달 정보를 검색할 수 있습니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하세요.

Get-MessageTrackingLog [-EventId <String>] [-InternalMessageId <String>] [-MessageId <String>] [-MessageSubject <String>] [-NetworkMessageId <String>] [-Recipients <String[]>] [-Reference <String>] [-Sender <String>] [-Source <String>] [-DomainController <Fqdn>] [-End <DateTime>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-Start <DateTime>]
[-TransportTrafficType <String>]

이 예제에서는 Mailbox01이라는 사서함 서버의 메시지 추적 로그에서 보낸 사람이 john@contoso.com이고 보낸 날짜가 2015년 3월 13일 09:00에서 2015년 3월15일 17:00 사이인 모든 메시지에 대한 정보를 검색합니다.

Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2015 09:00:00" -End "03/15/2015 17:00:00" -Sender "john@contoso.com"

사서함 서버의 전송 서비스, Edge 전송 서버 및 사서함 서버의 사서함 전송 서비스에 대한 고유한 메시지 추적 로그가 존재합니다. 메시지 추적 로그는 Exchange 서버를 통과하는 각 전자 메일 메시지의 기록에 대한 자세한 정보를 포함하는 CSV(쉼표로 구분된 값) 파일입니다.

Get-MessageTrackingLog cmdlet의 결과로 표시된 필드 이름은 메시지 추적 로그에 사용되는 실제 필드 이름과 유사합니다. 차이점은 다음과 같습니다.

  • 필드 이름에서 대시가 제거됩니다. 예를 들어 internal-message-idInternalMessageId로 표시됩니다.

  • date-time 필드는 Timestamp로 표시됩니다.

  • recipient-address 필드는 Recipients로 표시됩니다.

  • sender-address 필드는 Sender로 표시됩니다.

메시지 추적 로그 파일에 대한 자세한 내용은 메시지 추적을 참조하세요.

Get-MessageTrackingLog 결과가 화면에 표시됩니다. 출력을 ConvertTo-Html 또는 ConvertTo-Csv로 파이프 처리하고 명령에 "> <filename>"을 추가하여 파일에 결과를 쓸 수 있습니다. 예를 들면 다음과 같습니다.

Get-MessageTrackingLog -Start "03/13/2014 09:00:00" -End "03/13/2014 09:10:00" | ConvertTo-Html > "C:\My Documents\message track.html"

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 cmdlet의 모든 매개 변수가 이 항목에 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 필요한 사용 권한을 확인하려면 다음을 참조하세요.메일 흐름 사용 권한 항목의 "메시지 추적" 항목

 

매개 변수 필수 종류 설명

DomainController

옵션

Microsoft.Exchange.Data.Fqdn

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 데이터를 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화 된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

DomainController 매개 변수는 Edge 전송 서버에서 지원되지 않습니다. Edge 전송 서버는 AD LDS(Active Directory Lightweight Directory Service)의 로컬 인스턴스를 사용하여 데이터를 읽고 씁니다.

End

옵션

System.DateTime

End 매개 변수는 날짜 범위의 종료 날짜 및 시간을 지정합니다. 지정된 날짜와 시간은 포함하지 않고 그 이전까지의 메시지 배달 정보가 반환됩니다.

명령을 실행하는 컴퓨터의 국가별 옵션 설정에 정의된 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2015를 입력하여 2015년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다(예: "09/01/2015 5:00 PM").

EventId

선택

System.String

EventId 매개 변수는 EventId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. EventId 값은 각 메시지 이벤트를 분류합니다. 예를 들어 DSN, Defer, Deliver, Send 또는 Receive 값이 포함됩니다.

InternalMessageId

선택

System.String

InternalMessageId 매개 변수는 InternalMessageId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. InternalMessageId 값은 현재 메시지를 처리하고 있는 Exchange 서버에 의해 할당되는 메시지 ID입니다.

특정 메시지에 대한 internal-message-id 값은 해당 메시지의 배달에 관련된 모든 Exchange 서버의 메시지 추적 로그에서 서로 다릅니다.

MessageId

선택

System.String

MessageId 매개 변수는 MessageId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. MessageId 값은 메시지의 Message-Id: 헤더 필드 값에 해당합니다. Message-ID 헤더 필드가 비어 있거나 없으면 임의의 값이 할당됩니다.

MessageSubject

선택

System.String

MessageSubject 매개 변수는 메시지 제목의 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. MessageSubject 매개 변수의 값은 와일드카드나 특수 문자를 사용하지 않고 부분 일치 항목을 자동으로 지원합니다. 예를 들어 MessageSubject 값을 sea로 지정할 경우 제목에 Seattle이 포함된 메시지도 결과에 포함됩니다. 기본적으로 메시지 제목은 메시지 추적 로그에 저장됩니다.

NetworkMessageId

선택

System.String

NetworkMessageId 매개 변수는 NetworkMessageId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. 이 필드에는 분기 또는 메일 그룹 확장으로 인해 작성될 수 있는 메시지 복사본 전체에서 유지되는 고유한 메시지 ID 값이 포함됩니다. 1341ac7b13fb42ab4d4408cf7f55890f와 같은 값을 예로 들 수 있습니다.

Recipients

선택

System.String[]

Recipients 매개 변수는 메시지 받는 사람의 SMTP 전자 메일 주소를 기준으로 메시지 추적 로그 항목을 필터링합니다. 단일 메시지의 받는 사람이 여러 명이라도 모두 단일 메시지 추적 로그 항목에 기록됩니다. 확장되지 않는 메일 그룹 받는 사람은 해당 그룹의 SMTP 전자 메일 주소를 사용하여 기록됩니다. 받는 사람 전자 메일 주소가 여러 개인 경우 각 주소를 쉼표로 구분하여 지정할 수 있습니다.

Reference

선택

System.String

Reference 매개 변수는 Reference 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. Reference 필드에는 특정 유형의 이벤트에 대한 추가 정보가 포함됩니다. 예를 들어 DSN 메시지 추적 항목의 Reference 필드 값에는 DSN을 생성한 메시지의 InternalMessageId 값이 포함됩니다. 대부분의 이벤트 유형에서는 Reference 값이 비어 있습니다.

ResultSize

옵션

Microsoft.Exchange.Data.Unlimited

ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1000입니다.

Sender

선택

System.String

Sender 매개 변수는 보낸 사람의 SMTP 전자 메일 주소를 기준으로 메시지 추적 로그 항목을 필터링합니다.

Server

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 매개 변수는 이 명령을 실행하려는 Exchange 서버를 지정합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름

  • FQDN

  • DN(고유 이름)

  • Exchange 레거시 DN

이 매개 변수를 사용하지 않으면 로컬 서버에서 명령이 실행됩니다.

Source

선택

System.String

Source 매개 변수는 MessageId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. 이러한 값은 메시지 추적 이벤트를 담당 하는 전송 구성 요소를 나타냅니다. 자세한 내용은 Source values in the message tracking log를 참조하십시오.

Start

옵션

System.DateTime

Start 매개 변수는 날짜 범위의 시작 날짜 및 시간을 지정합니다.

명령을 실행하는 컴퓨터의 국가별 옵션 설정에 정의된 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2015를 입력하여 2015년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다(예: "09/01/2015 5:00 PM").

TransportTrafficType

선택

System.String

TransportTrafficType 매개 변수는 MessageId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. 이 필드는 온-프레미스 Exchange 조직에서는 사용되지 않습니다.

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.

 
표시: