New-MailContact

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。有些參數和設定可能是某一個環境所專屬。

使用 New-MailContact Cmdlet 建立郵件連絡人。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

New-MailContact
   -Name <String>
   -ExternalEmailAddress <ProxyAddress>
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Confirm]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MacAttachmentFormat <MacAttachmentFormat>]
   [-MessageBodyFormat <MessageBodyFormat>]
   [-MessageFormat <MessageFormat>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-UsePreferMessageFormat <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

New-MailContact -Name "Chris Ashton" -ExternalEmailAddress "chris@tailspintoys.com"

此範例會建立名為 Chris Ashton 的新郵件連絡人。

參數

-Alias

Alias 參數會指定 Exchange 別名 (也稱為收件者的郵件昵稱) 。此值會將收件者識別為啟用郵件的物件，且不應與相同收件者 (也稱為 proxy 位址) 的多個電子郵件地址混淆。收件者只能有一個別名值。最大長度為 64 個字元。

別名值可以包含字母、數位和下列字元：

！、#、% *、+、-、/、=、？、^、_和 ~。
$、 & 、'、'、{、}和 | 必須逸出 (例如 -Alias what`'snew) 或以單引號括住的整個值 (例如 -Alias 'what'snew' ，) 。 &Azure AD Connect 同步處理的別名值不支援字元。
(.) 的句號必須以其他有效字元括住， help.desk 例如) (。
Unicode 字元 U+00A1 至 U+00FF。

當您建立收件者但未指定電子郵件地址時，您指定的別名值會用來產生主要電子郵件地址 (alias@domain) 。支援的 Unicode 字元會對應到最合適的 US-ASCII 文字字元。例如，主要電子郵件地址中的 U+00F6 (ö) 會變更為 oe 。

如果您在建立收件者時未使用 Alias 參數，則會針對 Alias 屬性值使用不同必要參數的值：

具有使用者帳戶的收件者 (例如，使用者信箱和郵件使用者) ：使用 MicrosoftOnlineServicesID 或 UserPrincipalName 參數的左側。例如， helpdesk@contoso.onmicrosoft.com 會產生 Alias 屬性值 helpdesk 。
沒有使用者帳戶的收件者 (例如，會議室信箱、郵件連絡人和通訊群組) ：使用 Name 參數的值。空格會移除，不支援的字元會轉換成問號 (？) 。

如果您修改現有收件者的 Alias 值，主要電子郵件地址只會在收件者受限於電子郵件地址原則的環境中自動更新， (收件者) 的 EmailAddressPolicyEnabled 屬性為 True。

Alias 參數永遠不會產生或更新郵件連絡人或郵件使用者的主要電子郵件地址。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ArbitrationMailbox

此參數僅適用於內部部署 Exchange。

ArbitrationMailbox 參數會指定用來管理這位收件者之仲裁程序的仲裁信箱。您可以使用唯一識別仲裁信箱的任何值。例如：

名稱
別名
辨別名稱 (DN)
辨別名稱 (DN)
Domain\Username
電子郵件地址
GUID
LegacyExchangeDN
SamAccountName
使用者識別碼或使用者主要名稱 (UPN)

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DisplayName

DisplayName 參數會指定郵件連絡人的顯示名稱。顯示名稱會顯示在 Exchange 系統管理中心和通訊清單中。最大長度為 256 個字元。如果值包含空格，請使用引號 (") 括住值。

如果您未使用 DisplayName 參數，則 Name 參數的值會用於顯示名稱。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。例如，dc01.contoso.com。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExternalEmailAddress

ExternalEmailAddress 參數會指定郵件連絡人或郵件使用者的目標電子郵件地址。根據預設，此值會作為郵件連絡人或郵件使用者的主要電子郵件地址。

在內部部署環境中，您可以使用 PrimarySMTPAddress 參數，將主要電子郵件地址設定為不同的值。根據預設，這個值可當做郵件連絡人或郵件使用者的主要電子郵件地址。

Type:	ProxyAddress
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-FirstName

FirstName 參數可指定使用者的名字。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Initials

Initials 參數會指定使用者的中間名縮寫。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-LastName

LastName 參數可指定使用者的姓氏。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MacAttachmentFormat

MacAttachmentFormat 參數會指定 Apple Macintosh 作業系統附件格式，以用於傳送給郵件連絡人或郵件使用者的郵件。有效值為：

BinHex (這是預設值)
UuEncode
AppleSingle
AppleDouble

MacAttachmentFormat 和 MessageFormat 參數是相互依存的：

MessageFormat 為 Text：MacAttachmentFormat 可以是 BinHex 或 UuEncode。
MessageFormat 為 Mime：MacAttachmentFormat 可以是 BinHex、AppleSingle 或 AppleDouble。

Type:	MacAttachmentFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MessageBodyFormat

MessageBodyFormat 參數會指定傳送給郵件連絡人或郵件使用者之郵件的郵件本文格式。有效值為：

文字
Html
Html

MessageFormat 和 MessageBodyFormat 參數相互依存：

MessageFormat 為 Mime：MessageBodyFormat 可以是 Text、Html 或 TextAndHtml。
MessageFormat 為 Text：MessageBodyFormat 只能是 Text。

Type:	MessageBodyFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MessageFormat

MessageBodyFormat 參數會指定傳送給郵件連絡人或郵件使用者之郵件的郵件本文格式。有效值為：

文字
Html
Html

MessageFormat 和 MessageBodyFormat 參數相互依存：

MessageFormat 為 Mime：MessageBodyFormat 可以是 Text、Html 或 TextAndHtml。
MessageFormat 為 Text：MessageBodyFormat 只能是 Text。

Type:	MessageFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ModeratedBy

ModeratedBy 參數會指定此郵件連絡人的一或多個仲裁者。仲裁者會在郵件傳遞之前核准傳送給郵件連絡人的郵件。仲裁者必須是組織中的信箱、郵件使用者或郵件連絡人。您可以使用唯一識別仲裁者的任何值。例如：

名稱
別名
辨別名稱 (DN)
辨別名稱 (DN)
標準 DN
GUID

您可以輸入多個以逗號分隔的值。如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。

當您將 ModerationEnabled 參數設定為值 $true 時，您需要使用此參數來指定至少一個仲裁者。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ModerationEnabled

ModerationEnabled 參數會指定是否為此收件者啟用仲裁。有效值為：

$true：已為此收件者啟用仲裁。傳送給此收件者的郵件必須先由仲裁者核准，才能傳遞訊息。
$false：已停用此收件者的仲裁。傳送給此收件者的訊息會在未經仲裁者核准的情況下傳遞。這是預設值。

您可以使用 ModeratedBy 參數來指定仲裁者。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Name 參數會指定郵件連絡人的唯一名稱。最大長度為 64 個字元。如果值包含空格，請使用引號 (") 括住值。

如果您未使用 DisplayName 參數，此值也會用於 DisplayName 內容。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OrganizationalUnit

OrganizationalUnit 參數會指定 Active Directory 中建立新連絡人的位置。

此參數的有效輸入是組織單位 (OU) 或由 Get-OrganizationalUnit Cmdlet 傳回的網域。您可以使用唯一識別 OU 或網域的任何值。例如：

名稱
名稱
辨別名稱 (DN)
GUID

Type:	OrganizationalUnitIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PrimarySmtpAddress

此參數僅適用於內部部署 Exchange。

PrimarySmtpAddress 參數會指定用於收件者的主要回覆電子郵件地址。

依預設，主要位址會與 ExternalEmailAddress 參數值相同。

如果您使用 PrimarySmtpAddress 參數來指定主要電子郵件地址，此命令會將郵件連絡人的 EmailAddressPolicyEnabled 內容設為 False，這表示電子郵件地址原則不會自動更新郵件連絡人的電子郵件地址。除非在跨樹系的情況下，否則建議您不要將主要電子郵件地址設定為 ExternalEmailAddress 以外的值。

Type:	SmtpAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SendModerationNotifications

系統會將用戶端連線從用戶端存取服務 Proxy 處理到本機或遠端信箱伺服器上的後端服務。有效值為：

一律：未核准其訊息時通知所有寄件者。這是預設值。
Always：在所有寄件者的郵件未獲核准時加以通知。此為預設值。
Internal：在組織中寄件者的郵件未獲核准時加以通知。

只有在 ModerationEnabled 參數具有值$true) (啟用仲裁時，這個參數才有意義。

Type:	TransportModerationNotificationFlags
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UsePreferMessageFormat

UsePreferMessageFormat 會指定為郵件使用者或郵件連絡人設定的郵件格式設定，是否覆寫為遠端網域設定的全域設定，或由郵件寄件者設定的全域設定。有效值為：

$true：傳送給郵件使用者或郵件連絡人的郵件會使用為郵件使用者或郵件連絡人設定的郵件格式。
$false：傳送給郵件使用者或郵件連絡人的郵件會使用為遠端網域設定的訊息格式， (預設遠端網域或特定遠端網域) 或由郵件寄件者設定。這是預設值。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

WhatIf 參數會模擬命令的動作。使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。您不需要使用此參數指定值。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。

共用方式為

New-MailContact

Syntax

Description

範例

範例 1

參數

-Alias

-ArbitrationMailbox

-Confirm

-DisplayName

-DomainController

-ExternalEmailAddress

-FirstName

-Initials

-LastName

-MacAttachmentFormat

-MessageBodyFormat

-MessageFormat

-ModeratedBy

-ModerationEnabled

-Name

-OrganizationalUnit

-PrimarySmtpAddress

-SendModerationNotifications

-UsePreferMessageFormat

-WhatIf

輸入

輸出

意見反應

其他資源