다중값 속성 수정

 

적용 대상: Exchange Server 2010 SP2, Exchange Server 2010 SP3

마지막으로 수정된 항목: 2015-03-09

이 항목에서는 Exchange 관리 셸을 사용하여 개체의 다중값 속성에 대해 값을 추가하거나 제거하는 방법에 대해 설명합니다.

다중값 속성 개요

다중값 속성은 값이 둘 이상인 속성입니다. 예를 들어, RecipientFilterConfig 개체의 BlockedRecipients 속성은 다음 예와 같이 여러 개의 받는 사람 주소를 수락할 수 있습니다.

  • john@contoso.com

  • kim@northwindtraders.com

  • david@adatum.com

BlockedRecipients 속성은 둘 이상의 값을 수락할 수 있으므로 다중값 속성입니다.

개체에 대한 자세한 내용은 구조적 데이터를 참조하십시오.

다중값 속성 수정과 단일 값만 수락하는 속성 수정의 차이

다중값 속성을 수정하는 방법은 단일 값만 수락하는 속성을 수정하는 방법과 약간 다릅니다. 단일 값만 수락하는 속성을 수정할 때는 다음 명령과 같이 속성에 값을 직접 할당할 수 있습니다.

Set-TransportConfig -MaxSendSize 12MB

이 명령을 사용하여 MaxSendSize 속성에 새 값을 제공하면 저장되어 있던 값을 덮어쓰게 됩니다. 이는 하나의 값만 수락하는 속성에는 문제가 되지 않지만 다중값 속성일 경우에는 문제가 발생합니다. 예를 들어 RecipientFilterConfig 개체의 BlockedRecipients 속성이 이전 섹션에 나열된 3개의 값을 갖도록 구성되었다고 가정합니다. Get-RecipientFilterConfig | Format-List BlockedRecipients 명령을 실행하면 다음이 표시됩니다.

BlockedRecipients : {david@adatum.com, kim@northwindtraders.com, john@contoso.com}

이제 SMTP 주소를 차단된 받는 사람 목록에 추가하는 요청을 받게 되는 경우를 고려해 보겠습니다. 새 SMTP 주소를 추가하기 위해 다음 명령을 실행합니다.

Set-RecipientFilterConfig -BlockedRecipients chris@contoso.com

Get-RecipientFilterConfig | Format-List BlockedRecipients 명령을 다시 실행하면 다음이 표시됩니다.

BlockedRecipients : {chris@contoso.com}

이 내용은 원하는 결과가 아닙니다. 즉, 새 SMTP 주소를 기존의 차단된 받는 사람 목록에 추가하려고 했지만 새 SMTP 주소가 기존의 차단된 받는 사람 목록을 덮어쓰게 됐습니다. 이 의도하지 않은 결과는 다중값 속성을 수정하는 방법과 단일 값만 수락하는 속성을 수정하는 방법 간 차이점의 전형적인 예가 됩니다. 다중값 속성을 수정할 때는 값 전체 목록을 덮어쓰지 않고 값을 추가하거나 제거해야 합니다. 이러한 작업을 정확하게 수행하는 방법에 대해서는 다음 섹션에서 설명합니다.

참고

Set-TransportRule과 같은 일부 cmdlet에서는 이 항목에서 설명된 개체 속성 수정 방식이 지원되지 않습니다. 이러한 cmdlet을 사용하여 다중 값 속성의 값을 추가 및 제거하는 방법에 대한 자세한 내용은 Set-TransportRule 등의 해당 cmdlet 항목을 참조하십시오.

다중값 속성 수정

다중값 속성 수정은 단일 값 속성 수정과 유사합니다. 속성에 저장된 모든 값을 바꾸는 것이 아니라 다중값 속성에 값을 추가하거나 다중값 속성에서 값을 제거하도록 셸에 지시하는 일부 구문을 추가하기만 하면 됩니다. cmdlet을 실행할 때 속성에 추가하거나 속성에서 제거하는 값에 따라 구문이 매개 변수에 대한 값으로 추가됩니다. 다음 표에는 다중값 속성을 수정하기 위해 cmdlet에 대한 매개 변수에 추가해야 하는 구문이 나와 있습니다.

다중값 속성 구문

Action 구문

다중값 속성에 하나 이상의 값 추가

@{Add="<value1>", "<value2>", "<value3>"}

다중값 속성에서 하나 이상의 값 제거

@{Remove="<value1>", "<value2>", "<value3>"}

다중값 속성 구문 표에서 선택하는 구문은 cmdlet에 대한 매개 변수 값으로 지정됩니다. 예를 들어 다음 명령을 통해 다중값 속성에 여러 값을 추가할 수 있습니다.

Set-ExampleCmdlet -Parameter @{Add="Red", "Blue", "Green"}

이 구문 사용 시 지정하는 값은 속성에 이미 표시된 값 목록에서 추가되거나 제거됩니다. 이 항목의 앞부분에 있는 BlockedRecipients 예를 통해 이제 다음 명령을 사용하여 이 속성의 나머지 값을 덮어쓰지 않고도 chris@contoso.com을 추가할 수 있습니다.

Set-RecipientFilterConfig -BlockedRecipients @{Add="chris@contoso.com"}

값 목록에서 david@adatum.com을 제거하려는 경우 다음 명령을 사용합니다.

Set-RecipientFilterConfig -BlockedRecipients @{Remove="david@adatum.com"}

동시에 속성에 값을 추가하거나 속성에서 값을 제거하는 것처럼 보다 복잡한 조합을 사용할 수 있습니다. 이렇게 하려면 Add 동작과 Remove 동작 사이에 세미콜론(;)을 삽입합니다. 예를 들면 다음과 같습니다.

Set-RecipientFilterConfig -BlockedRecipients @{Add="carter@contoso.com", "sam@northwindtraders.com", "brian@adatum.com"; Remove="john@contoso.com"}

Get-RecipientFilterConfig | Format-List BlockedRecipients 명령을 다시 사용하면 Carter, Sam 및 Brian의 전자 메일 주소가 추가된 반면 John의 주소가 제거된 것을 확인할 수 있습니다.

BlockedRecipients : {brian@adatum.com, sam@northwindtraders.com, carter@contoso.com, chris@contoso.com, kim@northwindtraders.com}