Set-CsLisServiceProvider
Última modificación del tema: 2012-03-27
Crea o modifica la información sobre el servicio web que brinda el proveedor de enrutamiento de red 9-1-1 mejorado (E9-1-1) para comprobar las ubicaciones.
Sintaxis
Set-CsLisServiceProvider -CertFileName <String> -Password <SecureString> -ServiceProviderName <String> -ValidationServiceUrl <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descripción detallada
En una implementación de Enterprise Voice con E9-1-1, las llamadas de emergencia primero deben enrutarse por medio de un proveedor de enrutamiento de redes de E9-1-1, a fin de garantizar que las llamadas se desvíen al PSAP adecuado (Public-Safety Answering Point). (Un PSAP es la agencia en los Estados Unidos que dirige las llamadas a los servicios de emergencia más cercanos, como los servicios de la policía, los bomberos y la ambulancia). Para ello, el proveedor debe disponer de una lista de ubicaciones de la organización para poder establecer comparaciones con la guía de direcciones principal (MSAG) a fin de garantizar que todas las ubicaciones sean válidas. Este cmdlet crea o modifica información sobre un proveedor, incluido el nombre del proveedor, una dirección URL para el servicio web que usará la organización para enviar las ubicaciones, y un certificado y una contraseña para el servicio web seguro.
No puede definir más de un proveedor de servicios para una implementación E9-1-1 determinada. Este cmdlet no se realizará correctamente a menos que pueda resolver la URL y la información de seguridad para el servicio web.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsLisServiceProvider localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisServiceProvider"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
CertFileName |
Requerido |
Cadena de caracteres |
El nombre (y la ruta completa) del archivo del certificado. Este archivo debe tener una extensión de archivo PFX. |
Password |
Requerido |
SecureString |
Una cadena segura que contenga la contraseña necesaria para obtener acceso al certificado en el archivo protegido con contraseña. Las cadenas seguras pueden crearse por medio del cmdlet ConvertTo-SecureString o el cmdlet Read-Host con el parámetro AsSecureString. |
ServiceProviderName |
Requerido |
Cadena de caracteres |
El nombre del proveedor de enrutamiento de la red E9-1-1. |
ValidationServiceUrl |
Requerido |
Cadena de caracteres |
La URL del servicio web. Esta debe ser una URL segura, que comience con el prefijo https://. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Acepta entradas canalizadas de objetos de proveedores de servicios del servidor de información de ubicación (LIS).
Tipos de valores devueltos
Este cmdlet crea o modifica un objeto de tipo System.Management.Automation.PSCustomObject.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
$p = Read-Host -AsSecureString
Set-CsLisServiceProvider -ServiceProviderName E911Provider -ValidationServiceUrl https://www.911contoso.com/validation/ -CertFileName C:\MS-Contoso-Cert.pfx -Password $p
Uno de los parámetros requeridos para crear una entrada para un servicio web de proveedor de enrutamiento de la red E9-1-1 es una cadena segura que contiene la contraseña para obtener acceso al archivo de certificado. Debido a esto, la primera línea en este ejemplo es un llamado al cmdlet Read-Host de Windows PowerShell. Read-Host solicitará el ingreso del usuario. Especificamos el parámetro AsSecureString, que mostrará dicho ingreso por medio de asteriscos (*) a medida que se escribe. Hemos asignado el resultado de este comando a la variable $p. El resultado será una cadena segura, que es una versión cifrada del ingreso del usuario. En otras palabras, ejecutar este comando hará que se solicite la contraseña al servicio web y almacenará esa contraseña en la variable $p.
Ahora que tenemos la contraseña, podemos crear un objeto que obtendrá acceso al servicio web. Llevamos a cabo esta acción por medio del llamado del cmdlet Set-CsLisServiceProvider. Transferimos varios parámetros a este cmdlet. El primero es el nombre del proveedor, en este caso, E911Provider. Después, proporcionamos un valor para ValidationServiceUrl, https://www.911contoso.com/validation/. Tenga en cuenta que éste debe ser un “sitio seguro” con el uso del prefijo https, en lugar del prefijo http. Después, escribimos el nombre del archivo que contiene el certificado usado para obtener acceso a este servicio web, C:\MS-Contoso-Cert.pfx. Finalmente, transferimos la variable $p al parámetro Password, recordando que $p contiene la cadena segura con la contraseña de servicio web).