Grant-CsLocationPolicy
上一次修改主题： 2012-03-23
将增强型 9-1-1 (E9-1-1) 位置策略分配给各个用户或组。E9-1-1 服务使接听 911 呼叫的人员可以确定呼叫者的地理位置。
语法
Grant-CsLocationPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
位置策略用于应用与 E9-1-1 功能相关的设置。位置策略可确定用户是否启用了 E9-1-1，以及在启用了该服务时紧急呼叫的行为。例如，您可以使用位置策略定义哪些数字构成紧急呼叫（在美国为 911）、是否应自动通知企业安全人员以及应如何路由该呼叫。此 cmdlet 可向特定的用户或组授予位置策略。
重要说明：在作用域顺序方面，位置策略与 Microsoft Lync Server 2010 中的其他策略的行为方式有所不同。对于所有其他策略，如果策略是在每用户作用域定义的，则此策略将应用于任何已授予该策略的用户。如果没有为用户授予每用户策略，则将应用站点策略。如果没有站点策略，将应用全局策略。位置策略的应用方式与此相同，但有一种例外情况：每用户位置策略也可以分配给网络站点。（网络站点由一组子网组成。）如果用户从映射到组织内的网络站点的位置发出紧急呼叫，则将使用分配给该网络站点的用户级别策略。此功能将覆盖已授予该用户的每用户策略。如果用户在组织中的某个未知或未映射的位置进行呼叫，将应用标准策略作用域。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Grant-CsLocationPolicy cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsLocationPolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
UserIdParameter |
指示应向其分配策略的用户帐户的标识。可以采用下列四种格式之一来指定用户标识：1) 用户的 SIP 地址；2) 用户的用户主体名称 (UPN)；3) 用户的域名和登录名，格式为“域名\登录名”（如 litwareinc\kenmyer）；以及 4) 用户的 Active Directory 显示名称（例如 Ken Myer）。请注意，SAMAccountName 不能用作标识。 此外，在使用显示名称作为用户标识时，还可以使用通配符星号 (*)。例如，Identity "* Smith" 将向姓为 Smith 的所有用户授予策略。 |
DomainController |
可选 |
Fqdn |
用于指定域控制器。如果未指定域控制器，将使用第一个可用的域控制器。 |
PassThru |
可选 |
开关参数 |
包含此参数（不带任何值）将在该 cmdlet 完成时显示用户信息。通常情况下，运行此 cmdlet 时没有输出。 |
PolicyName |
可选 |
字符串 |
要应用于用户的位置策略的 Identity。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
字符串。接受通过管道传递的代表已向其授予位置策略的用户帐户 Identity 的字符串值。
返回类型
与 PassThru 参数一起使用时，将返回一个类型为 Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact 的对象。
示例
-------------------------- 示例 1 --------------------------
Grant-CsLocationPolicy -Identity "Ken Myer" -PolicyName Reno
在示例 1 中，使用 Grant-CsLocationPolicy 向用户 Ken Myer 分配 Reno 位置策略。
-------------------------- 示例 2 --------------------------
Get-CsUser -LDAPFilter "Department=Accounting" | Grant-CsLocationPolicy -PolicyName AccountingArea
在示例 2 中，向 Accounting 部门的所有用户分配 AccountingArea 策略。为返回 Accounting 部门中所有用户的集合，使用了带有 LDAPFilter 参数的 Get-CsUser cmdlet。传递给 LDAPFilter 的查询值“Department=Accounting”可返回 Active Directory Department 设置为 Accounting 的所有用户。然后，将该集合传递到 Grant-CsLocationPolicy，后者将继续为集合中的每个用户分配 AccountingArea 策略。
-------------------------- 示例 3 --------------------------
Grant-CsLocationPolicy -Identity "Ken Myer" -PolicyName Reno -PassThru | Select-Object DisplayName, LocationPolicy
此示例向 Identity（在此示例中为显示名称）为 Ken Myer 的用户授予位置策略 Reno。此外，此示例还包含参数 PassThru，这将导致在授予位置策略之后显示 Ken Myer 的用户信息。但并不会立即在控制台上显示用户信息，而是将该信息通过管道传递到 Select-Object cmdlet，后者将只显示用户的 DisplayName 属性和 LocationPolicy 属性。
此示例中需要注意的一点是，新授予的位置策略将显示在 LocationPolicy 下的输出中，但将显示为定位值，而非策略名称。（定位值是在创建策略时自动为其分配的一个数值。）要查看已应用的策略名称，请运行命令 Get-CsUser –Identity "Ken Myer" | Select-Object DisplayName, LocationPolicy。