Share via

Exchange 관리 셸을 사용하여 큐 관리

  • 아티클

적용 대상: Exchange Server 2013

이전 버전의 Exchange에서와 마찬가지로 Microsoft Exchange Server 2013의 Exchange 관리 셸을 사용하여 큐 및 해당 큐의 메시지에 대한 정보를 보고 큐 및 메시지에 대해 관리 작업을 수행할 수 있습니다. Exchange 2013에서 큐는 사서함 서버 및 Edge 전송 서버에 있습니다. 이 항목에서는 이러한 서버를 전송 서버라고 합니다.

셸을 사용하여 전송 서버에서 큐 및 큐의 메시지를 보고 관리할 경우 관리할 큐나 메시지를 식별하는 방법을 이해하는 것이 중요합니다. 일반적으로 전송 서버에는 배달할 여러 큐 및 메시지가 포함되어 있습니다. 큐 및 메시지 관리 cmdlet에 제공되는 필터링 매개 변수를 사용하여 보거나 관리할 큐나 메시지를 식별할 수 있습니다.

Exchange 도구 상자의 큐 뷰어를 사용하여 큐 및 큐의 메시지를 관리할 수도 있습니다. 단, 큐 뷰어에 비해 큐 및 메시지 보기 cmdlet이 보다 다양한, 필터링 가능한 속성 및 필터 옵션을 지원합니다. 큐 뷰어를 사용하는 방법에 대한 자세한 내용은 큐 뷰어를 참조하십시오.

큐 필터링 매개 변수

다음 표에는 큐 관리 cmdlet에서 사용할 수 있는 필터링 매개 변수가 나와 있습니다.

Cmdlet 필터링 매개 변수 설명
Get-Queue Identity

Filter

포함

제외		 Identity 매개 변수는 Filter 매개 변수와 동일한 명령에 사용할 수 없습니다. Include 및 Exclude 매개 변수는 동일한 명령에서 Filter 매개 변수와 함께 사용할 수 있습니다.
Resume-Queue

Retry-Queue

Suspend-Queue		 Identity

Filter		 Identity 매개 변수나 Filter 매개 변수를 사용해야 하며, 동일한 명령에 이 두 매개 변수를 모두 사용할 수는 없습니다.
Get-QueueDigest 서버

Dag

Site

포리스트

Filter		 Server, Dag, Site 또는 Forest 매개 변수를 사용해야 하며, 동일한 명령에 이러한 매개 변수를 같이 사용할 수는 없습니다. Filter 매개 변수는 다른 필터링 매개 변수와 함께 사용할 수 있습니다.

Server 매개 변수는 모든 큐 관리 cmdlet에서 사용할 수 있습니다. Get-QueueDigest cmdlet에서 Server 매개 변수는 큐에 대한 요약 정보를 보려는 서버 또는 서버를 지정하는 범위 매개 변수입니다. 다른 모든 큐 관리 cmdlet에서는 Server 매개 변수를 사용하여 특정 서버에 연결하고 해당 서버에서 큐 관리 명령을 실행합니다. Filter 매개 변수를 사용하거나 사용하지 않고 Server 매개 변수를 사용할 수 있지만 Identity 매개 변수와 함께 Server 매개 변수를 사용할 수는 없습니다. Server 매개 변수 와 함께 전송 서버의 호스트 이름 또는 FQDN을 사용합니다.

큐 ID

큐 관리 cmdlet의 Identity 매개 변수는 특정 큐를 식별합니다. Identity 매개 변수를 사용하는 경우 큐를 고유하게 식별했기 때문에 다른 큐 필터링 매개 변수를 지정할 수 없습니다. Identity 매개 변수는 기본 구문 <서버>\<큐>를 사용합니다.

<서버 자리 표시자는 Exchange 서버>의 호스트 이름 또는 FQDN(예mailbox01: 또는 mailbox01.contoso.com)입니다. 서버> 한정자를< 생략하면 로컬 서버가 암시됩니다.

