Suspend-Queue
적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
마지막으로 수정된 항목: 2007-06-28
Suspend-Queue cmdlet를 사용하여 Hub 전송 서버 역할이나 Edge 전송 서버 역할이 설치된 컴퓨터에서 큐의 아웃바운드 작업을 중지할 수 있습니다.
구문
Suspend-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Suspend-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
자세한 설명
Suspend-Queue cmdlet는 Active 또는 Retry 상태에 있는 큐의 아웃바운드 작업을 중지시킵니다. SMTP 송신(SMTP-send)을 통해 배달 중인 메시지의 작업은 완료되지만 어떠한 추가 메시지도 큐에서 나가지 않습니다. Identity 매개 변수를 지정하면 해당 ID가 하나의 큐에만 일치할 때 해당 큐를 일시 중단합니다. ID가 둘 이상의 큐와 일치하면 오류가 발생합니다. 따라서 단일 작업에서 둘 이상의 큐를 일시 중단하려면 필터를 사용해야 합니다.
Identity 또는 Filter 매개 변수를 사용해야 합니다. Identity와 Filter 매개 변수는 상호 배타적이므로 동시에 사용할 수 없습니다. Identity 매개 변수의 일부로 서버 이름을 포함시키가나 필터 쿼리에 Server 매개 변수를 사용하면 원격 서버의 큐를 일시 중단할 수 있습니다. 서버를 지정하지 않으면 로컬 서버에 대해서만 명령이 실행됩니다.
Suspend-Queue cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.
- 대상 서버에 대한 Exchange Server 관리자 역할 및 로컬 관리자 그룹
Edge 전송 서버 역할이 설치된 컴퓨터에서 Suspend-Queue cmdlet를 실행하려면 해당 컴퓨터의 로컬 관리자 그룹에 속한 계정을 사용하여 로그온해야 합니다.
사용 권한, 역할 위임 및 Microsoft Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
매개 변수 | 필수 | 종류 | 설명 |
---|---|---|---|
Filter |
필수 |
System.String |
Filter 매개 변수에는 일시 중단할 큐의 속성 값 조건을 지정하는 식이 필요합니다. 이 식에는 비교 연산자와 값이 뒤에 나오는 속성 이름이 포함됩니다. Filter 매개 변수의 유효한 조건으로 사용할 수 있는 큐 속성은 다음과 같습니다.
- and 비교 연산자를 사용하여 여러 조건을 지정할 수 있습니다. 정수가 아닌 속성 값은 인용 부호로 묶어야 합니다. |
Identity |
필수 |
Microsoft.Exchange.Data.QueueViewer.QueueIdentity |
일시 중단할 메시지가 있는 큐의 ID를 지정하려면 Identity 매개 변수를 사용합니다. Server\destination 형식으로 큐 ID를 입력합니다. 여기서 destination은 원격 도메인, 사서함 서버 또는 영구적인 큐 이름입니다. |
Confirm |
선택 |
System.Management.Automation.SwitchParameter |
Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다. |
Server |
선택 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
일시 중단할 메시지를 가지고 있는 큐를 포함하는 RPC(원격 프로시저 호출)를 통해 연결할 서버의 이름을 지정하려면 Server 매개 변수를 사용합니다. 서버 이름은 호스트 이름 또는 FQDN(정규화된 도메인 이름)으로 입력합니다. 이 매개 변수를 사용하지 않으면 로컬 서버가 쿼리됩니다. |
WhatIf |
선택 |
System.Management.Automation.SwitchParameter |
WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다. |
입력 형식
반환 형식
오류
오류 | 설명 |
---|---|
|
|
예외
예외 | 설명 |
---|---|
|
|
예제
다음 예제는 두 가지 Suspend-Queue 명령을 보여 줍니다. 첫 번째 명령은 지정된 도메인으로 배달할 메시지를 가지고 있고 현재 Retry 상태인 모든 큐에서 나가는 작업을 일시 중단합니다.
두 번째 명령은 RPC를 사용하여 원격 서버에 바인딩하고 대기 중인 메시지를 101개 이상 가지고 있는 모든 큐를 일시 중단합니다.
Exchange 관리 셸을 사용하여 큐 뷰어 작업을 수행하는 방법에 대한 자세한 내용은 Exchange 관리 셸을 사용한 큐 관리를 참조하십시오.
Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}
Suspend-Queue -Server ExchSrv1.contoso.com -Filter {MessageCount -gt 100}