Get-MessageTrackingLog
이 cmdlet은 온-프레미스 Exchange에서만 제공됩니다.
Get-MessageTrackingLog cmdlet을 사용하면 메시지 추적 로그에 저장된 메시지 배달 정보를 검색할 수 있습니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Get-MessageTrackingLog
[-DomainController <Fqdn>]
[-End <DateTime>]
[-EventId <String>]
[-InternalMessageId <String>]
[-MessageId <String>]
[-MessageSubject <String>]
[-Recipients <String[]>]
[-Reference <String>]
[-ResultSize <Unlimited>]
[-Sender <String>]
[-Server <ServerIdParameter>]
[-Start <DateTime>]
[-NetworkMessageId <String>]
[-Source <String>]
[-TransportTrafficType <String>]
[<CommonParameters>] Description
사서함 서버의 전송 서비스, Edge 전송 서버 및 사서함 서버의 사서함 전송 서비스에 대한 고유한 메시지 추적 로그가 존재합니다. 메시지 추적 로그는 Exchange 서버를 통과하는 각 전자 메일 메시지의 기록에 대한 자세한 정보를 포함하는 CSV(쉼표로 구분된 값) 파일입니다.
Get-MessageTrackingLog cmdlet의 결과로 표시된 필드 이름은 메시지 추적 로그에 사용되는 실제 필드 이름과 유사합니다. 차이점은 다음과 같습니다.
- 필드 이름에서 대시가 제거됩니다. 예를 들어 internal-message-id는 InternalMessageId로 표시됩니다.
- date-time 필드는 Timestamp로 표시됩니다.
- recipient-address 필드는 Recipients로 표시됩니다.
- sender-address 필드는 Sender로 표시됩니다.
메시지 추적 로그 파일에 대한 자세한 내용은 메시지 추적을 참조하세요.
출력을 ConvertTo-Html 또는 ConvertTo-Csv 파이핑하고 명령에 추가하여 > <filename> 결과를 파일에 쓸 수 있습니다. 예: Get-MessageTrackingLog -Start "03/13/2020 09:00:00" -End "03/13/2020 09:10:00" | ConvertTo-Html > "C:\My Documents\message track.html"
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2018 09:00:00" -End "03/15/2018 17:00:00" -Sender "john@contoso.com"이 예제에서는 사서함 서버의 Mailbox01이라는 메시지 추적 로그에서 보낸 사람 에 의해 2018년 3월 13일, 09:00~2018년 3월 15일, 17:00에 전송된 모든 메시지에 대한 정보를 검색합니다 john@contoso.com.
매개 변수
-DomainController
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
Microsoft Edge 전송 서버에서는 DomainController 매개 변수가 지원되지 않습니다. Microsoft Edge 전송 서버는 AD LDS(Active Directory Lightweight Directory Service)의 로컬 인스턴스를 사용하여 데이터를 읽고 씁니다.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-End
End 매개 변수는 날짜 범위의 종료 날짜 및 시간을 지정합니다. 지정된 날짜와 시간은 포함하지 않고 그 이전까지의 메시지 배달 정보가 반환됩니다.
명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EventId
EventId 매개 변수는 EventId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. EventId 값은 각 메시지 이벤트를 분류합니다. 예를 들어 DSN, Defer, Deliver, Send 또는 Receive 값이 포함됩니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalMessageId
InternalMessageId 매개 변수는 InternalMessageId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. InternalMessageId 값은 현재 메시지를 처리하고 있는 Exchange 서버에 의해 할당되는 메시지 ID입니다.
특정 메시지에 대한 internal-message-id 값은 해당 메시지의 배달에 관련된 모든 Exchange 서버의 메시지 추적 로그에서 서로 다릅니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MessageId
MessageId 매개 변수는 MessageId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. MessageId 값은 메시지의 Message-Id: 헤더 필드 값에 해당합니다. Message-ID 헤더 필드가 비어 있거나 없으면 임의의 값이 할당됩니다. 전체 MessageId 문자열(꺾쇠괄호를 포함할 수 있음)을 포함하고 값을 따옴표(예: "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com")로 묶어야 합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MessageSubject
MessageSubject 매개 변수는 메시지 제목의 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. MessageSubject 매개 변수의 값은 와일드카드나 특수 문자를 사용하지 않고 부분 일치 항목을 자동으로 지원합니다. 예를 들어 MessageSubject 값을 sea로 지정할 경우 제목에 Seattle이 포함된 메시지도 결과에 포함됩니다. 기본적으로 메시지 제목은 메시지 추적 로그에 저장됩니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-NetworkMessageId
NetworkMessageId 매개 변수는 NetworkMessageId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. 이 필드에는 분기 또는 메일 그룹 확장으로 인해 작성될 수 있는 메시지 복사본 전체에서 유지되는 고유한 메시지 ID 값이 포함됩니다. 1341ac7b13fb42ab4d4408cf7f55890f와 같은 값을 예로 들 수 있습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Recipients
Recipients 매개 변수는 메시지 받는 사람의 SMTP 전자 메일 주소를 기준으로 메시지 추적 로그 항목을 필터링합니다. 단일 메시지의 받는 사람이 여러 명이라도 모두 단일 메시지 추적 로그 항목에 기록됩니다. 확장되지 않는 메일 그룹 받는 사람은 해당 그룹의 SMTP 전자 메일 주소를 사용하여 기록됩니다. 받는 사람 전자 메일 주소가 여러 개인 경우 각 주소를 쉼표로 구분하여 지정할 수 있습니다.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Reference
Reference 매개 변수는 참조 필드 값으로 메시지 추적 로그 항목을 필터링합니다. 참조 필드에는 특정 유형의 이벤트에 대한 추가 정보가 포함되어 있습니다. 예를 들어 DSN 메시지 추적 항목에 대한 참조 필드 값에는 DSN을 발생시킨 메시지의 InternalMessageId 값이 포함됩니다. 여러 유형의 이벤트의 경우 참조 값이 비어 있습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResultSize
ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1,000입니다.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Sender
Sender 매개 변수는 보낸 사람의 SMTP 전자 메일 주소를 기준으로 메시지 추적 로그 항목을 필터링합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
Server 매개 변수는 이 명령을 실행할 Exchange 서버를 지정합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예제:
- 이름
- FQDN
- DN(고유 이름)
- Exchange 레거시 DN
Exchange 레거시 DN
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Source
Source 매개 변수는 MessageId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. 이러한 값은 메시지 추적 이벤트를 담당 하는 전송 구성 요소를 나타냅니다. 자세한 내용은 Source values in the message tracking log를 참조하십시오.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Start
Start 매개 변수는 날짜 범위의 시작 날짜 및 시간을 지정합니다.
명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TransportTrafficType
TransportTrafficType 매개 변수는 MessageId 필드 값을 기준으로 메시지 추적 로그 항목을 필터링합니다. 그러나 이 필드는 온-프레미스 Exchange 조직에서는 흥미롭지 않습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.