Retry-Queue
적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
마지막으로 수정된 항목: 2008-03-11
Retry-Queue cmdlet를 사용하면 Hub 전송 서버 또는 Edge 전송 서버 역할이 설치된 컴퓨터의 큐에 대한 연결을 강제로 시도할 수 있습니다.
구문
Retry-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-WhatIf [<SwitchParameter>]]
Retry-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
자세한 설명
Retry-Queue cmdlet는 다시 시도 상태의 큐에 대한 연결을 강제로 시도합니다. 이 명령은 가능한 경우 다음 홉에 연결을 설정합니다. 연결이 예약되어 있으면 이 명령은 큐에 대한 다음 재시도 시간을 현재 시간으로 재설정하고 연결을 시도합니다. 연결이 설정되지 않으면 새로운 재시도 시간을 설정합니다. Resubmit 매개 변수를 사용하여 큐 내용이 분류기로 다시 전송되도록 할 수 있습니다. 이 명령을 사용하여 연결할 수 없는 큐의 메시지 배달을 재시도할 수는 있지만 Resubmit 매개 변수를 포함시켜야 합니다.
Resubmit 매개 변수를 $false
로 설정하면 Retry-Queue cmdlet가 새 연결을 시도합니다. Resubmit 매개 변수를 $false
로 설정하면 큐의 메시지가 분류기로 다시 전송됩니다.
참고
원격 큐의 상태가 다시 시도일 때만 Resubmit 매개 변수를 $true
로 설정할 수 있습니다.
Identity 매개 변수 또는 Filter 매개 변수를 사용해야 합니다. Identity 매개 변수 및 Filter 매개 변수 집합은 함께 사용할 수 없습니다. Identity 매개 변수에 서버 이름을 포함시키거나 Server 매개 변수와 필터 쿼리를 함께 사용하여 원격 서버의 큐를 재시도할 수 있습니다. 서버를 지정하지 않으면 명령이 로컬 서버에서만 실행됩니다.
Retry-Queue cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.
- 대상 서버에 대한 Exchange Server 관리자 역할 및 로컬 관리자 그룹
Edge 전송 서버 역할이 설치된 컴퓨터에서 Retry-Queue 명령을 실행하려면 해당 컴퓨터의 로컬 관리자 그룹에 속한 계정을 사용하여 로그온해야 합니다.
사용 권한, 역할 위임 및 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 매개 변수에는 값을 지정할 필요가 없습니다. |
Resubmit |
선택 |
System.Boolean |
연결을 설정하기 전에 큐 내용이 분류기로 다시 전송될지 여부를 지정하려면 Resubmit 매개 변수를 사용합니다. 새 연결을 시도하려면 Resubmit 매개 변수를 |
Server |
선택 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
재시도할 메시지가 있는 큐가 포함된 RPC(원격 프로시저 호출)를 사용하여 연결할 서버 이름을 지정하려면 Server 매개 변수를 사용합니다. 호스트 이름 또는 FQDN(정규화된 도메인 이름)으로 서버 이름을 입력합니다. 이 매개 변수를 사용하지 않으면 로컬 서버가 쿼리됩니다. |
WhatIf |
선택 |
System.Management.Automation.SwitchParameter |
WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다. |
입력 형식
반환 형식
오류
오류 | 설명 |
---|---|
|
|
예외
예외 | 설명 |
---|---|
|
|
예제
다음 예에서는 다음 기준을 충족하는 모든 큐에 연결을 강제로 시도하는 방법을 보여 줍니다.
지정된 도메인의 메시지를 포함하는 큐
다시 시도 상태인 큐
명령이 실행되는 서버에 있는 큐
Exchange 관리 셸을 사용하여 큐 뷰어 작업을 수행하는 방법에 대한 자세한 내용은 Exchange 관리 셸을 사용한 큐 관리를 참조하십시오.
Retry-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}