<큐> 자리 표시자는 다음 값 중 하나를 허용합니다.

  • 영구 큐 이름: 영구 큐에는 모든 사서함 또는 Edge 전송 서버에서 고유하고 일관된 이름이 있습니다. 영구 큐 이름은 다음 중 하나가 될 수 있습니다.

    • 제출: 이 큐에는 분류자가 처리하기를 기다리는 메시지가 포함됩니다.
    • 연결할 수 없음: 이 큐에는 라우팅할 수 없는 메시지가 포함되어 있습니다. 메시지가 큐에 배치되어야 이 큐가 표시됩니다.
    • 포이즌: 이 큐에는 Exchange 서버에 유해한 것으로 확인된 메시지가 포함되어 있습니다. 메시지가 큐에 배치되어야 이 큐가 표시됩니다.

  • 배달 큐 이름: 배달 큐의 이름은 큐의 NextHopDomain 속성 값입니다. 예를 들어 큐 이름은 송신 커넥터의 주소 공간, Active Directory 사이트의 이름 또는 DAG의 이름이 될 수 있습니다. 자세한 내용은 큐 항목의 "NextHopSolutionKey" 섹션을 참조하십시오.

  • 큐 정수: 배달 큐 및 섀도 큐에는 큐 데이터베이스에 고유한 정수 값이 할당됩니다. 단, Identity 또는 QueueIdentity 속성의 큐에 대한 정수 값을 찾으려면 Get-Queue cmdlet을 실행해야 합니다.

  • 그림자 큐 이름: 섀도 큐는 QueueInteger> 구문을<Shadow\ 사용합니다.

다음 표에는 큐 관리 cmdlet의 Identity 매개 변수와 함께 사용할 수 있는 구문이 요약되어 있습니다. 모든 값 <에서 Server는 서버> 의 호스트 이름 또는 FQDN입니다.

큐 ID 형식

ID 매개 변수 값 설명
<Server>\<PersistentQueueName> 또는 <PersistentQueueName> 지정된 서버나 로컬 서버의 영구 큐입니다.

<PersistentQueueName>은 , Unreachable또는 Poison입니다Submission.
<Server>\<NextHopDomain> 또는 <NextHopDomain> 지정된 서버나 로컬 서버의 배달 큐입니다.

<NextHopDomain> 은 큐에 있는 메시지에 대한 라우팅 대상 또는 배달 그룹입니다. 자세한 내용은 큐 항목의 "NextHopSolutionKey" 섹션을 참조하십시오.
<Server>\<QueueInteger> 또는 <QueueInteger> 지정된 서버나 로컬 서버의 배달 큐입니다.

<QueueInteger>는 Get-Queue cmdlet의 Identity 속성에 표시되는 큐의 고유한 정수 값입니다.
<Server>\Shadow\<QueueInteger> 또는 Shadow\<QueueInteger> 지정된 서버나 로컬 서버의 섀도 큐입니다.
<Server>\* 또는 * 지정된 서버나 로컬 서버의 모든 큐입니다. 이 값은 Get-Queue cmdlet과 함께 사용하는 경우에만 사용할 수 있습니다.

큐 필터링 매개 변수

모든 큐 관리 cmdlet에서 Filter 매개 변수를 사용하여 큐 속성을 바탕으로 보거나 관리할 큐를 지정할 수 있습니다. Filter 매개 변수는 필터 조건을 충족하는 큐로 큐 작업을 제한하는 비교 연산자를 사용하여 식을 만듭니다. 논리 연산자를 -and 사용하여 결과가 일치해야 하는 여러 조건을 지정할 수 있습니다.

Filter 매개 변수와 함께 사용할 수 있는 큐 속성의 전체 목록은 큐를 참조하세요.

Filter 매개 변수와 함께 사용할 수 있는 비교 연산자 목록은 이 항목의 큐 또는 메시지 필터링 시 사용할 비교 연산자 섹션을 참조하세요.

Filter 매개 변수를 사용하여 큐를 보고 관리하는 절차의 예는 큐 관리를 참조하세요.

Include 및 Exclude 매개 변수

Exchange 2013에는 cmdlet에서 사용할 수 있는 포함 및 제외 매개 변수가 Get-Queue 있습니다. 이러한 매개 변수를 개별적으로 또는 함께 사용하거나 Filter 매개 변수와 함께 사용하여 로컬 전송 서버나 지정된 전송 서버에서 큐 결과를 세부적으로 조정할 수 있습니다. 예를 들어, 다음을 수행할 수 있습니다.

  • 결과에서 빈 큐 제외
  • 결과에서 외부 대상에 대한 큐 제외
  • DeliveryType 에 대해 특정 값을 가진 큐를 결과에 포함

