Suspend-Message
적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
마지막으로 수정된 항목: 2007-06-28
Suspend-Message cmdlet를 사용하여 Hub 전송 서버 역할이나 Edge 전송 서버 역할이 설치된 컴퓨터의 큐에 있는 특정 메시지를 배달할 수 없도록 설정합니다.
구문
Suspend-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Suspend-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
자세한 설명
Suspend-Message cmdlet는 Hub 전송 서버나 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 정수를 지정합니다. 이 매개 변수의 구문은 다음과 같습니다.
|
Confirm |
선택 |
System.Management.Automation.SwitchParameter |
Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다. |
Server |
선택적 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Server 매개 변수를 사용하여 일시 중단할 메시지가 들어 있는 큐가 포함된 원격 프로시저 호출(RPC)을 사용하여 연결할 서버의 이름을 지정합니다. 호스트 이름이나 FQDN(정규화된 도메인 이름)으로 server 이름을 입력합니다. 이 매개 변수를 사용하지 않으면 로컬 서버가 쿼리됩니다. |
WhatIf |
선택 |
System.Management.Automation.SwitchParameter |
WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다. |
입력 형식
반환 형식
오류
오류 | 설명 |
---|---|
|
|
예외
예외 | 설명 |
---|---|
|
|
예제
다음 예에서는 다음 조건에 맞는 모든 메시지를 배달할 수 없도록 하는 방법을 보여 줍니다.
지정한 보낸 사람의 SMTP 주소에서 메시지를 보냅니다.
명령이 실행되는 Hub 전송 서버나 Edge 전송 서버의 큐에서 메시지가 대기합니다.
Exchange 관리 셸을 사용하여 큐 뷰어 작업을 수행하는 방법에 대한 자세한 내용은 Exchange 관리 셸을 사용한 큐 관리를 참조하십시오.
Suspend-Message -Filter {FromAddress -eq "sender@contoso.com"}