Enable-MailUser

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

使用 Enable-MailUser cmdlet 为未启用邮件的现有用户启用邮件。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Enable-MailUser
      [-Identity] <UserIdParameter>
      -ExternalEmailAddress <ProxyAddress>
      [-Alias <String>]
      [-Confirm]
      [-DisplayName <String>]
      [-DomainController <Fqdn>]
      [-MacAttachmentFormat <MacAttachmentFormat>]
      [-MessageBodyFormat <MessageBodyFormat>]
      [-MessageFormat <MessageFormat>]
      [-PrimarySmtpAddress <SmtpAddress>]
      [-UsePreferMessageFormat <Boolean>]
      [-WhatIf]
      [<CommonParameters>]

Enable-MailUser
      [-Identity] <UserIdParameter>
      [-ExternalEmailAddress <ProxyAddress>]
      [-Alias <String>]
      [-Confirm]
      [-DisplayName <String>]
      [-DomainController <Fqdn>]
      [-PrimarySmtpAddress <SmtpAddress>]
      [-WhatIf]
      [<CommonParameters>]

说明

Enable-MailUser cmdlet 邮件通过添加 Exchange 所需的电子邮件属性来启用现有用户。邮件用户对其他 *-MailUser cmdlet 可见。

邮件用户在 Exchange 组织中具有电子邮件地址和帐户，但他们没有 Exchange 邮箱。发送给邮件用户的电子邮件会传递到指定的外部电子邮件地址。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Enable-MailUser -Identity John -ExternalEmailAddress john@contoso.com

此示例使用外部电子邮件地址 john@contoso.com为用户启用 mail- 。

参数

-Alias

Alias 参数指定 Exchange 别名 (也称为收件人的邮件昵称) 。此值将收件人标识为已启用邮件的对象，且不得与同一个收件人的多个电子邮件地址混淆（也称为代理地址）。收件人只能有一个 Alias 值。最大长度为 64 个字符。

别名值可以包含字母、数字和以下字符：

！、#、%*、+、-、/、=、？、^、_和 ~。
$、&、'、'、{、}和 |需要 (转义，例如 -Alias what`'snew) 或用单引号括起来的整个值 (例如 -Alias 'what'snew') 。 Microsoft Entra Connect 同步的别名值中不支持 & 字符。
句点 (.) 必须用其他有效字符括起来， (例如 help.desk) 。
Unicode 字符 U+00A1 到 U+00FF。

在不指定电子邮件地址的情况下创建收件人时，指定的别名值将用于生成主电子邮件地址 (alias@domain) 。支持的 Unicode 字符会映射到最适合的 US-ASCII 文本字符。例如，U+00F6 (ö) 在主电子邮件地址更改为 oe 。

如果在创建收件人时不使用 Alias 参数，则别名属性值将使用其他必需参数的值：

用户帐户 (收件人，例如，用户邮箱和邮件用户) ：使用 MicrosoftOnlineServicesID 或 UserPrincipalName 参数的左侧。例如， helpdesk@contoso.onmicrosoft.com 结果为 Alias 属性值 helpdesk。
没有用户帐户的收件人 (例如会议室邮箱、邮件联系人和通讯组) ：使用 Name 参数的值。删除空格并将不受支持的字符转换为问号 (？) 。

如果修改现有收件人的别名值，则仅在收件人受电子邮件地址策略约束的环境中自动更新主电子邮件地址， (收件人) 的 EmailAddressPolicyEnabled 属性为 True。

Alias 参数永远不会生成或更新邮件联系人或邮件用户的主电子邮件地址。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayName

DisplayName 参数指定邮件用户的显示名称。显示名称在 Exchange 管理中心和地址列表中可见。长度不得超过 256 个字符。如果值中有空格，请使用双引号 (") 将此值括起来。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DomainController

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

类型:	Fqdn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ExternalEmailAddress

ExternalEmailAddress 参数指定组织外部的电子邮件地址。发送到已启用邮件用户的电子邮件将被发送到该外部地址。

类型:	ProxyAddress
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Identity

Identity 参数指定要启用邮件的用户。可以使用任何能够唯一标识该用户的值。例如：

名称
可分辨名称 (DN)
可分辨名称 (DN)
GUID

类型:	UserIdParameter
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-MacAttachmentFormat

MacAttachmentFormat 参数指定用于发送给邮件联系人或邮件用户的邮件的 Apple Macintosh作系统附件格式。有效值包含:

BinHex (这是默认值)
UuEncode
AppleSingle
AppleDouble

MacAttachmentFormat 和 MessageFormat 参数相互依赖：

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

类型:	MacAttachmentFormat
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MessageBodyFormat

MessageBodyFormat 参数指定发送给邮件联系人或邮件用户的邮件的邮件正文格式。有效值包含:

Text
Html
Html

MessageFormat 和 MessageBodyFormat 参数相互依赖：

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

类型:	MessageBodyFormat
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MessageFormat

MessageFormat 参数指定发送给邮件联系人或邮件用户的邮件的邮件格式。有效值包含:

Text
Text

MessageFormat 和 MessageBodyFormat 参数相互依赖：

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

因此，如果要将 MessageFormat 参数从 Mime 更改为 Text，则还必须将 MessageBodyFormat 参数更改为 Text。

类型:	MessageFormat
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PrimarySmtpAddress

PrimarySmtpAddress 参数指定对收件人使用的主要返回电子邮件地址。

默认情况下，主地址与 ExternalEmailAddress 参数值相同。

如果您使用 PrimarySmtpAddress 参数指定主电子邮件地址，该命令将邮件用户的 EmailAddressPolicyEnabled 属性设置为 False，这意味着电子邮件地址策略无法自动更新邮件用户的电子邮件地址。我们建议您不要将主电子邮件地址设置为 ExternalEmailAddress 以外的值，除非您使用的是跨林方案。

类型:	SmtpAddress
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UsePreferMessageFormat

UsePreferMessageFormat 指定为邮件用户或邮件联系人配置的邮件格式设置是覆盖为远程域配置的全局设置，还是由邮件发件人配置的全局设置。有效值包括：

$true：发送给邮件用户或邮件联系人的邮件使用为邮件用户或邮件联系人配置的邮件格式。
$false：发送给邮件用户或邮件联系人的邮件使用为远程域配置的邮件格式， (默认远程域或特定远程域) 或由邮件发件人配置的邮件格式。此值为默认值。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

WhatIf 开关模拟命令操作。可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。不必为此开关指定值。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。