Set-CsLocationPolicy
上一次修改主题: 2012-03-26
修改现有的位置策略。
语法
Set-CsLocationPolicy [-Identity <XdsIdentity>] [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]
Set-CsLocationPolicy [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]
详细说明
位置策略用于应用与增强型 9-1-1 (E9-1-1) 功能和客户端位置有关的设置。位置策略可确定用户是否启用了 E9-1-1,以及在启用了该服务时紧急呼叫的行为。例如,您可以使用位置策略定义哪些数字构成紧急呼叫(在美国为 911)、是否应自动通知企业安全人员以及应如何路由该呼叫。此 cmdlet 可修改现有的位置策略。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsLocationPolicy cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLocationPolicy"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的位置策略的唯一标识符。要修改全局位置策略,请使用 Global 值。对于在 site 作用域创建的策略,该值的格式为 site:<site name>,其中 site name 是在 Microsoft Lync Server 2010 部署中定义的站点的名称(例如 site:Redmond)。对于在每用户作用域创建的策略,该值就是策略的名称,例如 Reno。 |
Instance |
可选 |
LocationPolicy |
对位置策略对象的引用。此对象的类型必须为 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy,可通过调用 Get-CsLocationPolicy 进行检索。请检索此对象,更改内存中的属性,然后将对象引用作为值传递给此参数以更新该位置策略。 |
ConferenceMode |
可选 |
ConferenceModeEnum |
如果为 ConferenceUri 参数指定了值,则 ConferenceMode 参数将确定第三方是可以参与呼叫还是只能接听呼叫。可用值为: - oneway:第三方只能接听呼叫者与公共安全应答点 (PSAP) 接线员之间的对话。 - twoway:第三方可以接听并参与呼叫者与 PSAP 接线员之间的呼叫。 |
ConferenceUri |
可选 |
字符串 |
将作为与会者加入发出的任何紧急呼叫的第三方的 SIP 统一资源标识符 (URI)(在这种情况下为电话号码)。例如,发出紧急呼叫时,公司安全办公室可以收到呼叫,并且可以接听或参与该呼叫(具体取决于 ConferenceMode 属性的值)。 该字符串的长度必须为 1 到 256 个字符,并且必须以前缀 sip: 开头。 |
Description |
可选 |
字符串 |
此位置的详细描述。例如,“Building 30, 3rd Floor, NorthEast corner”。 |
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 客户端将在注册时检索位置信息并在进行紧急呼叫时包含该信息。 |
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) 用法,用于确定将使用哪个语音路由来路由使用此配置文件的客户端发出的 911 呼叫。与此用法关联的路由应指向专用于紧急呼叫的 SIP 中继。 此用法必须已存在于 PSTN 用法的全局列表中。调用 Get-CsPstnUsage cmdlet 可检索用法列表。要创建新用法,请调用 Set-CsPstnUsage cmdlet。 |
UseLocationForE911Only |
可选 |
布尔值 |
Microsoft Lync 2010 客户端可能会由于各种原因(例如,通知队友当前位置)而使用位置信息。将该值设置为 True 可确保位置信息只能用于紧急呼叫。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 对象。接受通过管道传递的位置策略对象的输入。
返回类型
此 cmdlet 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True
此命令使用 Set-CsLocationPolicy cmdlet 修改 Identity 为 site:Redmond 的位置策略。(也就是说,此命令会修改应用于 Redmond 站点的位置策略。)在该示例中,此命令将 EnhancedEmergencyServicesEnabled 属性的值设置为 True,从而可为连接到(该示例中)Redmond 站点的所有用户启用 E9-1-1 功能。
-------------------------- 示例 2 --------------------------
Get-CsLocationPolicy | Where-Object {$_.ConferenceUri -ne $null} | Set-CsLocationPolicy -ConferenceMode twoway
示例 2 修改组织中使用的定义了会议 URI 的所有位置策略,以将会议模式设置为 twoway。为了执行此任务,该命令首先使用 Get-CsLocationPolicy 返回当前定义的所有位置策略的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,以将其范围缩减到只包含 ConferenceUri 属性不为空(不等于 Null)的位置策略。这样,将会生成具有 ConferenceUri 值的位置策略集合。接下来,将该集合通过管道传递到 Set-CsLocationPolicy,后者随后会通过将集合中每个策略的 ConferenceMode 属性的值设置为 twoway 来修改该值。