Retry-Queue(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 2008-03-11
Retry-Queue cmdlet를 사용하면 허브 전송 서버 또는 Edge 전송 서버 역할이 설치된 컴퓨터의 큐에 대한 연결을 강제로 시도할 수 있습니다.
구문
Retry-Queue -Identity <QueueIdentity> [-Resubmit <$true | $false>]
Retry-Queue -Filter <String> [-Resubmit <$true | $false>] [-Server <ServerIdParameter>]
자세한 정보
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은 원격 도메인, 사서함 서버 또는 영구 큐 이름입니다. |
Resubmit |
선택 |
System.Boolean |
연결을 설정하기 전에 큐 내용이 분류기로 다시 전송될지 여부를 지정하려면 Resubmit 매개 변수를 사용합니다. 새 연결을 시도하려면 Resubmit 매개 변수를 |
Server |
선택 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
재시도할 메시지가 있는 큐가 포함된 RPC(원격 프로시저 호출)를 사용하여 연결할 서버 이름을 지정하려면 Server 매개 변수를 사용합니다. 서버 이름을 호스트 이름이나 정규화된 도메인 이름(FQDN)으로 입력합니다. 이 매개 변수를 사용하지 않으면 로컬 서버가 쿼리됩니다. |
입력 형식
반환 형식
오류
오류 | 설명 |
---|---|
|
|
예외
예외 | 설명 |
---|---|
|
|
예제
다음 예에서는 다음 기준을 충족하는 모든 큐에 연결을 강제로 시도하는 방법을 보여줍니다.
지정된 도메인의 메시지를 포함하는 큐
다시 시도 상태인 큐
명령이 실행되는 서버에 있는 큐
Exchange 관리 셸을 사용하여 큐 뷰어 작업을 수행하는 방법에 대한 자세한 내용은 Exchange 관리 셸을 사용한 큐 관리를 참조하십시오.
Retry-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}