Remove-CsLocationPolicy
上一次修改主题： 2012-03-27
删除指定的位置策略。（将位置策略与增强型 911 服务结合使用，以便使应答 911 呼叫的人员能够基于电话或呼叫设备的电话号码来确定呼叫者的地理位置。）
语法
Remove-CsLocationPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
可以使用位置策略来应用与 E9-1-1 功能相关的设置。位置策略可确定用户是否启用了 E9-1-1，以及在启用了该服务时紧急呼叫的行为。例如，您可以使用位置策略定义哪些数字构成紧急呼叫（在美国为 911）、是否应自动通知企业安全人员以及应如何路由该呼叫。此 cmdlet 可删除现有的位置策略。
除了删除站点和每用户位置策略以外，此 cmdlet 还可用于删除全局位置策略。但在这种情况下，不会实际删除策略，而只是将策略设置重置为默认值。
如果针对分配给用户的每用户位置策略运行此 cmdlet，则系统将提示您确认删除。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsLocationPolicy cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsLocationPolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的位置策略的唯一标识符。要删除全局位置策略（只将策略重置为其默认值），请使用值 Global。对于在 site 作用域创建的策略，该值的格式为 site:<site name>，其中 site name 是在 Microsoft Lync Server 2010 部署中定义的站点的名称（例如 site:Redmond）。对于在每用户作用域创建的策略，该值只是策略的名称，如 Bldg30Floor3Sector1。 |
Force |
可选 |
开关参数 |
指定此参数时将略过所有确认提示，并且在没有任何警告通知的情况下将进行删除。例如，如果将每用户位置策略分配给一个或多个用户，则在命令中未包含此参数的情况下，删除前会显示确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 对象。接受通过管道传递的位置策略对象的输入。
返回类型
此 cmdlet 不返回值或对象。此 cmdlet 会删除 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsLocationPolicy -Identity Reno
示例 1 中显示的命令使用 Remove-CsLocationPolicy 删除 Identity 为 Reno 的位置策略。删除每用户策略后，分配了该策略的用户或组将自动使用为其站点所配置的策略。如果没有为其站点配置任何策略，则这些用户和组将使用全局位置策略。
-------------------------- 示例 2 --------------------------
Get-CsLocationPolicy | Where-Object {$_.EnhancedEmergencyServicesEnabled -eq $false} | Remove-CsLocationPolicy
示例 2 将删除 EnhancedEmergencyServicesEnabled 属性为 False 的所有位置策略。（换句话说，它删除了所有未启用 E9-1-1 的位置策略。）要执行此操作，命令首先使用 Get-CsLocationPolicy 检索组织中当前使用的所有位置策略。然后，将此集合通过管道传递到 Where-Object cmdlet；后者会应用筛选器，将检索的数据限制为 EnhancedEmergencyServicesEnabled 属性为 (-eq) False ($False) 的策略。最终，将此筛选出的集合传递到 Remove-CsLocationPolicy，后者将继续删除集合中的每个策略。