Include 및 Exclude 매개 변수는 다음 큐 속성을 사용하여 큐를 필터링합니다.

값 설명 셸 코드 예제
DeliveryType 이 값은 DeliveryType 속성에 따라 큐를 포함하거나 제외합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다. DeliveryType에 대한 유효한 값은 큐 항목의 "NextHopSolutionKey" 섹션에 설명되어 있습니다. 이 예에서는 다음 홉이 스마트 호스트 라우팅에 대해 구성된 로컬 서버의 송신 커넥터인 로컬 서버의 모든 배달 큐를 반환합니다.

Get-Queue -Include SmartHostConnectorDelivery
Empty 이 값은 빈 큐를 포함하거나 제외합니다. 빈 큐에는 MessageCount 속성의 값 0 이 있습니다. 이 예에서는 메시지가 포함된, 로컬 서버의 모든 큐를 반환합니다.

Get-Queue -Exclude Empty
External 이 값은 NextHopCategory 속성에 값 External 이 있는 큐를 포함하거나 제외합니다.

외부 큐 값은 항상 DeliveryType에 대해 다음 값 중 하나로 지정됩니다.
  • DeliveryAgent
  • DnsConnectorDelivery
  • NonSmtpGatewayDelivery
  • SmartHostConnectorDelivery

자세한 내용은 큐 항목의 "NextHopSolutionKey" 섹션을 참조하십시오.

 이 예에서는 로컬 서버의 모든 내부 큐를 반환합니다.

Get-Queue -Exclude External
Internal 이 값은 NextHopCategory 속성에 값 Internal 이 있는 큐를 포함하거나 제외합니다. 자세한 내용은 큐 항목의 "NextHopSolutionKey" 섹션을 참조하십시오. 이 예에서는 로컬 서버의 모든 내부 큐를 반환합니다.

Get-Queue -Include Internal

Filter 매개 변수를 사용하여 Include 및 Exclude 매개 변수의 기능을 복제할 수 있습니다. 예를 들어 명령은 Get-Queue -Exclude Empty 과 동일한 결과를 Get-Queue -Filter "MessageCount -gt 0"생성합니다. 그러나 Include 및 Exclude 매개 변수의 구문은 더 간단하고 기억하기 쉽습니다.

Get-QueueDigest

Exchange 2013에서는 Get-QueueDigest 라는 새 큐 cmdlet이 추가됩니다. 이 cmdlet을 통해 단일 명령을 사용하여 Exchange 조직의 모든 큐나 일부 큐에 대한 정보를 볼 수 있습니다. 특히 Get-QueueDigest cmdlet을 통해 DAG, Active Directory 사이트 또는 전체 Active Directory 포리스트 등 서버의 위치를 바탕으로 큐에 대한 정보를 볼 수 있습니다. 경계 네트워크에서 구독된 Edge 전송 서버의 큐는 결과에 포함되지 않습니다. 또한 Get-QueueDigest 는 Edge 전송 서버에서 제공되기는 하지만 결과는 Edge 전송 서버의 큐로 제한됩니다.

참고

기본적으로 Get-QueueDigest cmdlet은 메시지가 10개 이상 포함된 배달 큐를 표시하고 1~2분 후에 결과를 반환합니다. 이러한 기본값을 변경하는 방법에 대한 지침은 Get-QueueDigest 구성을 참조하세요.

Get-QueueDigest cmdlet에서 사용할 수 있는 필터링 및 정렬 매개 변수가 다음 표에 설명되어 있습니다.

