Get-Message

참조

모듈:: ExchangePowerShell

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

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

Get-Message cmdlet을 사용하여 사서함 서버 또는 Edge 전송 서버의 큐에 있는 하나 이상의 메시지에 대한 세부 정보를 볼 수 있습니다.

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

Syntax

Get-Message
   [-Filter <String>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleMessageInfo>]
   [-IncludeBookmark <Boolean>]
   [-IncludeComponentLatencyInfo]
   [-IncludeRecipientInfo]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-Server <ServerIdParameter>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]

Get-Message
   [[-Identity] <MessageIdentity>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleMessageInfo>]
   [-IncludeBookmark <Boolean>]
   [-IncludeComponentLatencyInfo]
   [-IncludeRecipientInfo]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]

Get-Message
   [-Queue <QueueIdentity>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleMessageInfo>]
   [-IncludeBookmark <Boolean>]
   [-IncludeComponentLatencyInfo]
   [-IncludeRecipientInfo]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]

Description

Identity 매개 변수 또는 Queue 매개 변수의 일부로 서버 이름을 포함하거나 필터 쿼리가 있는 Server 매개 변수를 포함하여 메시지를 표시할 수 있습니다. Identity 매개 변수, Queue 매개 변수 및 Filter 매개 변수 설정은 함께 사용할 수 없습니다.

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

예제

예 1

Get-Message -Filter "FromAddress -like '*@contoso.com'" | Format-List

이 예에서는 로컬 서버에 대기 중이며 contoso.com 도메인의 보낸 사람으로부터 받은 모든 메시지에 대한 자세한 정보를 표시합니다.

예 2

Get-Message -Filter "FromAddress -like '*@contoso.com' -and SCL -gt 3"

이 예제에서는 로컬 서버에 대기 중인 모든 메시지를 나열하고, contoso.com 도메인의 보낸 사람으로부터 수신되며 SCL 값이 3보다 큰 메시지를 나열합니다.

예 3

Get-Message -Server Server01.contoso.com -SortOrder: +FromAddress,-Size

이 예에서는 Server01 서버에 대기 중인 모든 메시지를 표시합니다. 결과는 먼저 보낸 사람 주소를 기준으로 오름차순으로 정렬된 다음 크기를 기준으로 내림차순으로 다시 정렬됩니다.

매개 변수

-BookmarkIndex

BookmarkIndex 매개 변수는 결과 집합에서 표시되는 결과가 시작되는 위치를 지정합니다. 이 매개 변수의 값은 전체 결과 집합에서 1 기준의 인덱스입니다. BookmarkIndex 매개 변수는 BookmarkObject 매개 변수와 함께 사용할 수 없습니다.

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

-BookmarkObject

BookmarkObject 매개 변수는 결과 집합에서 표시되는 결과가 시작되는 개체를 지정합니다. BookmarkObject 매개 변수는 BookmarkIndex 매개 변수와 함께 사용할 수 없습니다.

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

-Filter

Filter 매개 변수는 OPATH 필터 구문을 사용하여 하나 이상의 메시지를 지정합니다. OPATH 필터에는 메시지 속성 이름 뒤에 비교 연산자와 값(예: "FromAddress -like '*@contoso.com'")이 포함됩니다. 필터링 가능한 메시지 속성 및 비교 연산자에 대한 자세한 내용은 큐의 메시지 속성 및 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

-Identity

Identity 매개 변수는 메시지를 지정합니다. 이 매개 변수의 유효한 입력은 구문 Server\Queue\MessageInteger 또는 Queue\MessageInteger 또는 MessageInteger를 사용합니다(예: Mailbox01\contoso.com\5 또는 10). 메시지 ID에 대한 자세한 내용은 메시지 ID를 참조하세요.

Type:	MessageIdentity
Position:	1
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

-IncludeBookmark

IncludeBookmark 매개 변수는 쿼리 결과가 표시될 때 책갈피 개체를 포함할지 여부를 지정합니다. IncludeBookmark 매개 변수는 BookmarkObject 또는 BookmarkIndex 매개 변수와 함께 사용하는 경우에 유효합니다. IncludeBookmark 매개 변수의 값을 지정하지 않으면 기본값 $true가 사용됩니다.

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

