Test-CsLocationPolicy
上一次修改主题： 2012-03-26
根据在参数值中指定的标准运行测试，以确定将要使用的位置策略。位置策略包含的设置可确定是否应用增强型 9-1-1 (E9-1-1) 以及应用的方式。E9-1-1 可以帮助 911 紧急呼叫的应答者确定呼叫者的地理位置。
语法
Test-CsLocationPolicy -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-Subnet <String>] [-UserSipAddress <String>]
Test-CsLocationPolicy [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-Subnet <String>]
详细说明
可以使用位置策略来应用与 E9-1-1 功能和客户端位置相关的设置。位置策略可确定用户是否启用了 E9-1-1，以及在启用了该服务时紧急呼叫的行为。例如，您可以使用位置策略定义哪些数字构成紧急呼叫（在美国为 911）、是否应自动通知企业安全人员以及应如何路由该呼叫。此 cmdlet 将返回有关从特定池、子网、交换机或无线访问点的某一客户端发出呼叫时可使用的位置策略的信息。
如果在呼叫 cmdlet 的过程中没有指定用户，则将对当前配置的用户进行测试。要查找当前配置的用户，请调用 Get-CsHealthMonitoringConfiguration。要设置配置的用户，请调用 Set-CsHealthMonitoringConfiguration。
如果找到了用户或子网的位置策略，测试将成功执行。默认情况下，返回的信息中包含位置策略（如果分配了每用户策略）的名称以及是为用户还是子网启用 E9-1-1。包括用于检索其他测试信息的 Windows PowerShell 通用参数 Verbose。
可以测试用户或网络子网的位置策略。如果通过指定 Subnet 参数的值对子网运行测试，则 cmdlet 将尝试解析该子网的位置策略。如果没有位置策略分配到子网，则将检索配置用户的位置策略。如果子网策略检索成功，则输出将包括以 subnet-tagid 开头的 LocationPolicyTagID 值。如果未找到子网的位置策略，则 LocationPolicyTagID 将以 user-tagid 开头。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Test-CsLocationPolicy cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsLocationPolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
TargetFqdn |
必需 |
字符串 |
托管指定用户或子网的池的完全限定域名 (FQDN)（如果没有指定用户，则假定使用预配置的用户或是当前用户）。 |
OutVerboseVariable |
可选 |
字符串 |
存在此参数时，运行该 cmdlet 的详细输出将存储在指定变量中。例如，若要将输出存储在名为 $TestOutput 的变量中，可使用以下语法： -OutVerboseVariable TestOutput 指定变量名称时不要在前面附加 $ 字符。 |
RegistrarPort |
可选 |
整数 |
Registrar 服务的端口号。 |
Subnet |
可选 |
字符串 |
要测试其位置策略的网络子网的 ID（IP 地址）。 |
UserCredential |
可选 |
PS 凭据对象 |
包含正在进行位置策略测试的用户帐户的用户 ID 和密码的对象。通过调用 Windows PowerShell cmdlet Get-Credential、填写正确的信息并将输出保存为变量，可以检索凭据对象。 |
UserSipAddress |
可选 |
SIP 地址 |
要测试其位置策略的用户的 SIP 地址。格式必须是 sip:< 用户 ID >，例如，sip:kenmyer@litwareinc.com。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
输入类型
无。
返回类型
Test-CsLocationPolicy 可返回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com
此示例可确定当前用户（或当前配置用户）的位置策略。TargetFqdn 是必需的参数。
-------------------------- 示例 2 --------------------------
$cred = Get-Credential "litwareinc\kenmyer"
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred -UserSipAddress "sip:kenmyer@litwareinc.com"
示例 2 中的第一行调用 Windows PowerShell Get-Credential cmdlet。此 cmdlet 将检索用户凭据，并将它们作为安全对象返回。为此 cmdlet 提供的唯一参数是用户 ID。运行此 cmdlet 将打开一个要使用所提供用户 ID 预填充的对话框，并且会显示一个文本框，允许您键入用户密码。这些用户凭据保存为变量 $cred。
第 2 行调用 Test-CsLocationPolicy cmdlet。与示例 1 一样，我们提供目标 FQDN。但是，在此示例中我们不使用预配置的用户，而是准备对 SIP 地址为 kenmyer@litwareinc.com 的用户运行测试。我们将该值（sip: 前缀）传递到 UserSipAddress 参数，并将该用户的凭据（保存在 $cred 变量中）传递到 UserCredential 参数。
-------------------------- 示例 3 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com"
此示例与示例 2 类似，但没有指定用户凭据。如果在未指定用户凭据的情况下调用 Test-CsLocationPolicy，将使用运行此 cmdlet 的计算机上的服务器证书来进行身份验证并发现用户的位置策略。如果计算机上没有服务器证书，则必须指定如示例 2 中所示的凭据。要了解计算机上是否有服务器证书，请调用 Get-CsCertificate cmdlet。
-------------------------- 示例 4 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -Subnet 172.15.11.0
此示例可确定子网 ID 为 172.15.11.0 的子网的位置策略。如果该子网不与位置策略关联，则将检索当前配置用户的位置策略。
注意：通过将 Set-CsNetworkSite cmdlet 的 LocationPolicy 参数设置为位置策略 ID，然后将 Set-CsNetworkSubnet cmdlet 的 NetworkSiteId 参数设置为该站点的 ID，可以设置子网的位置策略。例如：
Set-CsNetworkSite Portland –LocationPolicy Reno
Set-CsNetworkSubnet 175.15.11.0 –NetworkSiteID Portland