매개 변수 설명
Dag, Server 또는 Site 이 매개 변수는 함께 사용할 수 없으며, cmdlet의 범위를 설정합니다. 이 매개 변수 중 하나나 Forest 스위치를 지정해야 합니다. 일반적으로 서버, DAG 또는 Active Directory 사이트의 이름을 사용하지만 서버, DAG 또는 사이트를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 여러 개의 서버, DAG 또는 사이트를 쉼표로 구분하여 지정할 수 있습니다.
포리스트 이 스위치는 Dag, Server 또는 Site 매개 변수를 사용하지 않을 경우 필요합니다. 이 스위치에는 값을 지정하지 않습니다. 이 스위치를 사용하면 Active Directory 포리스트의 모든 Exchange 2013 사서함 서버에서 큐를 가져옵니다. Forest 스위치를 사용하여 원격 Active Directory 포리스트의 큐를 볼 수는 없습니다.
DetailsLevel 이 매개 변수는 , Normal및 Verbose값을 None허용합니다. 기본값은 Normal입니다. 값을 None사용하면 큐 이름이 결과의 세부 정보 열에서 생략됩니다.
Filter 이 매개 변수를 통해 큐 속성을 바탕으로 큐를 필터링할 수 있습니다. 큐 필터 항목에 설명된 대로 필터링 가능한 큐 속성을 사용할 수 있습니다.
Groupby 이 매개 변수는 큐 결과를 그룹화합니다. 다음 속성 중 하나를 사용하여 결과를 그룹화할 수 있습니다.
  • DeliveryType
  • LastError
  • NextHopCategory
  • NextHopDomain
  • NextHopKey
  • 상태
  • ServerName

기본적으로 결과는 로 그룹화됩니다 NextHopDomain. 이러한 큐 속성에 대한 자세한 내용은 큐 필터를 참조하세요.
ResultSize 이 매개 변수는 큐 결과를 지정한 값으로 제한합니다. 큐는 큐의 메시지 수를 바탕으로 내림차순으로 정렬되며 GroupBy 매개 변수에서 지정한 값별로 그룹화됩니다. 기본값은 1,000입니다. 즉 기본적으로 명령에는 NextHopDomain별로 그룹화된 최상위 1,000개의 큐가 표시되며, 가장 많은 메시지를 포함하는 큐부터 가장 적은 메시지를 포함하는 큐 순서로 정렬됩니다.
시간 제한 매개 변수는 작업 시간이 초과되기 전의 시간(초)을 지정합니다. 기본값은 10초입니다 00:00:10 .

이 예에서는 Mailbox01,Mailbox02 및 Mailbox03이라는 Exchange 2013 사서함 서버의 비어 있지 않은 모든 외부 큐를 반환합니다.

Get-QueueDigest -Server Mailbox01,Mailbox02,Mailbox03 -Include External -Exclude Empty

메시지 필터링 매개 변수

다음 표에는 메시지 관리 cmdlet에서 사용할 수 있는 필터링 매개 변수가 나와 있습니다.

Cmdlet 필터링 매개 변수 설명
Get-Message Identity

Filter

큐		 모든 필터링 매개 변수는 함께 사용할 수 없으며, 동일한 명령에 함께 사용할 수는 있습니다.
Remove-Message

Resume-Message

Suspend-Message		 Identity

Filter		 Identity 매개 변수나 Filter 매개 변수를 사용해야 하며, 동일한 명령에 이 두 매개 변수를 모두 사용할 수는 없습니다.
Export-Message Identity Identity 매개 변수는 필수 사항입니다.

Server 매개 변수는 Export-Message cmdlet을 제외한 모든 메시지 관리 cmdlet에서 사용할 수 있습니다. Server 매개 변수를 사용하여 특정 서버에 연결하고 해당 서버에서 메시지 관리 명령을 실행합니다. Filter 매개 변수를 사용하거나 사용하지 않고 Server 매개 변수를 사용할 수 있지만 Identity 매개 변수와 함께 Server 매개 변수를 사용할 수는 없습니다. Server 매개 변수 와 함께 전송 서버의 호스트 이름 또는 FQDN을 사용합니다.

메시지 ID

메시지 관리 cmdlet의 Identity 매개 변수는 하나 이상의 큐에서 특정 메시지를 식별합니다. Identity 매개 변수를 사용하는 경우 이미 메시지를 고유하게 식별했기 때문에 다른 메시지 필터링 매개 변수를 지정할 수 없습니다. Identity 매개 변수는 기본 구문 <서버>\<큐>\<MessageInteger>를 사용합니다.

