Enable-RemoteMailbox
此 cmdlet 仅适用于本地 Exchange。
使用 Enable-RemoteMailbox cmdlet 在基于云的服务中为本地 Active Directory中的现有用户创建邮箱。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Enable-RemoteMailbox
[-Identity] <UserIdParameter>
[-RemoteRoutingAddress <ProxyAddress>]
[-ACLableSyncedObjectEnabled]
[-Alias <String>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-PrimarySmtpAddress <SmtpAddress>]
[-WhatIf]
[<CommonParameters>]
Enable-RemoteMailbox
[-Identity] <UserIdParameter>
[-Room]
[-ACLableSyncedObjectEnabled]
[-Alias <String>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RemoteRoutingAddress <ProxyAddress>]
[-WhatIf]
[<CommonParameters>]
Enable-RemoteMailbox
[-Identity] <UserIdParameter>
[-Equipment]
[-ACLableSyncedObjectEnabled]
[-Alias <String>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RemoteRoutingAddress <ProxyAddress>]
[-WhatIf]
[<CommonParameters>]
Enable-RemoteMailbox
[-Identity] <UserIdParameter>
[-Archive]
[-ArchiveName <MultiValuedProperty>]
[-ACLableSyncedObjectEnabled]
[-Alias <String>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-PrimarySmtpAddress <SmtpAddress>]
[-WhatIf]
[<CommonParameters>]
Enable-RemoteMailbox
[-Identity] <UserIdParameter>
[-Shared]
[-ACLableSyncedObjectEnabled]
[-Alias <String>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RemoteRoutingAddress <ProxyAddress>]
[-WhatIf]
[<CommonParameters>]
说明
Enable-RemoteMailbox cmdlet 可以对现有内部部署用户启用邮件。 已启用邮件的用户包含特定属性,该属性表示当用户与使用目录同步的服务同步时,应该在服务中创建关联邮箱。
必须正确配置目录同步,才能在服务中创建邮箱。 不可以立即在服务中的创建邮箱,而是根据目录同步日程安排进行创建。
应用于本地 Exchange 组织中的收件人的策略(如统一消息或合规性策略)不会应用于服务中的邮箱。 如果要将策略应用到服务中的收件人,则必须在服务中配置这些策略。
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Enable-RemoteMailbox "Kim Akers" -RemoteRoutingAddress "kima@contoso.mail.onmicrosoft.com"
本示例对现有内部部署用户启用邮件并在服务中创建关联邮箱。
对用户启用邮件后,目录同步会将已启用邮件的用户同步到服务并创建关联邮箱。
示例 2
Enable-RemoteMailbox "Kim Akers" -RemoteRoutingAddress "kima@contoso.mail.onmicrosoft.com"
Enable-RemoteMailbox "Kim Akers" -Archive
本示例执行以下操作:
对现有内部部署用户启用邮件。
在服务中创建关联邮箱。
在服务中为该邮箱创建存档邮箱。
若要为本地用户启用邮件,请在服务中创建关联的邮箱,在服务中启用存档邮箱,并在 Enable-RemoteMailbox cmdlet 中包含存档开关。
参数
-ACLableSyncedObjectEnabled
ACLableSyncedObjectEnabled 开关指定远程邮箱是否为 ACLableSyncedMailboxUser。 不必为此开关指定值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Alias
Alias 参数指定 Exchange 别名 (也称为收件人的邮件昵称) 。 此值将收件人标识为已启用邮件的对象,且不得与同一个收件人的多个电子邮件地址混淆(也称为代理地址)。 收件人只能有一个 Alias 值。 最大长度为 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 参数,则别名属性值将使用其他必需参数的值:
- 用户帐户 (收件人,例如,用户邮箱和邮件用户) :使用 MicrosoftOnlineServicesID 或 UserPrincipalName 参数的左侧。 例如, helpdesk@contoso.onmicrosoft.com 结果为 Alias 属性值
helpdesk
。 - 没有用户帐户的收件人 (例如会议室邮箱、邮件联系人和通讯组) :使用 Name 参数的值。 删除空格并将不受支持的字符转换为问号 (?) 。
如果修改现有收件人的别名值,则仅在收件人受电子邮件地址策略约束的环境中自动更新主电子邮件地址, (收件人) 的 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 |
-Archive
存档开关为已有邮箱的现有基于云的用户创建存档邮箱。 不必为此开关指定值。
Type: | SwitchParameter |
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 |
-ArchiveName
ArchiveName 参数指定存档邮箱的名称。 这是在以前称为Outlook Web App) Outlook 网页版 (中显示的用户的名称。 如果值中有空格,请使用双引号 (") 将此值括起来。
如果不使用此参数,则会根据 Exchange 的版本使用以下默认值:
- Exchange 2016 或更高版本:
In-Place Archive -<Display Name>
- Exchange 2013:
In-Place Archive - <Display Name>
- Exchange 2010:
Personal Archive - <Display Name>
在 Outlook 中,忽略此参数的值。 文件夹列表中显示的存档邮箱的名称为 Online Archive - <PrimarySMTPAddress>
。
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 |
-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 |
-DisplayName
DisplayName 参数指定在服务中创建的邮箱的显示名称。 显示名称在 Exchange 管理中心、地址列表和 Outlook 中可见。 长度不得超过 256 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。
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 |
-DomainController
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 |
-Equipment
Equipment 开关指定应将服务中的邮箱创建为设备资源邮箱。 不必为此开关指定值。
设备邮箱是未与特定位置关联的资源邮箱, (例如,车辆或计算机) 。
不能将此开关与会议室或共享交换机一起使用。
Type: | SwitchParameter |
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 |
-Identity
Identity 参数指定现有本地用户的标识。 可以使用任何能够唯一标识该用户的值。 例如:
- ADObjectID
- GUID
- 可分辨名称 (DN)
- 域\用户名
- 用户主体名称 (UPN)
- LegacyExchangeDN
- 用户别名
Type: | UserIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-PrimarySmtpAddress
PrimarySmtpAddress 参数指定对收件人使用的主要返回电子邮件地址。
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 |
-RemoteRoutingAddress
RemoteRoutingAddress 参数指定服务中与此用户关联的邮箱的 SMTP 地址。
Type: | ProxyAddress |
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 |
-Room
Room 开关指定应将服务中的邮箱创建为会议室资源邮箱。 不必为此开关指定值。
不能将此开关与设备或共享交换机一起使用。
Type: | SwitchParameter |
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 |
-Shared
注意:此开关仅在 Exchange 2013 CU21 或更高版本和 Exchange 2016 CU10 或更高版本中可用。 若要使用此开关,还需要运行 setup.exe /PrepareAD。 有关详细信息,请参阅 KB4133605。
共享开关指定服务中的邮箱应创建为共享邮箱。 不必为此开关指定值。
不能将此开关与会议室或设备开关一起使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。