Get-Message

  • 아티클

 

적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

마지막으로 수정된 항목: 2007-08-29

Get-Message cmdlet를 사용하여 허브 전송 서버 역할이나 Edge 전송 서버 역할이 설치된 컴퓨터의 큐에 있는 하나 이상의 메시지에 대한 정보를 볼 수 있습니다.

구문

Get-Message [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]

Get-Message [-Identity <MessageIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Get-Message [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-Queue <QueueIdentity>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

자세한 설명

Get-Message cmdlet는 허브 전송 서버나 Edge 전송 서버에서 기존 큐에 있는 하나 이상의 메시지에 대한 정보를 표시합니다. 매개 변수를 제공하지 않을 경우 이 명령은 로컬 서버의 큐에 있는 모든 메시지를 쿼리한 다음 한 페이지의 결과를 반환합니다. 기본 페이지 크기는 1,000 개체입니다. 서버 이름을 Identity 매개 변수 또는 Queue 매개 변수의 일부로 포함하거나 Server 매개 변수를 필터 쿼리와 함께 포함하여 원격 서버에서 메시지를 표시할 수 있습니다. Identity 매개 변수, Queue 매개 변수 및 Filter 매개 변수 집합은 상호 배타적입니다.

Get-Message cmdlet를 실행하려면 사용하는 계정이 Exchange Server 관리자 역할을 위임받아야 합니다.

Edge 전송 서버 역할이 설치된 컴퓨터에서 Get-Message cmdlet를 실행하려면 해당 컴퓨터의 로컬 관리자 그룹에 속한 계정을 사용하여 로그온해야 합니다.

사용 권한, 역할 위임 및 Microsoft Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.

매개 변수

매개 변수 필수 종류 설명

BookmarkIndex

선택

System.Int32

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

BookmarkObject

선택

Microsoft.Exchange.Data.QueueViewer.MessageInfo

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

Filter

선택

System.String

Filter 매개 변수는 표시하려는 메시지의 속성 값 조건을 지정하는 식이 필요합니다. 이 식에는 뒤에 비교 연산자와 값이 나오는 속성 이름이 포함됩니다. 다음 메시지 속성은 Filter 매개 변수에 유효한 조건입니다.

  • DateReceived   메시지가 수신된 날짜입니다.

  • ExpirationTime   메시지가 만료되는 시간입니다.

  • FromAddress   메시지를 보낸 사람의 SMTP(Simple Mail Transfer Protocol) 주소입니다. 이 값은 메시지 봉투의 MAIL FROM:에서 가져옵니다.

  • Identity   특정 메시지와 선택적인 서버 및 큐 ID를 나타내는 정수입니다.

  • InternetMessageId   Message-ID: 머리글 필드의 값입니다. 이 속성은 GUID 뒤에 보내는 서버의 SMTP 주소를 추가한 형식으로 나타냅니다(예: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com).

  • LastError   메시지에 대해 기록된 마지막 오류의 텍스트 문자열입니다.

  • MessageSourceName   이 메시지를 큐에 전송한 구성 요소의 이름 텍스트 문자열입니다.

  • Queue   메시지가 들어 있는 큐의 ID를 지정합니다. Server\destination 형식으로 큐 ID를 입력합니다. 여기서 destination은 원격 도메인, 사서함 서버 또는 영구 큐 이름입니다.

  • RetryCount   목적지로 메시지 전송을 시도한 횟수입니다.

  • SCL   SCL 속성은 메시지의 스팸 지수를 지정합니다. 유효한 SCL 항목은 0 - 9 사이의 정수입니다. SCL 속성 값이 비어 있다는 것은 메시지가 콘텐츠 필터 에이전트에 의해 처리되지 않았음을 의미합니다.

  • Size   메시지의 크기입니다.

  • SourceIP   Exchange 조직에 메시지를 전송한 외부 서버의 IP 주소입니다.

  • Status   현재의 메시지 상태입니다. 메시지 상태 옵션에는 Active, Retry, Suspended, PendingSuspend 또는 PendingRemove가 있습니다.

  • Subject   전자 메일 제목을 나타내는 텍스트 문자열입니다. 이 값은 Subject: 머리글 필드에서 가져옵니다.

- and 비교 연산자를 사용하여 여러 필터 조건을 지정할 수 있습니다. 하나의 정수로 표시되지 않는 속성 값은 인용 부호로 묶어야 합니다.

Identity

선택

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

MessageIdentity 정수를 지정하려면 Identity 매개 변수를 사용합니다. 이 매개 변수는 특정 메시지와 선택적인 서버 및 큐 ID를 나타내는 정수입니다. 이 매개 변수의 구문은 다음과 같이 지정할 수 있습니다.

  • Server\QueueIdentity\MessageIdentity

  • QueueIdentity\MessageIdentity

  • Server\*\MessageIdentity

  • MessageIdentity

IncludeBookmark

선택

System.Boolean

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

IncludeRecipientInfo

선택

System.Management.Automation.SwitchParameter

받는 사람 필드에 메시지 받는 사람을 표시하려면 IncludeRecipientInfo 매개 변수를 사용합니다. IncludeRecipientInfo 매개 변수를 포함하지 않을 경우 받는 사람 필드는 비어 있습니다.

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

  • 주소   받는 사람의 전자 메일 주소입니다.

  • 유형   받는 사람 유형은 외부, 사서함 또는 DL이 될 수 있습니다. DL은 대상이 확장 서버일 경우 사용됩니다.

  • FinalDestination   메시지를 라우팅하는 데 사용되는 개체의 DN(고유 이름)입니다. 개체는 커넥터, 사서함 서버 또는 확장 서버일 수 있습니다.

  • 상태   받는 사람 상태는 완료, 준비 또는 다시 시도일 수 있습니다.

  • LastError   마지막 배달 시도 이후의 SMTP 응답 또는 메시지가 연결할 수 없는 큐에 있을 경우 지역화된 오류 메시지입니다.

예를 들어, MessageIdentity 값이 1234인 "Contoso.com" 원격 배달 큐의 메시지 받는 사람 정보를 $x라는 변수에 저장하려면 다음 명령을 사용합니다.

$x=Get-Message -Identity "Contoso.com\1234" -IncludeRecipientInfo

이제 $x 변수에 저장된 확장된 받는 사람 속성을 표시하려면 다음 명령을 사용합니다.

$x.Recipients

Queue

선택

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

표시하려는 메시지가 포함된 큐의 ID를 지정하려면 Queue 매개 변수를 사용합니다. Server\destination 형식으로 큐 ID를 입력합니다. 여기서 destination은 원격 도메인, 사서함 서버 또는 영구 큐 이름입니다.

ResultSize

선택

Microsoft.Exchange.Data.Unlimited

결과 집합에 표시할 총 항목 수를 지정하려면 ResultSize 매개 변수를 사용합니다. 기본 ResultSize 매개 변수 값은 1,000으로 설정됩니다. ResultSize에서 지원하는 결과 수는 제한이 없지만 Microsoft Exchange에서는 결과 집합을 250,000으로 제한합니다.

ReturnPageInfo

선택

System.Boolean

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

SearchForward

선택

System.Boolean

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

Server

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

표시하려는 메시지가 포함된 큐가 있는 원격 프로시저 호출(RPC)을 사용하여 연결할 서버의 이름을 지정하려면 Server 매개 변수를 사용합니다. Server 매개 변수를 호스트 이름이나 정규화된 도메인 이름(FQDN)으로 입력합니다. 이 매개 변수를 사용하지 않으면 로컬 서버가 쿼리됩니다.

SortOrder

선택

Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]

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

예제

다음 예는 Get-Message 명령을 사용하여 메시지를 쿼리하는 방법을 보여줍니다. 첫 번째 예는 로컬 서버의 큐에 있고 지정된 도메인의 보낸 사람으로부터 받은 메시지를 모두 표시하는 방법을 보여줍니다. 이 명령은 Format-List 명령으로 파이프되어 결과를 상세한 목록으로 표현합니다.

두 번째 예는 로컬 서버의 큐에 있는 메시지와 지정된 도메인의 보낸 사람으로부터 받은 메시지와 SCL 값이 3 이상인 메시지를 모두 표시하는 방법을 보여줍니다.

세 번째 예는 원격 서버에 연결하는 방법과 원격 서버의 큐에 있는 모든 메시지를 지정된 정렬 순서로 표시하는 방법을 보여줍니다. 결과는 먼저 보낸 사람 주소를 기준으로 오름차순으로 정렬된 다음 크기를 기준으로 내림차순으로 다시 정렬됩니다.

파이프라이닝에 대한 자세한 내용은 파이프라이닝을 참조하십시오.

명령 출력을 사용하는 방법에 대한 자세한 내용은 명령 출력 작업을 참조하십시오.

Exchange 관리 셸을 사용하여 큐 뷰어 작업을 수행하는 방법에 대한 자세한 내용은 Exchange 관리 셸을 사용한 큐 관리를 참조하십시오.

Get-Message -Filter {FromAddress -like "*@contoso.com"} | format-list
Get-Message -Filter {FromAddress -like "*@contoso.com" -and SCL -gt 3}
Get-Message -Server exchange.contoso.com -SortOrder: +FromAddress,-Size