共用方式為

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 指令程式，必須對您使用的帳戶委派下列項目：

  • 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
  • UUENCODE
  • AppleSingle
  • AppleDouble

此參數預設是設為 BinHex。

MacAttachmentFormat 參數的可接受值視 MessageFormat 參數而定。如果 MessageFormat 參數設為 Text，您只能對此參數使用 BinHex 或 UUENCODE 值。如果 MessageFormat 參數設為 MIME，您只能對此參數使用 BinHex、AppleSingle 或 AppleDouble 值。

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 參數會為傳送給郵件連絡人的郵件指定郵件格式。

此參數的有效值為：

  • Text
  • MIME

此參數預設是設為 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"

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.