다음을 통해 공유

Get-Message

모듈:
Exchange PowerShell

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

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

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

구문

Filter 

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

Identity 

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

Queue 

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

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-BookmarkObject

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

매개 변수 속성

형식:ExtensibleMessageInfo
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Filter

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Filter 매개 변수는 OPATH 필터 구문을 사용하여 하나 이상의 메시지를 지정합니다. OPATH 필터에는 메시지 속성 이름 뒤에 비교 연산자 및 값(예: "FromAddress -like '*@contoso.com'")이 포함됩니다. 필터링 가능한 메시지 속성 및 비교 연산자에 대한 자세한 내용은 큐의 메시지 속성 및 Exchange 관리 셸의 큐에서 큐 및 메시지 찾기를 참조하세요.

및 비교 연산자를 사용하여 여러 조건을 지정할 수 있습니다. 정수가 아닌 속성 값은 따옴표로 묶어야 합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Filter
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Identity

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

매개 변수 속성

형식:MessageIdentity
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Identity
Position:1
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-IncludeBookmark

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

매개 변수 속성

형식:Boolean
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-IncludeComponentLatencyInfo

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

이 스위치를 포함하는 경우 반환되는 메시지 개체에는 대기 중인 각 메시지에 대한 로컬 서버 대기 시간에 기여한 각 전송 구성 요소에 대한 대기 시간 측정이 포함됩니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-IncludeRecipientInfo

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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사용합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Queue

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

매개 변수 속성

형식:QueueIdentity
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Queue
Position:Named
필수:False
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ResultSize

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1,000입니다.

매개 변수 속성

형식:Unlimited
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ReturnPageInfo

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

매개 변수 속성

형식:Boolean
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SearchForward

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

매개 변수 속성

형식:Boolean
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Server

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Server 매개 변수는 이 명령을 실행할 Exchange 서버를 지정합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예제:

  • 이름
  • FQDN
  • DN(고유 이름)
  • Exchange 레거시 DN

Exchange 레거시 DN

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

매개 변수 속성

형식:ServerIdParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Filter
Position:Named
필수:False
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-SortOrder

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

매개 변수 속성

형식:

QueueViewerSortOrderEntry[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

Input types

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

출력

Output types

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