Remove-Message

  • 아티클

 

적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

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

Remove-Message cmdlet를 사용하여 Hub 전송 서버 역할 또는 Edge 전송 서버 역할이 설치되어 있는 컴퓨터의 큐에서 메시지를 삭제합니다.

구문

Remove-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

Remove-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

자세한 설명

Remove-Message cmdlet는 Hub 전송 서버 또는 Edge 전송 서버의 큐에서 메시지를 하나 이상 삭제합니다. 여러 받는 사람에게 전송되는 메시지는 여러 큐에 있을 수 있습니다. Identity 매개 변수를 지정하는 경우 해당 ID가 하나의 메시지와만 일치하면 이 메시지가 단일 큐에서 제거됩니다. 그러나 둘 이상의 메시지와 일치하면 오류가 발생합니다. 한 번의 작업으로 둘 이상의 큐에서 메시지를 제거하려면 필터를 사용해야 합니다. 현재 배달되고 있는 메시지를 제거하려고 하면 메시지 상태가 PendingDelete로 변경됩니다. 메시지 배달은 중단되지 않지만 배달이 실패하고 메시지가 큐에 다시 들어가면 메시지가 제거됩니다.

반드시 Identity 매개 변수나 Filter 매개 변수를 사용해야 합니다. 이러한 두 매개 변수 집합은 함께 사용할 수 없습니다.

Remove-Message cmdlet를 실행하려면 사용하는 계정이 대상 서버에 대한 Exchange Server 관리자 역할과 로컬 관리자 그룹을 위임받아야 합니다.

Edge 전송 서버 역할이 설치된 컴퓨터에서 Remove-Message cmdlet를 실행하려면 해당 컴퓨터의 로컬 관리자 그룹에 속한 계정을 사용하여 로그온해야 합니다.

사용 권한, 역할 위임 및 Microsoft Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.

매개 변수

매개 변수 필수 종류 설명

Filter

필수

System.String

Filter 매개 변수는 제거할 메시지에 대한 속성 값 조건을 지정하는 식을 사용해야 합니다. 이 식에는 속성 이름이 포함되고 그 뒤에 비교 연산자와 값이 나옵니다. 다음 메시지 속성은 Filter 매개 변수에 사용할 수 있는 조건입니다.

  • DateReceived   메시지를 받은 날짜입니다.

  • ExpirationTime   메시지가 만료되는 시간입니다.

  • FromAddress   메시지 보낸 사람의 SMTP(Simple Mail Transfer Protocol) 주소입니다. 이 값은 메시지 봉투의 MAIL FROM:에서 가져옵니다.

  • Identity   특정 메시지를 나타내고 필요에 따라 서버와 큐 ID를 나타내는 정수입니다.

  • InternetMessageId   Message-ID: 헤더 필드의 값입니다. 이 속성은 GUID 뒤에 보내는 서버의 SMTP 주소를 추가한 형식으로 나타납니다(예: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com).

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

  • MessageSourceName   이 메시지를 큐에 전송한 구성 요소 이름의 텍스트 문자열입니다.

  • Queue   메시지가 있는 큐의 ID를 지정합니다. Server\destination 형식으로 큐 ID를 입력하십시오. 여기서 destination은 원격 도메인, 사서함 서버 또는 지속적인 큐 이름입니다.

  • RetryCount   대상으로 메시지를 배달하려고 시도한 횟수입니다.

  • SCL   SCL 속성은 메시지의 SCL(스팸 지수)을 지정합니다. 유효한 SCL 항목은 0 - 9 사이의 정수입니다. SCL 속성 값이 비어 있다는 것은 메시지가 콘텐츠 필터 에이전트에 의해 처리되지 않았음을 의미합니다.

  • Size   메시지 크기입니다.

  • SourceIP   Exchange 조직에 메시지를 전송한 외부 서버의 IP 주소입니다.

  • Status   현재 메시지 상태입니다. 메시지 상태 옵션으로는 Active, Retry, Suspended, PendingSuspend 및 PendingRemove가 있습니다.

  • Subject   전자 메일 제목을 나타내는 텍스트 문자열입니다. 이 값은 Subject: 헤더 필드에서 가져옵니다.

-and 비교 연산자를 사용하여 다양한 필터 조건을 지정할 수 있습니다. 하나의 정수로 표시되지 않는 속성 값은 따옴표로 묶어야 합니다.

Identity

필수

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

Identity 매개 변수를 사용하여 특정 메시지를 나타내고 필요에 따라 서버와 큐 ID를 나타내는 MessageIdentity 정수를 지정합니다. 이 매개 변수에 대한 구문은 다음과 같습니다.

  • Server\QueueIdentity\MessageIdentity

  • QueueIdentity\MessageIdentity

  • Server\*\MessageIdentity

  • MessageIdentity

Confirm

선택

System.Management.Automation.SwitchParameter

Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다.

Server

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 매개 변수를 사용하여 연결할 서버의 이름을 지정합니다. 이때 연결 방법은 제거할 메시지가 있는 큐를 포함하는 원격 프로시저 호출(RPC)을 사용하는 것입니다. 호스트 이름 또는 FQDN(정규화된 도메인 이름)으로 Server 매개 변수를 입력하십시오. 이 매개 변수를 사용하지 않으면 로컬 서버를 쿼리합니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다.

WithNDR

선택

System.Boolean

WithNDR 매개 변수를 사용하여 NDR(배달 실패 보고서)이 메시지의 보낸 사람에게 반환되는지 여부를 지정합니다. 이 매개 변수의 기본 동작은 $true로 설정됩니다. 이 매개 변수는 Identity 매개 변수 집합과 Filter 매개 변수 집합 모두에서 사용할 수 있습니다.

입력 형식

반환 형식

오류

오류 설명

예외

예외 설명

예제

다음 예제에서는 다음 조건에 맞는 모든 메시지를 제거하는 방법을 보여 줍니다.

  • 지정된 보낸 사람의 SMTP 주소에서 보내는 메시지

  • 명령이 실행되는 Hub 전송 서버 또는 Edge 전송 서버에서 대기한 메시지

다음 예제에서는 NDR을 보내지 않는 방법을 보여 줍니다.

Exchange 관리 셸을 사용하여 큐 뷰어 작업을 수행하는 방법에 대한 자세한 내용은 Exchange 관리 셸을 사용한 큐 관리를 참조하십시오.

Remove-Message -Filter {FromAddress -eq "sender@contoso.com"} -withNDR $false