Suspend-Message(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 2007-06-08
Suspend-Message cmdlet를 사용하여 허브 전송 서버 역할이나 Edge 전송 서버 역할이 설치된 컴퓨터의 큐에 있는 특정 메시지를 배달할 수 없도록 설정합니다.
구문
Suspend-Message -Identity <MessageIdentity>
Suspend-Message -Filter <String> [-Server <ServerIdParameter>]
자세한 정보
Suspend-Message cmdlet는 허브 전송 서버나 Edge 전송 서버의 큐에 있는 메시지를 한 개 이상 배달할 수 없도록 설정합니다. 이미 진행 중인 메시는 배달이 일시 중단되지 않습니다. 이 경우 배달이 계속되고 메시지 상태는 PendingSuspend가 됩니다. 배달이 실패하면 메시지가 큐에 다시 들어가고 일시 중단됩니다. 전송 큐나 포이즌 메시지 큐에 있는 메시지는 일시 중단할 수 없습니다.
받는 사람이 여러 명인 메시지의 경우 여러 큐에 위치할 수 있습니다. Identity 매개 변수를 지정할 경우 해당 ID와 일치하는 메시지가 하나뿐이면 단일 큐에서 메시지가 일시 중단되며 ID가 일치하는 메시지가 두 개 이상인 경우에는 오류가 발생합니다. 단일 작업에서 여러 큐에 있는 메시지를 일시 중단하려면 필터를 사용해야 합니다. Identity 매개 변수나 Filter 매개 변수를 사용해야 합니다. 단 이 두 매개 변수를 동시에 사용할 수는 없습니다.
Identity 매개 변수에 서버 이름을 포함하거나 Filter 매개 변수와 Server 매개 변수를 함께 사용하여 원격 서버에서 메시지를 일시 중단할 수 있습니다. 서버를 지정하지 않으면 명령이 로컬 서버에서만 실행됩니다.
Suspend-Message cmdlet를 실행하려면 사용하는 계정이 대상 서버에 대해 Exchange Server 관리자 역할과 로컬 관리자 그룹을 위임받아야 합니다.
Edge 전송 서버 역할이 설치된 컴퓨터에서 Suspend-Message cmdlet를 실행하려면 해당 컴퓨터의 로컬 관리자 그룹에 속한 계정을 사용하여 로그온해야 합니다.
사용 권한, 역할 위임 및 Microsoft Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
매개 변수 | 필수 | 종류 | 설명 |
---|---|---|---|
Filter |
필수 |
System.String |
Filter 매개 변수에는 일시 중단할 메시지의 속성 값 조건을 지정하는 식이 필요합니다. 이 식에는 뒤에 비교 연산자와 값이 나오는 속성 이름이 포함됩니다. 다음 메시지 속성은 Filter 매개 변수에 유효한 조건입니다.
-and 비교 연산자를 사용하여 여러 필터 조건을 지정할 수 있습니다. 하나의 정수로 표시되지 않는 속성 값은 인용 부호로 묶어야 합니다. |
Identity |
필수 |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
Identity 매개 변수를 사용하여 특정 메시지와 선택 서버 및 큐 ID를 나타내는 MessageIdentity 정수를 지정합니다. 이 매개 변수의 구문은 다음과 같습니다.
|
Server |
선택 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
일시 중단할 메시지를 가지고 있는 큐를 포함하는 RPC(원격 프로시저 호출)를 통해 연결할 서버의 이름을 지정하려면 Server 매개 변수를 사용합니다. 호스트 이름이나 FQDN(정규화된 도메인 이름)으로 server 이름을 입력합니다. 이 매개 변수를 사용하지 않으면 로컬 서버가 쿼리됩니다. |
입력 형식
반환 형식
오류
오류 | 설명 |
---|---|
|
|
예외
예외 | 설명 |
---|---|
|
|
예제
다음 예에서는 다음 조건에 맞는 모든 메시지를 배달할 수 없도록 하는 방법을 보여줍니다.
지정한 보낸 사람의 SMTP 주소에서 메시지를 보냅니다.
명령이 실행되는 허브 전송 서버나 Edge 전송 서버에 메시지가 대기 중입니다.
Exchange 관리 셸을 사용하여 큐 뷰어 작업을 수행하는 방법에 대한 자세한 내용은 Exchange 관리 셸을 사용한 큐 관리를 참조하십시오.
Suspend-Message -Filter {FromAddress -eq "sender@contoso.com"}