<서버 자리 표시자는 Exchange 서버>의 호스트 이름 또는 FQDN(예mailbox01: 또는 mailbox01.contoso.com)입니다. 서버> 한정자를< 생략하면 로컬 서버가 암시됩니다.

큐> 자리 표시자는 이 < 항목의 "큐 ID" 섹션에 설명된 대로 큐의 ID를 허용합니다. 예를 들어 영구 큐 이름, NextHopDomain 값 또는 큐 데이터베이스의 큐에 대한 고유한 정수 값을 사용할 수 있습니다.

<MessageInteger> 자리 표시자는 서버에 큐 데이터베이스를 처음 입력할 때 메시지에 할당된 고유 정수 값을 나타냅니다. 이 메시지가 여러 큐를 필요로 하는, 여러 받는 사람에게 전송되는 경우 큐 데이터베이스의 모든 큐의 모든 메시지 복사본에는 같은 정수 값이 포함됩니다. 단, Get-Message cmdlet을 실행하여 Identity 또는 MessageIdentity 속성의 메시지에 대한 정수 값을 찾아야 합니다.

다음 표에는 메시지 관리 cmdlet의 Identity 매개 변수와 함께 사용할 수 있는 구문이 요약되어 있습니다. 모든 값 <에서 Server는 서버> 의 호스트 이름 또는 FQDN입니다.

메시지 ID 형식

ID 매개 변수 값 설명
<Server>\<Queue>\<MessageInteger> 또는 <Queue>\<MessageInteger> 지정된 서버나 로컬 서버의 특정 큐에 있는 메시지입니다.

<MessageInteger>는 Get-Message cmdlet의 Identity 속성에 표시되는 메시지의 고유한 정수 값입니다.

<큐> 는 다음 값 중 하나를 나타냅니다.
  • 영구 큐 이름: 값 Submission, Unreachable또는 Poison입니다.
  • 배달 큐 이름: 큐의 NextHopDomain 속성 값으로, 큐의 이름입니다. 이 값은 라우팅 대상이나 배달 그룹이 될 수 있습니다. 자세한 내용은 큐 항목의 "NextHopSolutionKey" 섹션을 참조하십시오.
  • 큐 정수: Get-Message 또는 Get-Queue cmdlet의 Identity 속성에 표시되는 배달 큐 또는 섀도 큐의 고유 정수 값입니다.
  • 섀도 큐 ID: 섀도 큐 ID는 구문을 Shadow\<QueueInteger>사용합니다.
<Server>\*\<MessageInteger>또는 또는 *\<MessageInteger><MessageInteger> 지정된 서버나 로컬 서버의 큐 데이터베이스에 있는 모든 큐의 메시지에 대한 모든 복사본입니다.

메시지 필터링 매개 변수

Get-Message, Remove-Message, Resume-Message 및 Suspend-Message cmdlet에서 Filter 매개 변수를 사용하여 메시지 속성을 바탕으로 보거나 관리할 메시지를 지정할 수 있습니다. Filter 매개 변수는 필터 조건을 충족하는 메시지로 메시지 작업을 제한하는 비교 연산자를 사용하여 식을 만듭니다. 논리 연산자를 -and 사용하여 결과가 일치해야 하는 여러 조건을 지정할 수 있습니다.

Filter 매개 변수와 함께 사용할 수 있는 메시지 속성의 전체 목록은 큐를 참조하세요.

Filter 매개 변수와 함께 사용할 수 있는 비교 연산자 목록은 이 항목의 큐 또는 메시지 필터링 시 사용할 비교 연산자 섹션을 참조하세요.

Filter 매개 변수를 사용하여 메시지를 보고 관리하는 절차의 예는 큐 관리를 참조하세요.

큐 매개 변수

Queue 매개 변수는 Get-Message cmdlet에서만 사용됩니다. 이 매개 변수를 사용하여 와일드카드 문자(*)를 사용하여 특정 큐의 모든 메시지 또는 여러 큐의 모든 메시지를 가져올 수 있습니다. Queue 매개 변수를 사용하는 경우 이 항목의 "큐 ID" 섹션에 설명된 대로 큐 ID 형식 <서버>\<큐>를 사용합니다.

