Get-Message
이 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은 데이터를 반환하지 않습니다.