New-CsLocationPolicy
上一次修改主题： 2012-03-26
创建新的位置策略以便与增强型 9-1-1 (E9-1-1) 服务和一般客户端位置的位置标识配合使用。E9-1-1 服务使接听 911 呼叫的人员可以确定呼叫者的地理位置。
语法
New-CsLocationPolicy -Identity <XdsIdentity> [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]
详细说明
位置策略用于将与 E9-1-1 功能有关的设置和位置设置应用于用户或联系人。位置策略可确定用户是否启用了 E9-1-1，以及在启用了该服务时紧急呼叫的行为。例如，您可以使用位置策略定义哪些数字构成紧急呼叫（在美国为 911）、是否应自动通知企业安全人员以及应如何路由该呼叫。此 cmdlet 可在 site 作用域或每用户作用域创建新的位置策略。（global 作用域的策略已存在。）
重要说明：在作用域顺序方面，位置策略与 Lync Server 2010 中的其他策略的行为方式有所不同。对于所有其他策略，如果策略是在每用户作用域定义的，则此策略将应用于任何已授予该策略的用户。如果没有为用户授予每用户策略，则将应用站点策略。如果没有站点策略，将应用全局策略。位置策略的应用方式与此相同，但有一种例外情况：每用户位置策略也可以分配给网络站点。（网络站点由一组子网组成。）如果用户从映射到组织内的网络站点的位置发出紧急呼叫，则将使用分配给该网络站点的用户级别策略。此功能将覆盖已授予该用户的每用户策略。如果用户在组织中的某个未知或未映射的位置进行呼叫，将应用标准策略作用域。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsLocationPolicy cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsLocationPolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
位置策略的唯一标识符。此 cmdlet 可用于在 site 作用域或每用户作用域创建策略。（默认情况下，存在全局策略，并且无法将其删除。）对于在 site 作用域创建的策略，该值的格式必须为 site:<site name>，其中 site name 是在 Microsoft Lync Server 2010 部署中定义的站点的名称。例如，site:Redmond。可以为在每用户作用域创建的策略分配任何字符串值，如 Reno。 |
ConferenceMode |
可选 |
ConferenceModeEnum |
如果为 ConferenceUri 参数指定了值，则 ConferenceMode 参数将确定第三方是可以参与呼叫还是只能接听呼叫。可用值为： - oneway：第三方只能接听呼叫者与公共安全应答点 (PSAP) 接线员之间的对话。 - twoway：第三方可以接听并参与呼叫者与 PSAP 接线员之间的呼叫。 |
ConferenceUri |
可选 |
字符串 |
将作为与会者加入发出的任何紧急呼叫的第三方的 SIP 统一资源标识符 (URI)（在这种情况下为电话号码）。例如，发出紧急呼叫时，公司安全办公室可以收到呼叫，并且可以接听或参与该呼叫（具体取决于 ConferenceMode 属性的值）。 该字符串的长度必须为 1 到 256 个字符，并且必须以前缀 sip: 开头。 |
Description |
可选 |
字符串 |
此位置的详细描述。例如，“Reno corporate users”。 |
EmergencyDialMask |
可选 |
字符串 |
所拨打的一个将转换为 EmergencyDialString 属性值的号码。例如，如果 EmergencyDialMask 的值为“212”，EmergencyDialString 的值为“911”，那么用户拨打 212 时，将呼叫 911。这样就允许拨打备用紧急号码，并且仍可以接通紧急服务（例如，来自使用不同紧急号码的国家/地区的人员可以尝试拨打该国家/地区的号码，而不是拨打其当前所在国家/地区的号码）。您可以通过使用分号分隔值来定义多个紧急拨号掩码。例如，-EmergencyDialMask "212;414"。 重要说明：请确保指定的拨号掩码值与呼叫驻留通道范围内的号码不同。呼叫驻留路由将优先于紧急呼叫字符串转换。要查看现有的呼叫驻留通道范围，请调用 Get-CsCallParkOrbit cmdlet。 该字符串的最大长度为 100 个字符。每个字符都必须为 0 到 9 的数字。 |
EmergencyDialString |
可选 |
字符串 |
要获得紧急服务时所拨打的号码。在美国，该值为“911”。 该字符串必须由 0 到 9 的数字组成，其长度可以为 1 至 10 位数字。 |
EnhancedEmergencyServicesEnabled |
必需 |
布尔值 |
指定与此策略关联的用户是否启用了 E9-1-1。将值设置为 True 可启用 E9-1-1，因此 Lync Server 2010 客户端将在注册时检索位置信息并在进行紧急呼叫时包含该信息。 默认值：False |
LocationRequired |
可选 |
LocationRequiredEnum |
如果客户端无法从位置配置数据库中检索位置，可以提示用户手动输入位置。此参数接受下列值： - no：将不提示用户输入位置。发出呼叫而未包含位置信息时，紧急服务提供商将应答该呼叫并询问位置。 - yes：客户端在新位置注册时，将提示用户输入位置信息。用户可以消除提示，而不输入任何信息。如果输入了信息，呼叫 911 时将首先由紧急服务提供商应答以确认位置，然后再将该呼叫路由到 PSAP 接线员（911 接线员）。 - disclaimer：除用户消除提示的情况外，此选项与 yes 相同。还将向用户显示免责声明文本，提醒用户拒绝输入位置信息的后果。（免责声明文本必须通过调用 Set-CsEnhancedEmergencyServiceDisclaimer cmdlet 进行设置。） 如果 EnhancedEmergencyServicesEnabled 设置为 False（默认值），将忽略该值。此时不会提示用户输入位置信息。 |
NotificationUri |
可选 |
字符串 |
发出紧急呼叫时将通知的一个或多个 SIP URI。例如，只要发出紧急呼叫，就会通过即时消息通知公司安全办公室。如果提供了呼叫者的位置，将在通知中包含该位置。 可以使用以逗号分隔的列表包含多个 SIP URI。例如，-NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com。请记住，不支持通讯组列表和组 URI。 该字符串的长度必须为 1 到 256 个字符，并且必须以前缀 sip: 开头。 |
PstnUsage |
可选 |
字符串 |
公用电话交换网 (PSTN) 用法，用于确定将使用哪个语音路由来路由使用此配置文件的客户端发出的紧急呼叫。与此用法关联的路由应指向专用于紧急呼叫的 SIP 中继。 此用法必须已存在于 PSTN 用法的全局列表中。调用 Get-CsPstnUsage cmdlet 可检索用法列表。要创建新用法，请调用 Set-CsPstnUsage cmdlet。 |
UseLocationForE911Only |
可选 |
布尔值 |
Microsoft Lync 2010 客户端可能会由于各种原因（例如，通知队友当前位置）而使用位置信息。将该值设置为 True 可确保位置信息只能用于紧急呼叫。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True
示例 1 使用 New-CsLocationPolicy 为 Redmond 站点创建一个新位置策略，后者可为该站点中的所有用户启用 E9-1-1。为了创建此策略，调用了带有两个参数的 New-CsLocationPolicy：一个用于设置 Identity，在此示例中为字符串 site:，后跟将应用此策略的站点的名称；另一个用于将 EnhancedEmergencyServicesEnabled 属性的值设置为 True。
-------------------------- 示例 2 --------------------------
New-CsLocationPolicy -Identity Reno -Description "All users located at the Reno site" -EnhancedEmergencyServicesEnabled $True -PstnUsage Emergency -EmergencyDialString 911
此示例创建一个每用户位置策略。（必须将每用户策略明确授予单个用户或组。）该策略的 Identity 为 Reno。我们已使用 Description 参数添加了有关该策略的详细描述。所提供的下一个参数是 EnhancedEmergencyServicesEnabled，它被设置为 True，以便对授予了此策略的所有用户启用 E9-1-1 功能。下一个参数是 PstnUsage，在此示例中它的值为 Emergency。该值必须与 PSTN 用法列表中的某个值匹配。（可以调用 Get-CsPstnUsage 来检索该列表。）用法应与将用于紧急呼叫的语音路由相关联。（可以调用 Get-CsVoiceRoute cmdlet 来检索语音路由。）此示例中使用的最后一个参数是 EmergencyDialString，它指定所拨打的用于紧急呼叫的号码。