큐나 메시지 필터링 시 사용할 비교 연산자

Filter 매개 변수를 사용하여 큐나 메시지 필터 식을 만들 경우 속성 값을 일치시키려면 비교 연산자를 포함해야 합니다. 다음 표에서는 필터 식에서 사용할 수 있는 비교 연산자와 각 연산자의 기능을 보여줍니다. 모든 연산자의 경우 비교되는 값은 대소문자를 구분하지 않습니다.

비교 연산자

연산자 함수 셸 코드 예제
-eq 이 연산자는 결과가 식에서 제공된 속성 값과 일치해야 함을 나타냅니다. 다시 시도 상태인 모든 큐 목록 표시:

Get-Queue -Filter "Status -eq 'Retry'"

다시 시도 상태인 모든 메시지의 목록 표시:

Get-Message -Filter "Status -eq 'Retry'"
-ne 이 연산자는 결과가 식에서 제공된 속성 값과 일치하지 않아야 함을 나타냅니다. 활성 상태가 아닌 모든 큐 목록 표시:

Get-Queue -Filter "Status -ne 'Active'"

활성 상태가 아닌 모든 메시지 목록 표시:

Get-Message -Filter "Status -ne 'Active'"
-gt 이 연산자는 값을 정수 또는 날짜/시간으로 나타내는 속성에 사용됩니다. 필터 결과에는 지정한 속성의 값이 식에서 제공된 값보다 큰 메시지나 큐만 포함됩니다. 현재 1,000개가 넘는 메시지가 있는 큐 목록 표시:

Get-Queue -Filter "MessageCount -gt 1000"

현재 다시 시도 횟수가 4회 이상인 메시지의 목록 표시:

Get-Message -Filter "RetryCount -gt 3"
-ge 이 연산자는 값을 정수 또는 날짜/시간으로 나타내는 속성에 사용됩니다. 필터 결과에는 지정한 속성의 값이 식에서 제공된 값보다 크거나 같은 메시지나 큐만 포함됩니다. 현재 1,000개 이상의 메시지가 있는 큐 목록 표시:

Get-Queue -Filter "MessageCount -ge 1000"

현재 다시 시도 횟수가 3회 이상인 메시지의 목록 표시:

Get-Message -Filter "RetryCount -ge 3"
-lt 이 연산자는 값을 정수 또는 날짜/시간으로 나타내는 속성에 사용됩니다. 필터 결과에는 지정한 속성의 값이 식에서 제공된 값보다 작은 메시지나 큐만 포함됩니다. 현재 1,000개 미만의 메시지가 있는 큐 목록 표시:

Get-Queue -Filter "MessageCount -lt 1000"

다음은 SCL이 6보다 작은 메시지의 목록 표시:

Get-Message -Filter "SCL -lt 6"
-le 이 연산자는 값을 정수 또는 날짜/시간으로 나타내는 속성에 사용됩니다. 필터 결과에는 지정한 속성의 값이 식에서 제공된 값보다 작거나 같은 큐나 메시지만 포함됩니다. 현재 1,000개 이하의 메시지가 있는 큐 목록 표시:

Get-Queue -Filter "MessageCount -le 1000"

다음은 SCL이 6 이하인 메시지의 목록 표시:

Get-Message -Filter "SCL -le 6"
-like 이 연산자는 값을 텍스트 문자열로 나타내는 속성에 사용됩니다. 필터 결과에는 지정한 속성의 값에 식에서 제공된 텍스트 문자열이 있는 메시지나 큐만 포함됩니다. 텍스트 문자열 필드에 적용되는 -like 식에는 * 와일드카드 문자를 사용할 수 있지만 열거 유형의 필드에는 사용할 수 없습니다. Contoso.com으로 끝나는 임의의 SMTP 도메인에 대한 대상이 있는 배달 큐 목록 표시:

Get-Queue -Filter "Identity -like '*contoso.com'"

제목에 "payday loan"이라는 텍스트가 있는 메시지의 목록 표시:

Get-Messages -Filter "Subject -like '*payday loan*'"

-and 비교 연산자를 사용하여 여러 식을 평가하는 필터를 지정할 수 있습니다. 큐나 메시지는 결과에 포함할 필터의 모든 조건을 충족해야 합니다.

