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 指令程式,則必須將下列項目委派給您使用的帳戶:

  • 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 參數會為傳送給郵件連絡人的郵件指定郵件內文格式。此參數的有效值為:

  • Text
  • HTML
  • TextAndHtml

此參數預設是設為 TextAndHtml。

MessageFormatMessageBodyFormat 參數是相互依賴的。如果 MessageFormat 參數設為 MIME,則 MessageBodyFormat 參數可設為任何有效的值。然而,如果 MessageFormat 參數設為 Text,則 MessageBodyFormat 參數只可以設為 Text。因此,如果您想要將此參數設為 Html 或 TextAndHtml,您也必須將 MessageFormat 參數設為 MIME。

MessageFormat

選用

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

MessageFormat 參數會為傳送給郵件連絡人的郵件指定郵件格式。

此參數的有效值為:

  • Text
  • MIME

此參數預設是設為 MIME。

MessageFormatMessageBodyFormat 參數是相互依賴的。如果 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 位址,則指令程式會將郵件連絡人的 EmailAddressPolicyEnabled 屬性設為 $false,而且此郵件連絡人的電子郵件地址將不會根據電子郵件地址原則來自動更新。

TemplateInstance

選用

System.Management.Automation.PSObject

將現有的物件提供給此參數時,命令會使用該物件的組態在本機或目標伺服器上建立該物件的相同副本。

UsePreferMessageFormat

選用

System.Boolean

設為 true 時,這個參數可指定收件者慣用的郵件格式設定,使其覆寫傳送至此使用者之郵件的全域設定。

UseRusServer

選用

System.String

note附註:
只有在 Exchange 2007 SP2 中才能使用此參數。

UseRusServer 參數會指示此命令,使用通訊清單服務執行所在的指定信箱伺服器來取得並設定信箱及 Active Directory 使用者屬性。

通訊清單服務是 Exchange System Attendant 服務的一個元件。通訊清單服務會在 Active Directory 中建立並維護 Exchange 的特定屬性。您可以使用特定資訊 (如通訊清單成員資格與電子郵件地址),透過通訊清單服務來更新網域中的收件者物件。

WhatIf

選用

System.Management.Automation.SwitchParameter

WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數,則不需要套用任何變更,就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤 描述

例外狀況

例外狀況 描述

範例

在下列範例中,會使用 New-MailContact 命令建立擁有郵件功能的新連絡人。

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

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