Enable-UMMailbox
此 cmdlet 仅适用于本地 Exchange。
使用 Enable-UMMailbox cmdlet 可以对现有邮箱用户启用统一消息 (UM)。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Identity (默认值)
Enable-UMMailbox
[-Identity] <MailboxIdParameter>
-UMMailboxPolicy <MailboxPolicyIdParameter>
[-AutomaticSpeechRecognitionEnabled <Boolean>]
[-Confirm]
[-DomainController <Fqdn>]
[-Extensions <MultiValuedProperty>]
[-IgnoreDefaultScope]
[-NotifyEmail <String>]
[-PilotNumber <String>]
[-PIN <String>]
[-PINExpired <Boolean>]
[-SIPResourceIdentifier <String>]
[-ValidateOnly]
[-WhatIf]
[<CommonParameters>]
CloudVoiceMail
Enable-UMMailbox
[-Identity] <MailboxIdParameter>
[-EnableCloudVoiceMail]
[-AutomaticSpeechRecognitionEnabled <Boolean>]
[-Confirm]
[-DomainController <Fqdn>]
[-Extensions <MultiValuedProperty>]
[-IgnoreDefaultScope]
[-NotifyEmail <String>]
[-PilotNumber <String>]
[-Pin <String>]
[-PinExpired <Boolean>]
[-SendWelcomeMail <Boolean>]
[-SIPResourceIdentifier <String>]
[-UMMailboxPolicy <MailboxPolicyIdParameter>]
[-ValidateOnly]
[-WhatIf]
[<CommonParameters>]
说明
当邮箱启用统一消息时,来自 UM 邮箱策略的设置将应用到邮箱中。 为邮箱启用统一消息后,用户可以使用 Microsoft Exchange 中包含的 UM 功能。
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Enable-UMMailbox -Identity tonysmith@contoso.com -UMMailboxPolicy MyUMMailboxPolicy -Extensions 51234 -PIN 5643892 -NotifyEmail administrator@contoso.com -PINExpired $true
本示例为 tonysmith@contoso.com的邮箱启用统一消息,设置当用户登录到 Outlook Voice Access 时必须更改的用户的扩展和 PIN,将 UM 邮箱策略 MyUMMailboxPolicy 分配给用户的邮箱,然后将包含统一消息欢迎信息的电子邮件发送到 administrator@contoso.com。
示例 2
Enable-UMMailbox -Identity tonysmith@contoso.com -UMMailboxPolicy MyUMMailboxPolicy -Extensions 51234 -PIN 5643892 -SIPResourceIdentifier "tonysmith@contoso.com" -PINExpired $true
本示例为 tonysmith@contoso.com启用 SIP 的邮箱启用统一消息,关联 UM 邮箱策略 MyUMMailboxPolicy,并设置在用户登录 Outlook Voice Access 时必须更改的用户的分机号、SIP 资源标识符和 PIN,然后将包含统一消息欢迎信息的电子邮件发送到 tonysmith@contoso.com。
参数
-AutomaticSpeechRecognitionEnabled
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
AutomaticSpeechRecognitionEnabled 参数指定是否要为 UM 邮箱启用自动语音识别 (ASR)。 有效值包含:
- $true:为邮箱启用了 ASR。 此值为默认值。 仅当安装了用户的指定首选语言时,ASR 才可用。
- $false:对邮箱禁用 ASR。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false。 - 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DomainController
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-EnableCloudVoiceMail
适用:Exchange Server 2016
EnableCloudVoiceMail 开关指定是否在 Skype for Business Online 中为 UM 启用邮箱。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CloudVoiceMail
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Extensions
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
Extensions 参数指定用户的分机号。 可以指定一个分机号或一组电话分机号。 用户的分机号对 UM 拨号计划必须是唯一的。
如果不使用此参数,该命令将尝试使用用户的默认电话号码值。 如果您使用会话初始协议 (SIP) 统一资源标识符 (URI) 或 E.164 拨号计划,您还需要使用 SIPResourceIdentifier 参数。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Identity
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
Identity 参数指定您想要启用统一消息的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如:
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
参数属性
| 类型: | MailboxIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-IgnoreDefaultScope
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
IgnoreDefaultScope 开关指示命令忽略 Exchange PowerShell 会话的默认收件人范围设置,并将整个林用作范围。 不必为此开关指定值。
此开关使命令能够访问当前在默认范围中不可用的 Active Directory 对象,但也引入了以下限制:
- 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
- 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-NotifyEmail
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
NotifyEmail 参数指定发送统一消息欢迎邮件的电子邮件地址。 默认情况下,该邮件会被发送至用户的 SMTP 电子邮件地址。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PilotNumber
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
PilotNumber 参数指定用户可以拨打以访问其邮箱的订阅者访问号码。 该默认值是 UM 拨号计划上指定的订阅者访问号码。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PIN
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
PIN 参数指定用于 UM 邮箱的初始 PIN 值。 系统将对照 UM 邮箱策略规则检查该 PIN。 该 PIN 值必须是 4 到 24 之间的数字字符。
如果不使用此参数,则将系统生成的 PIN 发送至用户。 默认情况下,由系统生成的 PIN 包含 6 个数字字符。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PINExpired
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
PINExpired 参数指定是否将 PIN 视为已过期。 如果不提供 PIN,则 PIN 将被视为过期,并且用户下一次登录时系统会提示他们重置其 PIN。
- $true:用户下次登录时需要重置其 PIN。
- $false:用户下次登录时不需要重置其 PIN。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SendWelcomeMail
适用:Exchange Server 2016
SendWelcomeMail 参数指定是否要在邮箱启用 UM 后发送欢迎消息。 有效值包含:
- $true:发送欢迎使用 UM 消息。
- $false:不要发送欢迎使用 UM 消息。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CloudVoiceMail
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SIPResourceIdentifier
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
SIPResourceIdentifier 参数指定用户的 SIP 地址或 E.164 地址。 此属性将与在 UM 拨号计划上定义的 URI 类型进行比较。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-UMMailboxPolicy
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
UMMailboxPolicy 参数指定您想要与邮箱关联的 UM 邮箱策略。 可以使用任何能够唯一标识该策略的值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
参数属性
| 类型: | MailboxPolicyIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CloudVoiceMail
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ValidateOnly
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
ValidateOnly 开关指定是在不进行更改的情况下评估命令的潜在成功还是失败。 不必为此开关指定值。
如果你使用的是 ValidateOnly 开关,则不会有任何变化。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:2010 Exchange Server、Exchange Server 2013、Exchange Server 2016
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。