.png)
Suspend-Queue
적용 대상: Exchange Server 2013
마지막으로 수정된 항목: 2012-06-11
Suspend-Queue cmdlet을 사용하면 사서함 서버 또는 Edge 전송 서버에서 큐에 대한 처리를 중지할 수 있습니다.
Suspend-Queue -Identity <QueueIdentity> <COMMON PARAMETERS>
Suspend-Queue -Filter <String> [-Server <ServerIdParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
이 예에서는 contoso.com 도메인에 배달할 메시지가 포함되어 있고 현재 상태가 Retry인 모든 큐의 처리를 일시 중단합니다.
Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "Retry"}
이 예에서는 Server1.contoso.com 서버에서 큐에 있는 메시지 수가 100개를 초과하는 모든 큐의 처리를 일시 중단합니다.
Suspend-Queue -Server Server1.contoso.com -Filter {MessageCount -gt 100}
Suspend-Queue cmdlet은 Active 또는 Retry 상태에 있는 큐의 처리를 중지합니다. 처리 중인 메시지는 배달되지만 추가 메시지는 큐에서 나가지 않습니다. Identity 매개 변수를 사용하면 ID가 큐 하나와 일치하는 경우에만 큐가 일시 중단됩니다. ID가 일치하는 큐가 두 개 이상이면 오류가 발생합니다. 하나의 작업으로 둘 이상의 큐를 일시 중단하려면 Filter 매개 변수를 사용해야 합니다.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당 받아야 합니다. 이 cmdlet의 모든 매개 변수가 이 항목에 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 필요한 사용 권한을 확인하려면 다음을 참조하십시오 메일 흐름 사용 권한의 "큐" 항목
| 매개 변수 | 필수 | 종류 | 설명 |
|---|---|---|---|
| Filter | 필수 | System.String | Filter 매개 변수에는 일시 중단할 큐의 속성 값 조건을 지정하는 식이 필요합니다. 이 식에는 속성 이름, 비교 연산자 및 값이 차례로 포함됩니다. Filter 매개 변수에 사용할 수 있는 기준으로는 다음과 같은 큐 속성이 있습니다. DeliveryType: 전송에서 정의된 이 큐의 배달 유형입니다. Identity: Server\destination 형식의 큐 ID입니다. 여기서 destination은 배달 그룹 또는 라우팅 대상입니다. LastError: 큐에 대해 기록된 마지막 오류의 텍스트 문자열입니다. LastRetryTime: 이 큐에 대해 마지막으로 연결을 시도한 시간입니다. MessageCount: 큐의 항목 수입니다. NextHopConnector: 다음 홉 배달 그룹의 GUID입니다. NextHopDomain: 배달 그룹 또는 라우팅 대상으로 지정된 큐의 다음 홉 도메인입니다. NextRetryTime: 다음 번에 이 큐에 대해 연결을 시도할 시간입니다. Status: 큐의 상태입니다. 큐 상태 옵션은 and 비교 연산자를 사용하여 여러 기준을 지정할 수 있습니다. 하나의 정수로 표시되지 않는 속성 값은 큰따옴표(")로 묶어야 합니다. |
| Identity | 필수 | Microsoft.Exchange.Data.QueueViewer.QueueIdentity | Identity 매개 변수는 일시 중단할 메시지를 포함하는 큐의 ID를 지정합니다. Server\destination 형식으로 큐 ID를 입력합니다. 여기서 destination은 배달 그룹 또는 라우팅 대상입니다. |
| Confirm | 선택 | System.Management.Automation.SwitchParameter | Confirm 스위치를 사용하면 이 cmdlet을 실행할 때 기본적으로 나타나는 확인 메시지를 표시하지 않을 수 있습니다. 확인 메시지를 표시하지 않으려면 |
| Server | 선택 | Microsoft.Exchange.Configuration.Tasks.ServerIdParameter | Server 매개 변수는 이 명령을 실행하려는 Exchange 서버를 지정합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.
Server 매개 변수를 사용하지 않으면 로컬 서버에서 명령이 실행됩니다. |
| WhatIf | 선택 | System.Management.Automation.SwitchParameter | WhatIf 스위치는 명령이 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 스위치를 사용하면 사용자는 변경 사항을 적용하지 않고도 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 스위치에는 값을 지정할 필요가 없습니다. |
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입력 및 출력 형식을 참조하십시오. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입력 및 출력 형식을 참조하십시오. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.
참여하시겠습니까?
