New-MailContact

  • 아티클

 

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

마지막으로 수정된 항목: 2009-05-14

New-MailContact 명령을 사용하여 메일이 사용 가능하도록 설정된 연락처를 새로 만들 수 있습니다.

구문

New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

자세한 설명

New-MailContact 명령은 Microsoft Active Directory에서 새 메일 연락처 개체를 만든 다음 메일 연락처에 대해 메일 사용이 가능하도록 설정합니다.

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

  • Exchange 받는 사람 관리자 역할

  • 적용 가능한 Active Directory 컨테이너에 대한 계정 운영자 역할

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

매개 변수

매개 변수 필수 종류 설명

ExternalEmailAddress

필수

Microsoft.Exchange.Data.ProxyAddress

대상 전자 메일 주소입니다.

Name

필수

System.String

메일 연락처의 일반적인 이름입니다.

Alias

선택

System.String

메일 연락처의 별칭입니다.

Confirm

선택

System.Management.Automation.SwitchParameter

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

DisplayName

선택

System.String

메일 연락처에 대해 Microsoft Outlook에서 표시되는 이름입니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

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

FirstName

선택

System.String

메일 연락처의 이름입니다.

Initials

선택

System.String

메일 연락처의 이니셜입니다.

LastName

선택

System.String

메일 연락처의 성입니다.

MacAttachmentFormat

선택

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

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

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

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

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

MessageBodyFormat

선택

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

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

  • 텍스트

  • 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로 변경해야 합니다.

OrganizationalUnit

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

새 연락처가 추가되는 조직 단위입니다 (예: redmond.contoso.com/contacts).

PrimarySmtpAddress

선택

Microsoft.Exchange.Data.SmtpAddress

메일 연락처의 기본 SMTP 주소를 지정하려면 이 매개 변수를 사용합니다. 기본적으로 기본 SMTP 주소는 기본 전자 메일 주소 정책을 기준으로 생성됩니다. 이 매개 변수를 사용하여 기본 SMTP 주소를 지정하는 경우 cmdlet는 메일 연락처의 EmailAddressPolicyEnabled 특성을 $false로 설정하며, 이 메일 연락처의 전자 메일 주소가 전자 메일 주소 정책에 따라 자동으로 업데이트되지 않습니다.

TemplateInstance

선택

System.Management.Automation.PSObject

이 매개 변수에 기존 개체를 제공하면 이 명령은 해당 개체의 구성을 사용하여 로컬 또는 대상 서버에서 해당 개체와 정확히 동일한 복사본을 만듭니다.

UsePreferMessageFormat

선택

System.Boolean

이 매개 변수를 true로 설정하면 받는 사람의 기본 메시지 형식 설정이 이 사용자에게 보낸 메일의 전역 설정보다 우선합니다.

UseRusServer

선택

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

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

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

WhatIf

선택

System.Management.Automation.SwitchParameter

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

입력 형식

반환 형식

오류

오류 설명

예외

예외 설명

예제

다음 예는 New-MailContact 명령을 사용하여 메일이 사용 가능하도록 설정된 새로운 연락처를 만듭니다.

New-MailContact -Name "Ted Bremer" -ExternalEmailAddress "ted@tailspintoys.com" -OrganizationalUnit "Marketing"