Topic Last Modified: 2010-10-01

Creates or modifies information about the web service provided by the Enhanced 9-1-1 (E9-1-1) Network Routing Provider to verify locations.

Syntax

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

Parameters

Parameter Required Type Description

CertFileName

Required

String

The name (and full path) of the certificate file. This file must have a PFX file extension.

Password

Required

SecureString

A secure string containing the password needed to access the certificate in the password protected file. Secure strings can be created by using the ConvertTo-SecureString cmdlet or the Read-Host cmdlet with the AsSecureString parameter.

ServiceProviderName

Required

String

The name of the E9-1-1 Network Routing Provider.

ValidationServiceUrl

Required

String

The URL of the web service. This must be a secure URL, beginning with the prefix https://.

WhatIf

Optional

SwitchParameter

Describes what would happen if you executed the command without actually executing the command.

Confirm

Optional

SwitchParameter

Prompts you for confirmation before executing the command.

Detailed 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.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Set-CsLisServiceProvider cmdlet locally: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisServiceProvider"}

Input Types

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

Return Types

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

Example

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

Copy Code
$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 Windows PowerShell cmdlet Read-Host. Read-Host 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.

See Also