이 예에는 Contoso.com으로 끝나는 임의의 SMTP 도메인 이름에 대한 대상이 있고 현재 500개가 넘는 메시지가 포함된 큐 목록이 표시됩니다.

Get-Queue -Filter "Identity -like '*contoso.com*' -and MessageCount -gt 500"

이 예에는 SCL이 5보다 큰, contoso.com 도메인의 모든 전자 메일 주소에서 보내는 메시지 목록이 표시됩니다.

Get-Message -Filter "FromAddress -like '*Contoso.com*' -and SCL -gt 5"

고급 페이징 매개 변수

현재 메일 흐름에 따라 큐 및 메시지에 대한 쿼리는 큰 개체 집합을 반환할 수 있습니다. 고급 페이징 매개 변수를 사용하여 쿼리 결과를 검색하고 표시하는 방법을 제어할 수 있습니다.

셸을 사용하여 큐 및 큐에 있는 메시지를 보는 경우 쿼리는 한 번에 한 페이지의 정보만 검색합니다. 고급 페이징 매개 변수는 결과 집합의 크기를 제어하고 결과를 정렬하는 데도 사용할 수 있습니다. 모든 고급 페이징 매개 변수는 옵션이며, Get-Queue 및 Get-Message cmdlet에서 사용할 수 있는 모든 매개 변수 집합 중 하나와 조합하여 사용할 수 있습니다. 고급 페이징 매개 변수를 지정하지 않으면 쿼리는 ID 오름차순으로 결과를 반환합니다.

정렬 순서가 지정되면 메시지 ID 속성은 기본적으로 항상 포함되며 오름차순으로 정렬됩니다. 이는 기본 순서 지정 관계입니다. 정렬 순서에 포함시킬 수 있는 다른 속성은 고유하지 않기 때문에 메시지 ID 속성이 포함됩니다. 메시지 ID 속성을 정렬 순서에 명시적으로 포함시켜면 결과에서 내림차순으로 정렬된 메시지 ID를 표시하도록 지정할 수 있습니다.

BookmarkIndex 및 BookmarkObject 매개 변수를 사용하여 정렬된 결과 집합의 위치를 표시할 수 있습니다. 다음 결과 페이지 검색에서 책갈피 개체가 더 이상 존재하지 않으면 기본 순서 지정 관계가 책갈피에 가장 가까운 개체로 결과 집합이 시작되도록 합니다. 가장 가까운 개체는 지정된 정렬 순서에 따라 달라집니다.

다음 표에서는 고급 페이징 매개 변수에 대해 설명합니다.

매개 변수 설명
BookmarkIndex 이 매개 변수는 결과 집합에서 표시되는 결과가 시작되는 위치를 지정합니다. 이 매개 변수의 값은 전체 결과 집합에서 1부터 시작하는 인덱스입니다. 값이 0보다 작거나 같은 경우 첫 번째 완전한 결과 페이지가 반환됩니다. 값이 로 설정된 Int.MaxValue경우 결과의 마지막 전체 페이지가 반환됩니다.
BookmarkObject 이 매개 변수는 결과 집합에서 표시되는 결과가 시작되는 개체를 지정합니다. 책갈피 개체를 지정하면 해당 개체는 검색을 시작하는 지점으로 사용됩니다. SearchForward 매개 변수의 값에 따라 해당 개체의 앞이나 뒤에 나오는 행이 검색됩니다. BookmarkObject 매개 변수 및 BookmarkIndex 매개 변수를 단일 쿼리에서 결합할 수 없습니다.
IncludeBookmark 이 매개 변수는 결과 집합에 책갈피 개체를 포함시킬지 여부를 지정합니다. 기본적으로 값은 로 $true 설정되고 책갈피 개체가 포함됩니다. 제한된 결과 크기로 쿼리를 실행한 다음, 해당 결과 집합에 있는 마지막 항목을 다음 쿼리에 대한 책갈피로 지정하는 경우가 있습니다. 이 경우 개체가 두 결과 집합에 모두 포함되지 않도록 IncludeBookmark$false 를 로 설정할 수 있습니다.
ResultSize 이 매개 변수는 페이지당 표시할 결과의 수를 지정합니다. 값을 지정하지 않으면 기본 결과 크기인 1,000개의 개체가 사용됩니다. Exchange에서는 결과 집합을 250,000개로 제한합니다.
ReturnPageInfo 이 매개 변수는 숨겨진 매개 변수입니다. 이 매개 변수는 총 결과 수에 대한 정보와 현재 페이지의 첫 번째 개체의 인덱스를 반환합니다. 기본값은 $false입니다.
SearchForward 이 매개 변수는 결과 집합에서 앞으로 검색할지 또는 뒤로 검색할지 여부를 지정합니다. 이 매개 변수는 결과 집합이 반환되는 순서에 영향을 미치지 않습니다. 책갈피 인덱스 또는 개체를 기준으로 검색 방향을 결정합니다. 책갈피 인덱스 또는 개체가 지정되지 않으면 SearchForward 매개 변수에 따라 결과 집합의 첫 번째 개체부터 검색할지 마지막 개체부터 검색할지 여부가 결정됩니다.