-IncludeComponentLatencyInfo

IncludeComponentLatencyInfo 스위치는 구성 요소 대기 시간에 대한 정보를 메시지 속성에 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 포함하면 대기 중인 각 메시지의 로컬 서버 대기 시간에 영향을 미친 각 전송 구성 요소의 대기 시간 측정이 반환되는 메시지 개체에 포함됩니다.

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

-IncludeRecipientInfo

IncludeRecipientInfo 스위치는 받는 사람 필드에 메시지 받는 사람을 표시할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

IncludeRecipientInfo 스위치를 포함하지 않으면 받는 사람 필드가 비어 있습니다.

명령 결과를 Get-Message -IncludeRecipientInfo 변수에 저장하면 메시지 수신자에 대한 추가 속성을 표시할 수 있습니다. 다음 목록에서는 사용 가능한 받는 사람 속성을 설명합니다.

주소: 받는 사람의 전자 메일 주소입니다.
형식: 외부, 사서함 또는 메일 그룹일 수 있는 받는 사람 유형입니다. Distribution Group은 대상이 확장 서버인 경우에 사용됩니다.
FinalDestination: 메시지를 라우팅하는 데 사용되는 개체의 DN(고유 이름)입니다.
상태: 받는 사람 상태는 완료, 준비 또는 다시 시도일 수 있습니다.
LastError: 마지막 배달 시도 이후의 SMTP 응답 또는 메시지가 연결할 수 없는 큐에 있을 경우 지역화된 오류 메시지입니다.

예를 들어 MessageIdentity 값이 1234인 contoso.com 원격 배달 큐에 메시지의 받는 사람 정보를 $x 변수에 저장하려면 명령을 $x=Get-Message -Identity "contoso.com\\1234" -IncludeRecipientInfo사용합니다.

이제 $x 변수에 저장된 확장 수신자 속성을 표시하려면 명령을 $x.Recipients사용합니다.

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

-Queue

Queue 매개 변수는 표시하려는 메시지를 포함하는 큐의 ID를 지정합니다. 이 매개 변수에 대한 유효한 입력은 구문 <Server>\<Queue> 또는 <Queue>를 사용합니다(예: Mailbox01\contoso.com 또는 연결할 수 없음). 큐 ID에 대한 자세한 내용은 Exchange 관리 셸의 큐에서 큐 및 메시지 찾기의 "큐 ID" 섹션을 참조하세요.

Queue 매개 변수를 사용하는 경우에는 Identity, Filter 또는 Server 매개 변수를 사용할 수 없습니다.

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

-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

-ReturnPageInfo

ReturnPageInfo 매개 변수는 숨겨진 매개 변수입니다. 총 결과 수와 현재 페이지의 첫 번째 개체의 인덱스에 대한 정보를 반환하려면 이 매개 변수를 사용합니다. 기본값은 $false입니다.

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

-SearchForward

SearchForward 매개 변수는 결과 집합에서 앞으로 검색할지 또는 뒤로 검색할지 여부를 지정합니다. 기본값은 $true입니다. 이 값에 따라 결과 집합의 처음부터 앞으로 결과 페이지를 계산하거나 책갈피가 지정된 경우 책갈피부터 앞으로 결과 페이지를 계산합니다.

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

Server 매개 변수와 Filter 매개 변수를 동일한 명령에 사용할 수 있습니다. Server 매개 변수와 Identity 매개 변수를 동일한 명령에 사용할 수는 없습니다.

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

-SortOrder

SortOrder 매개 변수는 결과 집합의 정렬 순서를 제어하는 데 사용되는 메시지 속성의 배열을 지정합니다. 각 속성은 쉼표를 사용하여 구분합니다. 결과를 오름차순으로 표시하려면 속성 이름 앞에 더하기 기호(+)를 추가합니다. 결과를 내림차순으로 표시하려면 속성 이름 앞에 빼기 기호(-)를 추가합니다.

정렬 순서를 지정하지 않으면 MessageIdentity 정수에 따라 결과 집합이 오름차순으로 표시됩니다.

Type:	QueueViewerSortOrderEntry[]
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

입력

Input types

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

출력

Output types

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

다음을 통해 공유