Set-CsLisServiceProvider
上一次修改主题: 2012-03-27
创建或修改有关增强型 9-1-1 (E9-1-1) 网络路由提供商提供的用于验证位置的 Web 服务的信息。
语法
Set-CsLisServiceProvider -CertFileName <String> -Password <SecureString> -ServiceProviderName <String> -ValidationServiceUrl <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
详细说明
通过 E9-1-1 实现企业语音时,应首先通过 E9-1-1 网络路由提供商路由紧急呼叫,以确保将这些呼叫路由至相应的公共安全应答点 (PSAP)。(PSAP 是美国的一类机构,负责将呼叫定向到最近的匪警、火警和救护车服务单位。)为此,提供商必须拥有组织的位置列表,以便对照主街道地址指南进行匹配以确保所有位置都有效。此 cmdlet 创建或修改有关提供商的信息,其中包括提供商的名称、组织发送位置所使用的 Web 服务的 URL 以及安全 Web 服务的证书和密码。
您不能为一个给定的 E9-1-1 实现定义多个服务提供商。只有在能解析 Web 服务的 URL 和安全信息的情况下,此 cmdlet 才会成功。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsLisServiceProvider cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisServiceProvider"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
CertFileName |
必需 |
字符串 |
证书文件的名称(和完整路径)。此文件的文件扩展名必须为 PFX。 |
Password |
必需 |
安全字符串 |
一个安全字符串,其中包含访问受密码保护的文件中的证书所需的密码。可以使用 ConvertTo-SecureString cmdlet 或带有 AsSecureString 参数的 Read-Host cmdlet 创建安全字符串。 |
ServiceProviderName |
必需 |
字符串 |
E9-1-1 网络路由提供商的名称。 |
ValidationServiceUrl |
必需 |
字符串 |
Web 服务的 URL。此参数必须为安全 URL,以前缀 https:// 开头。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
接受通过管道传递的位置信息服务器 (LIS) 服务提供商对象的输入。
返回类型
此 cmdlet 可创建或修改类型为 System.Management.Automation.PSCustomObject 的对象。
示例
-------------------------- 示例 1 --------------------------
$p = Read-Host -AsSecureString
Set-CsLisServiceProvider -ServiceProviderName E911Provider -ValidationServiceUrl https://www.911contoso.com/validation/ -CertFileName C:\MS-Contoso-Cert.pfx -Password $p
为 E9-1-1 网络路由提供商 Web 服务创建条目所用的必要参数之一是包含用于访问证书文件的密码的安全字符串。因此,此示例中的第一行调用 Windows PowerShell cmdlet Read-Host。Read-Host 将提示用户进行输入。我们指定参数 AsSecureString,这样将在输入时以星号 (*) 的形式显示输入内容。我们已经将此命令的结果分配给变量 $p。结果将是一个安全字符串,该字符串是经过加密的用户输入内容。换句话说,运行此命令将提示用户输入 Web 服务的密码,并将该密码存储在变量 $p 中。
获得密码后,我们便可创建一个对象来访问该 Web 服务。这一点是通过调用 Set-CsLisServiceProvider cmdlet 来实现的。我们需要向此 cmdlet 传递若干参数。首先是提供商的名称,本例中为 E911Provider。然后,我们为 ValidationServiceUrl 提供一个值:https://www.911contoso.com/validation/。请注意,这必须是“安全站点”,其带有前缀 https 而不是 http。接下来,输入用于访问此 Web 服务的证书所在文件的名称,C:\MS-Contoso-Cert.pfx。最后,将变量 $p(包含带有 Web 服务密码的安全字符串)传递给 Password 参数。