New-MailContact(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 2007-06-05
New-MailContact 명령을 사용하여 메일이 사용 가능하도록 설정된 연락처를 새로 만들 수 있습니다.
구문
New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>]
자세한 정보
New-MailContact 명령은 Microsoft Active Directory에서 새 메일 연락처 개체를 만든 다음 메일 연락처에 대해 메일 사용이 가능하도록 설정합니다.
New-MailContact cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.
Exchange 받는 사람 관리자 역할
해당하는 Active Directory 컨테이너에 대한 계정 운영자 역할
사용 권한, 역할 위임 및 Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
매개 변수 | 필수 | 종류 | 설명 |
---|---|---|---|
ExternalEmailAddress |
필수 |
Microsoft.Exchange.Data.ProxyAddress |
대상 전자 메일 주소입니다. |
Name |
필수 |
System.String |
메일 연락처의 일반적인 이름입니다. |
OrganizationalUnit |
필수 |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
새 연락처가 추가되는 조직 단위입니다 (예: redmond.contoso.com/contacts). |
Alias |
선택 |
System.String |
메일 연락처의 별칭입니다. |
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로 설정됩니다. MacAttachmentFormat 매개 변수에 사용할 수 있는 적합한 값은 MessageFormat 매개 변수에 따라 달라집니다. MessageFormat 매개 변수가 Text로 설정되어 있으면 이 매개 변수에 대해 BinHex 또는 UUENCODE 값만을 사용할 수 있습니다. 그리고 MessageFormat 매개 변수가 Mime으로 설정되어 있으면 이 매개 변수에 대해 BinHex, AppleSingle 또는 AppleDouble 값만을 사용할 수 있습니다. |
MessageBodyFormat |
선택 |
Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat |
MessageBodyFormat 매개 변수는 메일 연락처에게 보내는 메시지의 메시지 본문 형식을 지정합니다. 이 매개 변수의 유효한 값은 다음과 같습니다.
기본적으로 이 매개 변수는 TextAndHtml로 설정됩니다. MessageFormat 및 MessageBodyFormat 매개 변수는 각각 서로에게 영향을 줍니다. 즉, MessageFormat 매개 변수가 Mime로 설정되어 있으면 MessageBodyFormat 매개 변수를 모든 유효한 값으로 설정할 수 있지만 MessageFormat 매개 변수가 Text로 설정되어 있으면 MessageBodyFormat 매개 변수도 Text로만 설정할 수 있습니다. 그러므로 이 매개 변수를 Html 또는 TextAndHtml로 설정하려면 MessageFormat 매개 변수도 Mime으로 설정해야 합니다. |
MessageFormat |
선택 |
Microsoft.Exchange.Data.Directory.Recipient.MessageFormat |
MessageFormat 매개 변수는 메일 연락처에게 보내는 메시지의 메시지 형식을 지정합니다. 이 매개 변수의 유효한 값은 다음과 같습니다.
기본적으로 이 매개 변수는 Mime으로 설정됩니다. MessageFormat 및 MessageBodyFormat 매개 변수는 각각 서로에게 영향을 줍니다. 즉, MessageFormat 매개 변수가 Mime으로 설정되어 있으면 MessageBodyFormat 매개 변수를 모든 유효한 값으로 설정할 수 있지만 MessageFormat 매개 변수가 Text로 설정되어 있으면 MessageBodyFormat 매개 변수도 Text로만 설정할 수 있습니다. 그러므로 MessageFormat 매개 변수를 Mime에서 Text로 변경하려면 MessageBodyFormat 매개 변수도 Text로 변경해야 합니다. |
TemplateInstance |
선택 |
System.Management.Automation.PSObject |
이 매개 변수에 기존 개체를 제공하면 명령이 해당 개체의 구성을 사용하여 로컬 또는 대상 서버에 이 개체의 복제본을 만듭니다. |
UsePreferMessageFormat |
선택 |
System.Boolean |
이 매개 변수를 true로 설정하면 받는 사람의 기본 메시지 형식 설정이 이 사용자에게 보낸 메일의 전역 설정보다 우선합니다. |
입력 형식
반환 형식
오류
오류 | 설명 |
---|---|
예외
예외 | 설명 |
---|---|
예제
다음 예는 New-MailContact 명령을 사용하여 메일이 사용 가능하도록 설정된 새로운 연락처를 만듭니다.
New-MailContact -Name "Ted Bremer" -ExternalEmailAddress "ted@tailspintoys.com" -OrganizationalUnit "Marketing"