Set-MailContact

  • 아티클

 

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

마지막으로 수정된 항목: 2011-01-26

Set-MailContact cmdlet를 사용하면 Active Directory 디렉터리 서비스에서 기존의 메일 사용 가능 연락처를 수정할 수 있습니다.

구문

Set-MailContact -Identity <MailContactIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-MailContact [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <MailContact>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

자세한 정보

Set-MailContact cmdlet는 연락처의 ID 및 수정할 특성을 지정하여 Active Directory에서 기존의 메일 사용 가능 연락처를 수정합니다.

Set-MailContact cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.

  • Exchange 받는 사람 관리자 역할

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

매개 변수

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter

Identity 매개 변수에는 다음 값 중 하나를 사용할 수 있습니다.

  • ADObjectID

  • GUID

  • DN(고유 이름)

  • Domain\SamAccountName

  • UPN(user principal name)

  • 레거시 DN

  • 전자 메일 주소

  • 연락처 별칭

AcceptMessagesOnlyFrom

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFrom 매개 변수는 이 메일 연락처에 전자 메일 메시지를 보낼 수 있는 사서함 사용자, 메일 사용자 및 메일 연락처를 지정합니다. 또한 Microsoft Exchange를 이 매개 변수에 대한 올바른 받는 사람으로 지정할 수 있습니다. 메일 연락처를 구성하여 Microsoft Exchange 받는 사람의 메시지만 수락하는 경우, 시스템 생성 메시지만 받습니다.

AcceptMessagesOnlyFrom 매개 변수는 유효한 보낸 사람에 대해 다음 값을 사용할 수 있습니다.

  • DN(고유 이름)

  • 정식 이름

  • GUID

  • 이름

  • 표시 이름

  • 별칭

  • Exchange DN

  • 기본 SMTP 전자 메일 주소

기본적으로 이 매개 변수는 공백입니다. 이 매개 변수를 비워 두면 메일 연락처는 모든 보낸 사람의 메시지를 수락할 수 있습니다.

AcceptMessagesOnlyFromDLMembers

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFromDLMembers 매개 변수는 이 메일 연락처에 전자 메일 메시지를 보낼 수 있도록 허용된 구성원의 메일 그룹을 지정합니다. 허용된 메일 그룹에 대해 다음 값 중 하나를 사용할 수 있습니다.

  • DN(고유 이름)

  • 정식 이름

  • GUID

  • 이름

  • 표시 이름

  • 레거시 Exchange DN

  • 기본 SMTP 전자 메일 주소

기본적으로 이 매개 변수는 공백입니다. 이 매개 변수를 비워 두면 메일 연락처는 모든 보낸 사람의 메시지를 수락할 수 있습니다.

Alias

선택

System.String

Alias 매개 변수는 메일 사용 연락처의 별칭을 지정합니다. 별칭에는 문자, 숫자 및 다음과 같은 문장 부호와 기호가 포함될 수 있습니다.

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

Confirm

선택

System.Management.Automation.SwitchParameter

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

CreateDTMFMap

선택

System.Boolean

이 매개 변수는 연락처에 대해 DTMF(복합 주파수 부호) 맵을 만들도록 지정합니다.

CustomAttribute1

선택

System.String

CustomAttribute1 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute10

선택

System.String

CustomAttribute10 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute11

선택

System.String

CustomAttribute11 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute12

선택

System.String

CustomAttribute12 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute13

선택

System.String

CustomAttribute13 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute14

선택

System.String

CustomAttribute14 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute15

선택

System.String

CustomAttribute15 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute2

선택

System.String

CustomAttribute2 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute3

선택

System.String

CustomAttribute3 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute4

선택

System.String

CustomAttribute4 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute5

선택

System.String

CustomAttribute5 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute6

선택

System.String

CustomAttribute6 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute7

선택

System.String

CustomAttribute7 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute8

선택

System.String

CustomAttribute8 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute9

선택

System.String

CustomAttribute9 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

DisplayName

선택

System.String

DisplayName 매개 변수는 사용자의 표시 이름을 지정합니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

이 구성 변경을 Active Directory에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 명령에 DomainController 매개 변수를 포함시킵니다.

EmailAddresses

선택

Microsoft.Exchange.Data.ProxyAddressCollection

EmailAddresses 매개 변수는 메일 연락처의 전자 메일 별칭을 지정하는 데 사용할 수 있습니다. 모든 올바른 Microsoft Exchange 2007 전자 메일 주소 유형을 사용할 수 있습니다. EmailAddresses 매개 변수에 대해 여러 값을 쉼표로 구분된 목록으로 지정할 수 있습니다.

중요

Exchange 2007은 사용자 지정 주소 형식이 올바른지 유효성을 검사하지 않습니다. 지정하는 사용자 지정 주소는 해당 주소 유형에 대한 형식 요구 사항을 반드시 준수해야 합니다. Exchange 2007에서는 X.400 주소를 사용자 지정 주소로 간주하기 때문에 X.400 주소의 유효성을 검사하지 않습니다. 따라서 X.400 주소를 지정할 때는 올바른 구문을 입력해야 합니다.

EmailAddressPolicyEnabled

선택

System.Boolean

EmailAddressPolicyEnabled 매개 변수는 사서함의 전자 메일 주소가 정의된 전자 메일 주소 정책에 따라 자동으로 업데이트될지 여부를 지정합니다.

Extensions

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 연락처의 내선 번호를 하나 이상 지정합니다. 이 매개 변수를 설정할 때는 다이얼 플랜에 있는 모든 내선 번호가 고유해야 합니다.

ExternalEmailAddress

선택

Microsoft.Exchange.Data.ProxyAddress

ExternalEmailAddress 매개 변수는 받는 사람의 외부 전자 메일 주소를 지정합니다.

GrantSendOnBehalfTo

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

GrantSendOnBehalfTo 매개 변수는 이 연락처 대신 메시지를 보낼 수 있는 받는 사람의 DN(고유 이름)을 지정합니다.

HiddenFromAddressListsEnabled

선택

System.Boolean

HiddenFromAddressListsEnabled 매개 변수는 연락처가 주소 목록에 나타날지 여부를 지정합니다. 이 값이 $true이면 연락처가 주소 목록에 표시되지 않습니다. 기본값은 $false입니다.

IgnoreDefaultScope

선택

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 매개 변수는 명령이 Exchange 관리 셸에 대한 기본 받는 사람 범위 설정을 무시하고 해당 범위로 전체 포리스트를 사용하도록 지시합니다. 이렇게 하면 명령은 현재 기본 범위에 있지 않은 Active Directory 개체에 액세스할 수 있습니다. IgnoreDefaultScope 매개 변수를 사용하면 다음과 같은 제한이 적용됩니다.

  • DomainController 매개 변수를 사용할 수 없습니다. 해당 명령은 적합한 글로벌 카탈로그 서버를 자동으로 사용합니다.

  • Identity 매개 변수의 DN만 사용할 수 있습니다. 별칭이나 GUID 등 다른 ID 형태는 사용할 수 없습니다.

Instance

선택

Microsoft.Exchange.Data.Directory.Management.MailContact

Instance 매개 변수를 사용하면 처리할 명령에 전체 개체를 전달할 수 있습니다. 이 매개 변수는 주로 전체 개체를 명령에 전달해야 하는 스크립트에서 사용됩니다.

MacAttachmentFormat

선택

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

MacAttachmentFormat 매개 변수는 메일 연락처에게 보내는 메시지에 대해 Apple Macintosh 운영 체제 첨부 파일 형식을 지정합니다. 이 매개 변수의 유효한 값은 다음과 같습니다.

  • BinHex

  • AppleSingle

  • AppleDouble

기본적으로 이 매개 변수는 BinHex로 설정됩니다.

MacAttachmentFormat 매개 변수에 사용할 수 있는 적합한 값은 MessageFormat 매개 변수에 따라 달라집니다. MessageFormat 매개 변수가 Text로 설정되어 있으면 이 매개 변수에 BinHex 값만을 사용할 수 있습니다. 그리고 MessageFormat 매개 변수가 Mime으로 설정되어 있으면 이 매개 변수에 대해 BinHex, AppleSingle 또는 AppleDouble 값만을 사용할 수 있습니다.

MaxReceiveSize

선택

Microsoft.Exchange.Data.Unlimited

MaxReceiveSize 매개 변수는 받을 수 있는 전자 메일 메시지의 최대 크기를 1KB에서 2,097,151KB 사이로 지정합니다.

값을 지정하지 않으면 제한은 최대값으로 설정됩니다.

MaxRecipientPerMessage

선택

Microsoft.Exchange.Data.Unlimited

MaxRecipientPerMessage 매개 변수는 이 메일 연락처에서 보낸 메시지의 최대 받는 사람 수를 지정합니다.

MaxSendSize

선택

Microsoft.Exchange.Data.Unlimited

MaxSendSize 매개 변수는 보낼 수 있는 전자 메일 메시지의 최대 크기를 1KB에서 2,097,151KB 사이로 지정합니다.

값을 지정하지 않으면 제한은 최대값으로 설정됩니다.

MessageBodyFormat

선택

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

MessageBodyFormat 매개 변수는 메일 연락처에게 보내는 메시지의 메시지 본문 형식을 지정합니다. 이 매개 변수의 유효한 값은 다음과 같습니다.

  • Text

  • Html

  • TextAndHtml

기본적으로 이 매개 변수는 TextAndHtml로 설정됩니다.

MessageFormat과 MessageBodyFormat 매개 변수는 서로에게 영향을 줍니다. 즉, MessageFormat 매개 변수가 Mime으로 설정되어 있으면 MessageBodyFormat 매개 변수를 모든 유효한 값으로 설정할 수 있지만 MessageFormat 매개 변수가 Text로 설정되어 있으면 MessageBodyFormat 매개 변수도 Text로만 설정할 수 있습니다. 그러므로 이 매개 변수를 Html 또는 TextAndHtml로 설정하려면 MessageFormat 매개 변수도 Mime으로 설정해야 합니다.

MessageFormat

선택

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

MessageFormat 매개 변수는 메일 연락처에게 보내는 메시지의 메시지 형식을 지정합니다.

이 매개 변수의 유효한 값은 다음과 같습니다.

  • 텍스트

  • MIME

기본적으로 이 매개 변수는 Mime으로 설정됩니다.

MessageFormat 및 MessageBodyFormat 매개 변수는 각각 서로에게 영향을 줍니다. 즉, MessageFormat 매개 변수가 Mime으로 설정되어 있으면 MessageBodyFormat 매개 변수를 모든 유효한 값으로 설정할 수 있지만 MessageFormat 매개 변수가 Text로 설정되어 있으면 MessageBodyFormat 매개 변수도 Text로만 설정할 수 있습니다. 그러므로 MessageFormat 매개 변수를 Mime에서 Text로 변경하려면 MessageBodyFormat 매개 변수도 Text로 변경해야 합니다.

Name

선택

System.String

Name 매개 변수는 메일 사용 연락처의 이름을 지정합니다.

PrimarySmtpAddress

선택

Microsoft.Exchange.Data.SmtpAddress

PrimarySmtpAddress 매개 변수는 주 SMTP 전자 메일 주소를 지정합니다.

RejectMessagesFrom

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFrom 매개 변수는 메시지를 거부할 받는 사람을 지정합니다.

RejectMessagesFromDLMembers

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFromDLMembers 매개 변수는 메시지를 거부할 메일 그룹 구성원을 지정합니다.

RequireSenderAuthenticationEnabled

선택

System.Boolean

RequireSenderAuthenticationEnabled 매개 변수는 인증된 받는 사람의 메시지만 수락할지 여부를 지정합니다. 기본값은 $false입니다.

SecondaryAddress

선택

System.String

이 매개 변수는 UM 사용 가능 연락처가 사용하는 보조 주소를 지정합니다.

SecondaryDialPlan

선택

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

이 매개 변수는 사용할 보조 UM 다이얼 플랜을 지정합니다. 이 매개 변수는 보조 프록시 주소를 만들 수 있도록 제공됩니다.

SimpleDisplayName

선택

System.String

SimpleDisplayName 매개 변수는 제한된 문자 집합만 허용되는 경우 개체에 대한 대체 설명을 표시하는 데 사용됩니다. 제한된 문자 집합은 26자에서 126자까지의 ASCII 문자로 구성됩니다.

UMDtmfMap

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 UM 사용 가능 연락처에 대해 사용자 정의 DTMF 맵을 만들지 여부를 지정합니다.

UseMapiRichTextFormat

선택

Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat

UseMapiRichTextFormat 매개 변수는 이 메일 연락처에 대해 MAPI RTF(서식 있는 텍스트)의 메시지를 처리하는 방식을 지정합니다. 이 연락처로 보낸 모든 메시지를 일반 텍스트로 변환하려면 이 매개 변수를 Never로 설정하고 항상 이 연락처에 MAPI RTF 형식으로 메시지를 보내려면 이 매개 변수를 Always로 설정합니다. 또한 메시지를 보낸 MAPI 클라이언트에 구성된 설정에 따라 형식을 결정하려면 이 매개 변수를 UseDefaultSettings로 설정합니다.

UsePreferMessageFormat

선택

System.Boolean

UsePreferMessageFormat 매개 변수는 메일 연락처에 대해 구성된 메시지 형식 설정이 원격 도메인에 대해 구성된 전역 설정을 대신할지 여부를 지정합니다. 모든 전역 설정 대신 메일 연락처에 대해 구성된 메시지 형식 설정을 사용하려면 이 매개 변수를 $true로 설정합니다.

UseRusServer

선택

System.String
note참고:
이 매개 변수는 Exchange 2007 SP2에서만 사용할 수 있습니다.

UseRusServer 매개 변수는 주소 목록 서비스를 실행 중인 지정된 사서함 서버를 사용하여 사서함 및 Active Directory 사용자 특성을 가져와 설정하도록 명령에 지시합니다.

주소 목록 서비스는 Exchange 시스템 수행자 서비스의 구성 요소로, Active Directory에서 Exchange 관련 특성 값을 만들어 유지 관리합니다. 주소 목록 서비스를 통해 주소 목록 구성원 및 전자 메일 주소 같은 특정 정보를 사용하여 도메인의 받는 사람 개체를 업데이트할 수 있습니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

WindowsEmailAddress

선택

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress 매개 변수는 이 사서함의 Windows 전자 메일 주소를 지정합니다. 이 주소는 Exchange에서 사용되지 않습니다.

입력 형식

반환 형식

오류

오류 설명

 

예외

예외 설명

 

예제

이 예에서 Set-MailContact 명령은 John Peoples의 외부 전자 메일 주소를 john@contoso.com으로 설정하는 데 사용됩니다.

Set-MailContact -Identity "John Peoples" -ExternalEmailAddress "john@contoso.com"