Grant-CsMobilityPolicy

 

上一次修改主题: 2012-04-23

向一个或一组用户授予每用户移动策略。移动策略确定用户是否可使用 Microsoft Lync 2010 Mobile。这些策略还管理用户使用通过工号拨号的能力,这是一种使用户能够使用其工作电话号码而不是其移动电话号码在其移动电话上发起和接收电话呼叫的功能。

语法

Grant-CsMobilityPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

详细说明

Lync 2010 Mobile 是一个客户端应用程序,它支持用户在其移动电话上运行 Microsoft Lync 2010。凭借通过工号拨号功能,用户可以从其移动电话发起呼叫,并使其看起来像是来自工作电话号码而不是其移动电话号码的呼叫。已启用通过工号拨号功能的用户可通过直接从移动电话中拨号或使用电话拨出式会议选项来实现此效果。通过电话拨出式会议,用户实际上是要求 Microsoft Lync Server 2010 移动服务服务器替他们发起呼叫。服务器将设置呼叫,然后在用户的移动电话上回拨用户。用户应答后,服务器将拨打被叫方的号码。

这两项功能(运行 Lync Mobile 的功能和使用通过工号拨号的功能)都使用移动策略进行管理。安装 Microsoft Lync Server 2010 后,您将具有一个适用于所有用户的全局移动策略。但是,管理员可以使用 New-CsMobilityPolicy cmdlet 在 site 作用域或每用户作用域创建自定义策略。

如果在 site 作用域创建新策略,该策略将自动分配给相应的站点。但是,如果在每用户作用域创建移动策略,该策略虽然存在,但不会自动分配给任何用户。您必须使用 Grant-CsMobilityPolicy cmdlet 明确将每用户策略分配给一个或多个用户。

注意,运行 Get-CsUser cmdlet 时,默认情况下不会显示移动策略。所以,运行与下面类似的命令时,您不会看到分配给用户的每用户移动策略:

Get-CsUser "Ken Myer"

您需要使用与下面类似的命令才能看到用户的所有属性值(包括移动策略):

Get-CsUser "Ken Myer" | Select-Object *

此外,您还可以使用与下面类似的命令只查看用户的显示名称和移动策略:

Get-CsUser "Ken Myer" | Select-Object DisplayName, MobilityPolicy

谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Grant-CsMobilityPolicy cmdlet:RTCUniversalServerAdmins。

参数

参数 必需 类型 描述

Identity

必需

用户 ID 参数

指示要为其分配每用户移动策略的用户帐户的标识。通常采用以下四种格式之一指定用户标识:1) 用户的 SIP 地址;2) 用户的用户主体名称 (UPN);3) 用户的域名和登录名,格式为“域名\登录名”(例如 litwareinc\kenmyer);以及 4) 用户的 Active Directory 显示名称(例如 Ken Myer)。还可以使用用户的 Active Directory 可分辨名称指定用户标识。

此外,在使用显示名称作为用户标识时,还可以使用星号 (*) 通配符。例如,标识“* Smith”会将策略分配给显示名称以字符串值“Smith”结尾的所有用户。

PolicyName

可选

字符串

要分配的策略的“名称”。PolicyName 就是策略标识去除策略作用域(“tag:”前缀)后所得的结果。例如,Identity 为 tag:Redmond 的策略的 PolicyName 为 Redmond;Identity 为 tag:RedmondUsersMobilityPolicy 的策略的 PolicyName 为 RedmondUsersMobilityPolicy。若要分配每用户策略,请使用与下面类似的语法:

-PolicyName RedmondUsersMobilityPolicy

若要取消分配以前分配给用户的每用户策略,请将 PolicyName 设置为空值 ($Null):

-PolicyName $Null

DomainController

可选

完全限定域名

用于在分配新策略时指定要联系的域控制器的完全限定域名 (FQDN)。如果不指定此参数,则 Grant-CsMobilityPolicy 将联系第一个可用的域控制器。

PassThru

可选

开关参数

使您可以通过管道传递用户对象,该用户对象表示要分配策略的用户。默认情况下,Grant-CsMobilityPolicy cmdlet 不通过管道传递对象。

WhatIf

可选

开关参数

描述如果执行命令会发生什么情况(无需实际执行命令)。

Confirm

可选

开关参数

在执行命令之前提示您进行确认。

输入类型

Grant-CsMobilityPolicy 接受通过管道传递的字符串值的输入,该值代表用户帐户的标识。该 cmdlet 还接受通过管道传递的用户对象的输入。

返回类型

默认情况下,Grant-CsMobilityPolicy 不返回任何对象或值。但是,如果加入 PassThru 参数,则该 cmdlet 将能够通过管道传递 Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact 对象的实例。

示例

-------------------------- 示例 1 --------------------------

Grant-CsMobilityPolicy -Identity "Ken Myer" -PolicyName "RedmondMobilityPolicy"

示例 1 中显示的命令将每用户移动策略 RedmondMobilityPolicy 分配给单个用户:Ken Myer。

-------------------------- 示例 2 --------------------------

Get-CsUser -Filter {MobilityPolicy -eq "NorthAmericaMobilityPolicy"} | Grant-CsMobilityPolicy -PolicyName "RedmondMobilityPolicy"

在示例 2 中,移动策略 RedmondMobilityPolicy 分配给当前由策略 NorthAmericaMobilityPolicy 管理的用户。为此,该命令首先使用 Get-CsUser cmdlet 和 Filter 参数检索分配有策略 NorthAmericaMobilityPolicy 的所有用户;这是使用筛选器值 {MobilityPolicy –eq "NorthAmericaMobilityPolicy"} 实现的。检索用户帐户的集合后,将这些帐户通过管道传递到 Grant-CsMobilityPolicy cmdlet,后者向每个用户分配策略 RedmondMobilityPolicy。

-------------------------- 示例 3 --------------------------

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsMobilityPolicy -PolicyName "RedmondMobilityPolicy"

上述命令将移动策略 RedmondMobilityPolicy 分配给位于 Redmond 市的所有用户。为执行此任务,该命令首先带 LdapFilter 参数调用 Get-CsUser;筛选器值“l=Redmond”返回位于 Redmond 的所有用户。(“l”表示 Active Directory 属性“locality”。)检索用户帐户后,将这些帐户通过管道传递到 Grant-CsMobilityPolicy;然后,Grant-CsMobilityPolicy 向每个用户分配策略 RedmondMobilityPolicy。

-------------------------- 示例 4 --------------------------

Get-CsUser -Filter {RegistrarPool -eq "atl-cs-001.litwareinc.com"} | Grant-CsMobilityPolicy -PolicyName "RedmondMobilityPolicy"

在示例 4 中,将 RedmondMobilityPolicy 分配给拥有在 atl-cs-001.litwareinc.com 上驻留的 Lync Server 帐户的用户。为此,该命令首先使用 Get-CsUser cmdlet 和 Filter 参数检索在指定注册器池上驻留的所有用户帐户;这可使用筛选器值 {RegistrarPool –eq "atl-cs-001.litwareinc.com"} 实现。检索用户帐户的集合后,将这些帐户通过管道传递到 Grant-CsMobilityPolicy cmdlet,后者向每个用户分配策略 RedmondMobilityPolicy。