Get-MessageTraceV2
이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.
Get-MessageTraceV2 cmdlet을 사용하여 클라우드 기반 organization 전달할 때 메시지를 추적합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Get-MessageTraceV2
[[-EndDate] <System.DateTime>]
[[-FromIP] <String>]
[[-MessageId] <MultiValuedProperty>]
[[-MessageTraceId] <System.Guid>]
[[-RecipientAddress] <MultiValuedProperty>]
[[-ResultSize] <Int32>]
[[-SenderAddress] <MultiValuedProperty>]
[[-StartDate] <System.DateTime>]
[[-StartingRecipientAddress] <String>]
[[-Status] <MultiValuedProperty>]
[[-SubjectFilterType] <String>]
[[-Subject] <String>]
[[-ToIP] <String>]
[<CommonParameters>]
Description
이 cmdlet을 사용하여 지난 90일 동안의 메시지 데이터를 검색할 수 있습니다. 매개 변수 없이 이 cmdlet을 실행하면 지난 48시간 동안의 데이터만 반환됩니다. 쿼리당 10일 분량의 데이터만 반환할 수 있습니다.
기본적으로 이 cmdlet은 최대 5,000개 결과와 함께 최대 1,000개 결과를 반환합니다. 데이터가 결과 크기를 초과하는 경우 여러 라운드로 쿼리하거나 더 작은 StartDate 및 EndDate 간격을 사용합니다.
출력의 타임스탬프는 UTC 시간 형식입니다. -StartDate 및 -EndDate 매개 변수에 사용한 시간 형식과 다를 수 있습니다.
제한 제한: 5분 실행 기간 내에 최대 100개의 쿼리 요청이 허용됩니다. 지난 5분 동안 요청 속도가 100개 요청보다 낮으면 제한이 자동으로 적용되지 않습니다.
이 cmdlet에서는 페이지 매김이 지원되지 않습니다. 후속 데이터를 쿼리하려면 StartingRecipientAddress 및 EndDate 매개 변수를 다음 쿼리에서 이전 결과의 각각 받는 사람 주소 및 수신 시간 속성의 값과 함께 사용합니다.
모범 사례:
- ResultSize 매개 변수를 사용하여 결과의 크기를 조정합니다.
- 가능한 한 정확해야 합니다. StartDate와 EndDate 사이의 간격을 좁히고 가능한 경우 추가 매개 변수(예: SenderAddress)를 사용합니다.
- 가능한 경우 MessageTraceId를 사용합니다(1,000명 이상의 받는 사람에게 보낸 메시지에 필요).
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 문서에서는 cmdlet에 대한 모든 매개 변수를 나열하지만 할당된 권한에 포함되지 않은 경우 일부 매개 변수에 액세스할 수 없을 수 있습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Get-MessageTraceV2 -SenderAddress john@contoso.com -StartDate 06/13/2025 -EndDate 06/15/2025
이 예제에서는 2025년 6월 13일부터 2025년 6월 15일 사이에 보낸 john@contoso.com 메시지에 대한 메시지 추적 정보를 검색합니다.
매개 변수
-EndDate
적용 가능: Exchange Online
EndDate 매개 변수는 날짜 범위의 종료 날짜를 지정합니다.
명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2025년 9월 1일을 지정하려면 2025년 9월 1일을 입력합니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜 및 시간을 입력하는 경우 값을 따옴표(")로 묶습니다(예: "2025년 09월 01일 오후 5:00").
매개 변수 속성
| 형식: | System.DateTime |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-FromIP
적용 가능: Exchange Online
FromIP 매개 변수는 원본 IP 주소를 기준으로 결과를 필터링합니다. 들어오는 메시지의 경우 FromIP의 값은 메시지를 보낸 SMTP 메일 서버의 공용 IP 주소입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 2 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | 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")로 묶어야 합니다.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 3 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-MessageTraceId
적용 가능: Exchange Online
MessageTraceId 매개 변수는 메시지의 메시지 추적 ID 값으로 결과를 필터링합니다. 이 GUID 값은 시스템에서 처리하는 모든 메시지에 대해 생성됩니다(예: c20e0f7a-f06b-41df-fe33-08d9da155ac1).
MessageTraceId 값은 다음 cmdlet의 출력에서도 사용할 수 있습니다.
- Get-MailDetailATPReport
- Get-MailDetailDlpPolicyReport
- Get-MailDetailEncryptionReport
- Get-MailDetailTransportRuleReport
- Get-MessageTraceDetailV2
매개 변수 속성
| 형식: | System.Guid |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 4 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-RecipientAddress
적용 가능: Exchange Online
RecipientAddress 매개 변수는 받는 사람의 전자 메일 주소별로 결과를 필터링합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 5 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-ResultSize
적용 가능: Exchange Online
ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 유효한 값은 1에서 5000까지입니다. 기본값은 1,000입니다.
참고: 이 매개 변수는 Get-MessageTrace cmdlet에서 사용할 수 있었던 PageSize 매개 변수를 대체합니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | 0 |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 6 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-SenderAddress
적용 가능: Exchange Online
SenderAddress 매개 변수는 보낸 사람의 전자 메일 주소별로 결과를 필터링합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 7 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-StartDate
적용 가능: Exchange Online
StartDate 매개 변수는 날짜 범위의 시작 날짜를 지정합니다.
명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2025년 9월 1일을 지정하려면 2025년 9월 1일을 입력합니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜 및 시간을 입력하는 경우 값을 따옴표(")로 묶습니다(예: "2025년 09월 01일 오후 5:00").
매개 변수 속성
| 형식: | System.DateTime |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 8 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-StartingRecipientAddress
적용 가능: Exchange Online
StartingRecipientAddress 매개 변수는 EndDate 매개 변수와 함께 사용하여 중복을 방지하면서 부분 결과에 대한 후속 데이터를 쿼리합니다. 부분 결과의 마지막 레코드에 대한 받는 사람 주소 및 수신 시간 값을 가져와서 다음 쿼리에서 각각 StartingRecipientAddress 및 EndDate 매개 변수의 값으로 사용하여 후속 데이터를 쿼리합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 9 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Status
적용 가능: Exchange Online
Status 매개 변수는 메시지의 배달 상태를 기준으로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.
- Delivered: 메시지가 대상에 배달되었습니다.
- 확장됨: 메시지가 메일 그룹에 전달되고 배포의 멤버 자격이 확장되었기 때문에 메시지 배달이 없었습니다.
- 실패: 메시지 배달을 시도했고 실패했습니다.
- FilteredAsSpam: 메시지가 스팸으로 표시되었습니다.
- GettingStatus: 메시지가 상태 업데이트를 기다리고 있습니다.
- None: 메시지가 거부되었거나 다른 받는 사람에게 리디렉션되었기 때문에 메시지에 배달 상태가 없습니다.
- Pending: 메시지 배달이 진행되는 중이거나 지연되었다가 다시 시도되고 있습니다.
- 격리됨: 메시지가 격리되었습니다.
여러 값을 쉼표로 구분할 수 있습니다.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 10 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Subject
적용 가능: Exchange Online
Subject 매개 변수는 메시지 제목별로 결과를 필터링합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
SubjectFilterType 매개 변수를 사용하여 메시지 제목에서 값을 평가하는 방법을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 11 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-SubjectFilterType
적용 가능: Exchange Online
SubjectFilterType 매개 변수는 Subject 매개 변수의 값을 평가하는 방법을 지정합니다. 유효한 값은 다음과 같습니다.
- Contains
- EndsWith
- StartsWith
가능하면 Contains 대신 StartsWith 또는 EndsWith를 사용하는 것이 좋습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 12 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-ToIP
적용 가능: Exchange Online
ToIP 매개 변수는 대상 IP 주소를 기준으로 결과를 필터링합니다. 나가는 메시지의 경우 ToIP의 값은 대상 도메인에 대해 확인된 MX 레코드에 있는 공용 IP 주소입니다. Exchange Online으로 들어오는 메시지의 경우에는 이 값이 비어 있습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 13 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.