Set-CsLisServiceProvider

Syntax

Set-CsLisServiceProvider
   -CertFileName <String>
   -Password <SecureString>
   -ServiceProviderName <String>
   -ValidationServiceUrl <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

In an Enterprise Voice implementation with E9-1-1, emergency calls must first be routed through an E9-1-1 Network Routing Provider to ensure that the calls are routed to the appropriate Public Safety Answering Point (PSAP). (A PSAP is the agency in the United States that directs the calls to the nearest emergency services, such as police, fire and ambulance services.) In order to do this, the provider must have a list of locations from the organization that it can then match against the Master Street Address Guide to ensure all locations are valid. This cmdlet creates or modifies information about a provider, including the name of the provider, a URL for the web service that the organization will use to send the locations and a certificate and password for the secure web service.

You cannot define more than one service provider for a given E9-1-1 implementation. This cmdlet will not succeed unless it can resolve the URL and security information for the web service.

Examples

-------------------------- Example 1 --------------------------

$p = Read-Host -AsSecureString

Set-CsLisServiceProvider -ServiceProviderName E911Provider -ValidationServiceUrl https://www.911contoso.com/validation/ -CertFileName C:\MS-Contoso-Cert.pfx -Password $p

One of the required parameters for creating an entry for an E9-1-1 Network Routing Provider web service is a secure string containing the password to access the certificate file. Because of that, the first line in this example is a call to the Read-Host cmdlet. The Read-Host cmdlet will prompt for user input. We specify the parameter AsSecureString, which will display that input as asterisks (*) as it is entered. We've assigned the result of this command to the variable $p. The result will be a secure string, which is an encrypted version of the user input. In other words, running this command will prompt for the password to the web service and will store that password in the variable $p.

Now that we have the password, we can create an object that will access the web service. We do this by calling the Set-CsLisServiceProvider cmdlet. We pass several parameters to this cmdlet. The first is the name of the provider, in this case E911Provider. Next we provide a value for the ValidationServiceUrl, https://www.911contoso.com/validation/. Note that this must be a "secure site," with the prefix https rather than http. Next we enter the name of the file containing the certificate used to access this web service, C:\MS-Contoso-Cert.pfx. Finally, we pass the variable $p (which contains the secure string with the web service password) to the Password parameter.

Parameters

-CertFileName

-Confirm

-Password

-ServiceProviderName

-ValidationServiceUrl

-WhatIf

Inputs

Accepts pipelined input of Location Information Server (LIS) service provider objects.

Outputs

This cmdlet creates or modifies an object of type System.Management.Automation.PSCustomObject.

Related Links

• Remove-CsLisServiceProvider
• Get-CsLisServiceProvider