Share via

Suspend-Queue(RTM)

  • 아티클

 

적용 대상: Exchange Server 2007

마지막으로 수정된 항목: 2007-06-08

Suspend-Queue cmdlet를 사용하여 허브 전송 서버 역할이나 Edge 전송 서버 역할이 설치된 컴퓨터에서 큐의 아웃바운드 작업을 중지할 수 있습니다.

구문

Suspend-Queue -Identity <QueueIdentity>

Suspend-Queue -Filter <String> [-Server <ServerIdParameter>]

자세한 정보

Suspend-Queue cmdlet는 Active 또는 Retry 상태에 있는 큐의 아웃바운드 작업을 중지시킵니다. SMTP 송신을 통해 배달 중인 메시지는 작업을 마치게 됩니다. 어떠한 추가 메시지도 큐에서 나가지 않습니다. 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 매개 변수에 유효한 조건입니다.

  • DeliveryType   전송에서 정의된 이 큐의 배달 유형입니다. 배달 유형은 다음 값 중 하나일 수 있습니다.

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • 정의되지 않음

    • 연결할 수 없음

  • Identity   Server\destination 형식으로 큐 ID를 입력합니다. 여기서 destination은 원격 도메인, 사서함 서버 또는 영구 큐 이름입니다.

  • LastError   큐에 대해 기록된 마지막 오류의 텍스트 문자열입니다.

  • LastRetryTime   이 큐에 대해 마지막으로 연결을 시도한 시간입니다.

  • MessageCount   큐에 있는 항목 수입니다.

  • NextHopConnector   큐를 만드는 데 사용된 커넥터의 GUID입니다.

  • NextHopDomain   큐의 다음 홉 도메인이며 원격 SMTP(Simple Mail Transfer Protocol) 도메인, 서버 이름, Active Directory 사이트의 이름 또는 메시지 데이터베이스(MDB) 식별자로 지정됩니다.

  • NextRetryTime   이 큐에 대해 다시 연결을 시도하는 시간입니다.

  • Status   큐의 상태입니다. 큐 상태 옵션에는 Active, Ready, Retry 또는 Suspended가 있습니다.

- and 비교 연산자를 사용하여 여러 조건을 지정할 수 있습니다. 정수로 표시되지 않는 속성 값은 인용 부호로 묶어야 합니다.

Identity

필수

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

일시 중단할 메시지가 있는 큐의 ID를 지정하려면 Identity 매개 변수를 사용합니다. Server\destination 형식으로 큐 ID를 입력합니다. 여기서 destination은 원격 도메인, 사서함 서버 또는 영구 큐 이름입니다.

Server

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

일시 중단할 메시지를 가지고 있는 큐를 포함하는 RPC(원격 프로시저 호출)를 통해 연결할 서버의 이름을 지정하려면 Server 매개 변수를 사용합니다. 서버 이름을 호스트 이름이나 정규화된 도메인 이름(FQDN)으로 입력합니다. 이 매개 변수를 사용하지 않으면 로컬 서버가 쿼리됩니다.

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

 

 

예제

다음 예제는 두 가지 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}