Grant-CsDialPlan
上一次修改主题: 2012-03-23
向一个或多个用户或组分配拨号计划。
语法
Grant-CsDialPlan -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
此 cmdlet 将现有的用户特定拨号计划分配给用户。拨号计划提供了企业语音用户进行电话呼叫时所需的信息。没有有效拨号计划的用户将无法使用企业语音进行呼叫。拨号计划可确定如何应用规范化规则,以及在进行外部呼叫时是否必须拨打前缀号码等内容。
您可以通过按以下格式调用命令来检查是否已为用户授予每用户拨号计划:Get-CsUser "<用户名>" | Select-Object DialPlan。例如:
Get-CsUser "Ken Myer" | Select-Object DialPlan
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Grant-CsDialPlan cmdlet:RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsDialPlan"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
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 |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
字符串。接受通过管道传递的代表已向其授予拨号计划的用户帐户 Identity 的字符串值。
返回类型
与 PassThru 参数一起使用时,将返回一个类型为 Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact 的对象。
示例
-------------------------- 示例 1 --------------------------
Grant-CsDialPlan -Identity "Ken Myer" -PolicyName RedmondDialPlan
在上面显示的示例中,使用 Grant-CsDialPlan 将拨号计划 RedmondDialPlan 分配给 Identity(本示例中为显示名称)为 Ken Myer 的用户。
-------------------------- 示例 2 --------------------------
Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsDialPlan -PolicyName RedmondDialPlan
在示例 2 中,将为办公室位于 Redmond 市的所有用户分配 RedmondDialPlan 拨号计划。为此,调用了 Get-CsUser cmdlet 以便检索办公室位于 Redmond 市的所有用户的集合;这是通过使用 LDAPFilter 参数和 LDAP 查询 l=Redmond 实现的。(在 Active Directory 域服务 (AD DS) 所使用的 LDAP 查询语言中,l 表示用户所在的县或市。)然后,将该集合通过管道传递到 Grant-CsDialPlan,后者会为集合中的每个用户分配 Redmond 拨号计划。