Grant-CsHostedVoicemailPolicy
上一次修改主题: 2012-03-23
在每用户作用域分配托管语音邮件策略。(每用户作用域使您可以为个别用户或组分配策略。)
语法
Grant-CsHostedVoicemailPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
此 cmdlet 将现有的特定于用户的托管语音邮件策略分配给用户。托管语音邮件策略可指定如何将用户的未应答呼叫路由到托管 Exchange 统一消息 (UM)服务。
您可以通过使用以下格式调用命令来检查是否已经为用户授予每用户托管语音邮件策略:Get-CsUser "<用户名>" | Select-Object HostedVoicemailPolicy。例如:
Get-CsUser "Ken Myer" | Select-Object HostedVoicemailPolicy
如果为用户分配不包括目标的托管语音邮件策略,则无法为该用户启用托管语音邮件。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Grant-CsHostedVoicemailPolicy cmdlet:RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsHostedVoicemailPolicy"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
UserIdParameter |
要为其分配托管语音邮件策略的用户的标识(唯一标识符)。 可以采用下列四种格式之一来指定用户标识:1) 用户的 SIP 地址;2) 用户的用户主体名称 (UPN);3) 用户的域名和登录名,格式为“域名\登录名”(如 litwareinc\kenmyer);以及 4) 用户的 Active Directory 显示名称(例如 Ken Myer)。 请注意,在使用显示名称作为用户标识时,可以使用通配符星号 (*)。例如,标识“* Smith”将返回姓氏为 Smith 的所有用户。 完整数据类型:Microsoft.Rtc.Management.AD.UserIdParameter |
PolicyName |
可选 |
字符串 |
要分配给用户的托管语音邮件策略的名称(标识)。(请注意,这仅包括标识的名称部分。每用户托管语音邮件策略的标识中包括一个 tag: 前缀,该前缀不应包含在 PolicyName 中。) |
DomainController |
可选 |
Fqdn |
用于指定域控制器。如果未指定域控制器,将使用第一个可用的域控制器。 |
PassThru |
可选 |
开关参数 |
返回命令的结果。默认情况下,此 cmdlet 不生成任何输出。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
字符串。接受通过管道传递的字符串值,代表正授予其托管语音邮件策略的用户帐户的标识。
返回类型
与 PassThru 参数一起使用时,将返回一个类型为 Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact 的对象。
示例
-------------------------- 示例 1 --------------------------
Grant-CsHostedVoicemailPolicy -Identity "Ken Myer" -PolicyName ExRedmond
此示例将 Identity 为 ExRedmond 的托管语音邮件策略分配给显示名称为 Ken Myer 的用户。
-------------------------- 示例 2 --------------------------
Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com" | Grant-CsHostedVoicemailPolicy -PolicyName ExRedmond
此示例向 Finance 组织单位 (OU) 中的所有用户分配 Identity 为 ExRedmond 的托管语音邮件策略:OU=Finance,OU=NorthAmerica,DC=litwareinc,DC=com。此命令的第一部分调用 Get-CsUser cmdlet,从指定的 OU 检索已启用 Lync Server 2010 或 Office Communications Server 的所有用户。然后将此用户集合通过管道传递到 Grant-CsHostedVoicemailPolicy cmdlet,后者将策略 ExRedmond 分配给这些用户中的每一个用户。