이 매개 변수의 기본값은 입니다 $true. 이 매개 변수를 로 $true 설정하고 책갈피를 지정하면 쿼리는 해당 책갈피에서 앞으로 검색합니다. 이 구성을 사용하는 경우 책갈피 이후 검색 결과가 없으면 쿼리는 결과의 마지막 전체 페이지를 반환합니다.

SearchForward 매개 변수가 로 $false 설정되고 책갈피가 지정된 경우 쿼리는 해당 책갈피에서 뒤로 검색합니다. 이 구성을 사용하는 경우 책갈피 이후 반환되는 검색 결과가 전체 페이지 분량이 되지 않으면 쿼리는 결과의 첫 번째 전체 페이지를 반환합니다.
Sortorder 이 매개 변수는 결과 집합의 정렬 순서를 제어하는 데 사용되는 메시지 속성의 배열을 지정합니다. 정렬 순서 속성은 우선 순위의 내림차순으로 지정됩니다. 각 속성은 쉼표로 구분하며, 오름차순으로 정렬하려면 + 기호를 추가하고 내림차순으로 정렬하려면 - 기호를 추가합니다.

이 매개 변수를 사용하여 정렬 순서를 명시적으로 지정하지 않으면 쿼리와 일치하는 레코드가 표시되며 레코드는 각 개체 유형에 대한 ID 필드에 따라 정렬됩니다. 정렬 순서가 명시적으로 지정되지 않으면 결과는 항상 ID의 오름차순으로 정렬됩니다.

다음 코드 예에서는 쿼리에서 고급 페이징 매개 변수를 사용하는 방법을 보여 줍니다. 이 예에서 명령은 지정된 서버에 연결하여 500개의 개체를 포함하는 결과 집합을 검색합니다. 결과는 정렬된 순서로 표시되는 데, 먼저 보낸 사람 주소의 오름차순으로 정렬된 다음 메시지 크기의 내림차순으로 정렬됩니다.

Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

이어지는 페이지를 보려면 결과 집합에서 검색되는 마지막 개체에 대한 책갈피를 설정하고 추가 쿼리를 실행할 수 있습니다. 이 절차는 셸의 스크립팅 기능을 사용하여 수행해야 합니다.

다음 예에서는 스크립팅을 사용하여 결과의 첫 번째 페이지를 검색하고 책갈피 개체를 설정하고 결과 집합에서 책갈피 개체를 제외한 다음 지정된 서버에서 다음 500개 개체를 검색합니다.

  1. 셸을 열고 다음 명령을 입력하여 결과의 첫 번째 페이지를 검색합니다.

    $Results=Get-message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

  2. 책갈피 개체를 설정하려면 다음 명령을 입력하여 첫 번째 페이지의 마지막 요소를 변수에 저장합니다.

    $temp=$results[$results.length-1]

  3. 지정된 서버에서 다음 500개의 개체를 검색하고 책갈피 개체를 제외하려면 다음 명령을 입력합니다.

    Get-message -Server mailbox01.contoso.com -BookmarkObject:$temp -IncludeBookmark $False -ResultSize 500 -SortOrder +FromAddress,-Size