Set-CsHostedVoicemailPolicy
上一次修改主题: 2012-03-26
修改托管语音邮件策略。
语法
Set-CsHostedVoicemailPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Destination <String>] [-Force <SwitchParameter>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
Set-CsHostedVoicemailPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Destination <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
详细说明
此 cmdlet 可修改用于将启用 Microsoft Lync Server 2010 或 Microsoft Office Communications Server 的用户帐户配置为使用 Exchange 统一消息 (UM) 托管语音邮件服务的策略。此策略确定了如何将用户的未应答呼叫路由到托管 Exchange UM 服务。
只有为用户启用了 Exchange UM 托管语音邮件,此策略才能生效。可以调用 Get-CsUser cmdlet 并检查 HostedVoiceMail 属性以确定是否为用户启用了托管语音邮件。(值为 True 表示已为用户启用。)
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsHostedVoicemailPolicy cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsHostedVoicemailPolicy"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
字符串 |
要修改的托管语音邮件策略的唯一标识符。此标识符包括作用域(适用于全局策略)、作用域和站点(适用于站点策略,例如 site:Redmond)或策略名称(适用于每用户策略,例如 HVUserPolicy)。 |
Instance |
可选 |
托管语音邮件策略 |
允许您将对对象的引用传递到 cmdlet,而不是设置单个参数值。 此对象的类型必须是托管语音邮件策略,并可以通过调用 Get-CsHostedVoicemailPolicy cmdlet 对其进行检索。 |
Description |
可选 |
字符串 |
策略的易懂描述。 |
Destination |
可选 |
字符串 |
分配给此参数的值是托管 Exchange UM 服务的完全限定域名 (FQDN)。 如果尝试为用户启用托管语音邮件,而用户的已分配策略没有目标值,则启用将失败。 此值的长度不能超过 255 个字符,格式必须符合正则表达式字符串 ^[a-zA-Z0-9\-_]+(\.[a-zA-Z0-9\-_]+){0,}$。这只意味着此值应采用 FQDN 的形式,例如 server.litwareinc.com。 |
Organization |
可选 |
字符串 |
此参数包含以逗号分隔的由 Lync Server 2010 用户组成的 Exchange 租户列表。必须将每个租户指定为托管 Exchange 服务上租户的 FQDN。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy 对象。接受通过管道传递的托管语音邮件策略对象的输入。
返回类型
此 cmdlet 可修改一个类型为 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy 的对象
示例
-------------------------- 示例 1 --------------------------
Set-CsHostedVoicemailPolicy -Identity ExRedmond -Destination ExUM.contoso.com
此命令修改名为 ExRedmond 的托管语音邮件策略的 Destination 属性。此命令将此策略的 Exchange UM 目标设置为 FQDN ExUM.contoso.com。
-------------------------- 示例 2 --------------------------
$a = (Get-CsHostedVoicemailPolicy -Identity ExRedmond).Organization
$a += ",corp3.litwareinc.com"
Set-CsHostedVoicemailPolicy -Identity ExRedmond -Organization $a
此命令向 ExRedmond 策略的以逗号分隔的租户(组织)列表中添加一个 Exchange 租户。第一行调用 Get-CsHostedVoicemailPolicy,以检索 Identity 为 ExRedmond 的策略。由于需要先检索此策略,因此将此 cmdlet 调用括在括号中。然后使用“点标记”检索策略的 Organization 属性。将返回的字符串保存在变量 $a 中。下一行使用 += 运算符将分配的字符串 (,corp3.litwareinc.com) 附加至变量 $a 中存储的字符串后面。(注意分配的字符串中的逗号。Organization 是一个以逗号分隔的列表,因此如果该列表中已经包含值,则需要在任何添加的值前面加上逗号。)最后,在最后一行中,调用 Set-CsHostedVoicemailPolicy,并通过将变量 $a 传递给参数 Organization 来分配新的 Organization 字符串。