Search-MessageTrackingReport

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

이 cmdlet은 온-프레미스 Exchange에서만 작동합니다.

Search-MessageTrackingReport cmdlet을 사용하면 제공된 검색 조건에 따라 고유한 메시지 추적 보고서를 찾을 수 있습니다. 그런 다음 이 메시지 추적 보고서 ID를 Get-MessageTrackingReport cmdlet에 전달하여 전체 메시지 추적 정보를 가져올 수 있습니다. 자세한 내용은 Get-MessageTrackingReport를 참조하십시오. 메시지 추적 보고서 cmdlet은 배달 보고서 기능에 사용됩니다.

Exchange Online 배달 보고서는 메시지 추적(Get-MessageTrace 및 Get-MessageTraceDetail cmdlet)으로 대체되었습니다.

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

Syntax

Search-MessageTrackingReport
      [-Identity] <MailboxIdParameter>
      -Sender <SmtpAddress>
      [-BypassDelegateChecking]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotResolve]
      [-MessageEntryId <String>]
      [-MessageId <String>]
      [-ResultSize <Unlimited>]
      [-Subject <String>]
      [-TraceLevel <TraceLevel>]
      [-WhatIf]
      [<CommonParameters>]

Search-MessageTrackingReport
      [-Identity] <MailboxIdParameter>
      [-Recipients <SmtpAddress[]>]
      [-BypassDelegateChecking]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotResolve]
      [-MessageEntryId <String>]
      [-MessageId <String>]
      [-ResultSize <Unlimited>]
      [-Subject <String>]
      [-TraceLevel <TraceLevel>]
      [-WhatIf]
      [<CommonParameters>]

Description

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

예제

예 1

Search-MessageTrackingReport -Identity "David Jones" -Recipients "wendy@contoso.com"

이 예제에서는 메시지 추적 보고서에서 한 사용자에서 다른 사용자로 보낸 메시지를 검색합니다. 다음은 데이비드 존스가 웬디 리처드슨에게 보낸 메시지에 대한 메시지 추적 보고서를 반환하는 예제입니다.

예 2

Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -BypassDelegateChecking -DoNotResolve

이 예제에서는 메시지 추적 보고서를 검색하여 다음 시나리오를 검색합니다. 사용자 Cigdem Akin은 도착하지 않은 전자 메일 메시지를 joe@contoso.com 예상했습니다. 그녀는 Cigdem을 대신하여 메시지 추적 보고서를 생성해야 하는 지원 센터에 연락하여 표시 이름을 볼 필요가 없습니다.

이 예에서는 기술 지원팀이 문제 해결을 위해 분석할 수 있는 메시지 추적 보고서가 반환됩니다.

매개 변수

-BypassDelegateChecking

BypassDelegateChecking 스위치를 사용하면 기술 지원팀 직원과 관리자가 임의 사용자에 대한 메시지를 추적할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

기본적으로 사용자는 자신의 사서함에서 보내거나 받는 메시지만 추적할 수 있습니다.

Type:	SwitchParameter
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, Exchange Online

-Confirm

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

Type:	SwitchParameter
Aliases:	cf
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, Exchange Online

-DomainController

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

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

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

-DoNotResolve

DoNotResolve 스위치는 이름을 표시하는 전자 메일 주소의 확인을 방지할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하면 성능이 향상되지만 표시 이름이 없으므로 결과를 해석하기가 더 어려워질 수 있습니다.

Type:	SwitchParameter
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, Exchange Online

-Identity

Identity 매개 변수는 검색 범위를 지정된 사서함으로 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

이름
별칭
DN(고유 이름)
DN(고유 이름)
Domain\Username
전자 메일 주소
GUID
LegacyExchangeDN
SamAccountName
사용자 ID 또는 UPN(사용자 계정 이름)

Sender 매개 변수 없이 이 매개 변수를 사용하는 경우 지정된 사서함은 검색에 사용되는 메시지 보낸 사람입니다. Recipients 매개 변수를 사용하여 받는 사람을 지정할 수 있습니다.

Sender 매개 변수와 함께 이 매개 변수를 사용하는 경우 지정된 사서함은 검색에 사용되는 메시지 수신자입니다.

Type:	MailboxIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MessageEntryId

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

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, Exchange Online

-MessageId

MessageId 매개 변수는 메시지의 Message-ID 헤더 필드별로 결과를 필터링합니다. 이 값은 클라이언트 ID로도 알려져 있습니다. Message-ID의 형식은 메시지를 보낸 메시징 서버에 따라 달라집니다. 값은 각 메시지에 대해 고유해야 합니다. 그러나 모든 메시징 서버에서 Message-ID 값을 동일한 방식으로 생성하지는 않습니다. 전체 메시지 ID 문자열(꺾쇠 괄호를 포함할 수 있음)을 포함하고 값을 따옴표(예: "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, Exchange Online

-Recipients

Recipients 매개 변수는 지정된 받는 사람의 이메일 주소로 결과를 필터링합니다. 전자 메일 주소가 여러 개인 경우 각 주소를 쉼표로 구분하여 지정할 수 있습니다.

Sender 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

Type:	SmtpAddress[]
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, Exchange Online

-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, Exchange Online

-Sender

Sender 매개 변수는 Identity 매개 변수로 지정된 사서함으로 전송되는 메시지에 대한 메시지 보낸 사람의 전자 메일 주소를 지정합니다.

Identity 매개 변수와 함께 이 매개 변수를 사용해야 합니다.

Type:	SmtpAddress
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Subject

Subject 매개 변수는 지정된 Subject 필드 값이 있는 메시지를 검색합니다. 값에 공백이 포함된 경우 값을 따옴표로 묶습니다.

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, Exchange Online

-TraceLevel

TraceLevel 매개 변수는 결과에 포함할 세부 정보를 지정합니다. 유효한 값은 다음과 같습니다.

낮음: 액세스한 서버, 타이밍, 메시지 추적 검색 결과 수 및 오류 정보를 포함하여 최소 추가 데이터가 반환됩니다.
중간: 낮음 설정에 대해 반환된 모든 데이터 외에도 실제 메시지 추적 검색 결과도 반환됩니다.
높음: 전체 진단 데이터가 반환됩니다.

메시지 추적 문제를 해결하기 위해 이 매개 변수만 사용해야 합니다.

Type:	TraceLevel
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

-WhatIf

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:	SwitchParameter
Aliases:	wi
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, Exchange Online

입력

Input types

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

출력

Output types

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