다음을 통해 공유

Get-MessageTraceDetailV2

모듈:
ExchangePowerShell
적용 대상:
Exchange Online

구문

Get-MessageTraceDetailV2
   [-MessageTraceId] <Guid>
   [-RecipientAddress] <String>
   [[-Action] <MultiValuedProperty>]
   [[-EndDate] <System.DateTime>]
   [[-Event] <MultiValuedProperty>]
   [[-MessageId] <String>]
   [[-SenderAddress] <String>]
   [[-StartDate] <System.DateTime>]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 지난 90일 동안의 메시지 데이터를 검색할 수 있습니다. 쿼리당 10일 분량의 데이터만 쿼리할 수 있습니다. 90일보다 오래된 기간을 입력하면 오류가 표시되고 명령은 결과를 반환하지 않습니다.

제한 제한: 실행 기간 5분 이내에 최대 100개의 쿼리 요청이 수락됩니다. 지난 5분 동안 요청 속도가 100개 요청보다 낮으면 제한이 자동으로 적용되지 않습니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Get-MessageTraceDetailV2 -MessageTraceId ae5c1219-4c90-41bf-fef5-08d837917e7c -RecipientAddress robert@contoso.com

이 예제에서는 에서 받은 robert@contoso.com메시지 추적 ID 값 ae5c1219-4c90-41bf-fef5-08d837917e7c를 사용하여 메시지에 대한 자세한 메시지 추적 정보를 검색합니다.

예 2

Get-MessageTraceV2 -MessageTraceId 2bbad36aa4674c7ba82f4b307fff549f -SenderAddress john@contoso.com -StartDate 06/13/2025 -EndDate 06/15/2025 | Get-MessageTraceDetailV2

이 예제에서는 Get-MessageTraceV2 cmdlet을 사용하여 2025년 6월 13일부터 2025년 6월 15일까지 보낸 john@contoso.com Exchange 네트워크 메시지 ID 값이 2bbad36aa4674c7ba82f4b307fff549f인 메시지에 대한 메시지 추적 정보를 검색하고 결과를 Get-MessageTraceDetailV2 cmdlet에 파이프라인합니다.

매개 변수

-Action

적용 가능: Exchange Online

Action 매개 변수는 메시지에 대해 수행된 작업으로 보고서를 필터링합니다. 이 매개 변수에 대한 유효한 값의 전체 목록을 보려면 명령을 Get-MailFilterListReport -SelectionTarget Actions실행합니다. 지정하는 작업은 보고서 형식과 일치해야 합니다. 예를 들어 맬웨어 보고서에 대한 맬웨어 필터 작업만 지정할 수 있습니다.

Action 매개 변수는 DLP 정책, 전송 규칙, 맬웨어 필터링 또는 스팸 필터링을 통해 수행되는 작업별로 보고서를 필터링합니다. 이 매개 변수에 대한 유효한 값의 전체 목록을 보려면 Get-MailFilterListReport -SelectionTarget Actions 명령을 실행합니다. 지정하는 작업은 보고서 형식과 일치해야 합니다. 예를 들어 맬웨어 보고서에 대한 맬웨어 필터 작업만 지정할 수 있습니다.

형식:MultiValuedProperty
Position:1
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EndDate

적용 가능: Exchange Online

EndDate 매개 변수는 날짜 범위의 종료 날짜를 지정합니다.

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

StartDate 및 EndDate 매개 변수를 사용하지 않으면 지난 48시간의 데이터만 반환됩니다.

형식:System.DateTime
Position:2
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Event

적용 가능: Exchange Online

Event 매개 변수는 보고서를 메시지 이벤트별로 필터링합니다. 다음은 일반적인 이벤트의 예입니다.

  • 수신: 서비스에서 메시지를 받았습니다.
  • SEND: 서비스에서 메시지를 보냈습니다.
  • 실패: 메시지를 배달하지 못했습니다.
  • 배달: 메시지가 사서함에 배달되었습니다.
  • EXPAND: 메시지가 확장된 메일 그룹으로 전송되었습니다.
  • TRANSFER: 받는 사람이 콘텐츠 변환, 메시지 받는 사람 제한 또는 에이전트로 인해 순환된 메시지로 이동되었습니다.
  • DEFER: 메시지 배달이 연기되었으며 나중에 다시 시도할 수 있습니다.

쉼표로 구분하여 여러 값을 지정할 수 있습니다.

형식:MultiValuedProperty
Position:3
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MessageId

적용 가능: Exchange Online

MessageId 매개 변수는 메시지의 Message-ID 헤더 필드별로 결과를 필터링합니다. 이 값은 클라이언트 ID로도 알려져 있습니다. Message-ID의 형식은 메시지를 보낸 메시징 서버에 따라 달라집니다. 값은 각 메시지에 대해 고유해야 합니다. 그러나 모든 메시징 서버에서 Message-ID 값을 동일한 방식으로 생성하지는 않습니다. 전체 메시지 ID 문자열(꺾쇠 괄호를 포함할 수 있음)을 포함하고 값을 따옴표(예: "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com")로 묶어야 합니다.

형식:String
Position:4
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-MessageTraceId

적용 가능: Exchange Online

MessageTraceId 매개 변수는 메시지의 메시지 추적 ID 값으로 결과를 필터링합니다. 이 GUID 값은 시스템에서 처리하는 모든 메시지에 대해 생성됩니다(예: c20e0f7a-f06b-41df-fe33-08d9da155ac1).

형식:Guid
Position:5
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-RecipientAddress

적용 가능: Exchange Online

RecipientAddress 매개 변수는 받는 사람의 전자 메일 주소별로 결과를 필터링합니다.

형식:String
Position:6
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SenderAddress

적용 가능: Exchange Online

SenderAddress 매개 변수는 보낸 사람의 전자 메일 주소별로 결과를 필터링합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

형식:String
Position:7
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StartDate

적용 가능: Exchange Online

StartDate 매개 변수는 날짜 범위의 시작 날짜를 지정합니다.

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

StartDate 및 EndDate 매개 변수를 사용하지 않으면 지난 48시간의 데이터만 반환됩니다.

형식:System.DateTime
Position:8
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False