[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Retrieves one or more associations between a Location Information Server (LIS) network switch and a location. This association is used in an Enhanced 911 (E9-1-1) Enterprise Voice implementation to notify an emergency services operator of the caller’s location.

Syntax

Get-CsLisSwitch

Parameters

Parameter Required Type Description

Detailed Description

Enhanced 911 allows an emergency operator to identify the location of a caller without having to ask the caller for that information. In the case where a caller is calling from a Voice over IP (VoIP) connection that information must be extracted based on various connection factors. The VoIP administrator must configure a location map (called a wiremap) that will determine a caller’s location. This cmdlet retrieves information on associations between physical locations and the network switch through which calls will be routed.

This cmdlet does not take any parameters (other than the Windows PowerShell common parameters). The cmdlet will retrieve all instances of switch to location mappings. To narrow down the information retrieved you must pipe the output from this cmdlet to another Windows PowerShell cmdlet such as Where-Object or Select-Object.

Return Types

This cmdlet retrieve one or more objects of type System.Management.Automation.PSCustomObject.

Examples

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

Copy Code
Get-CsLisSwitch

Example 1 retrieves all LIS switch locations that have been defined in the Microsoft Communications Server 2010 deployment.

-------------------------- Example 2 --------------------------

Copy Code
Get-CsLisSwitch | Where-Object {$_.ChassisID -eq "99-99-99-99-99-99"}

This example retrieves all information for all switches that have a ChassisID equal to 99-99-99-99-99-99. Because ChassisIDs must be unique, this command will retrieve, at most, one switch location. The command begins by calling Get-CsLisSwitch to retrieve all switch location associations. This collection of switch locations is piped to the Where-Object cmdlet. Where-Object checks the ChassisID property of each item in the collection and returns the item with the ChassisID value 99-99-99-99-99-99.

-------------------------- Example 3 --------------------------

Copy Code
Get-CsLisSwitch | Where-Object {$_.City -eq "Redmond"}

This example retrieves all information for all switches that have been associated with a location in the city of Redmond. The command begins by calling Get-CsLisSwitch to retrieve all switch location associations. This collection of switch locations is piped to the Where-Object cmdlet. Where-Object checks the City property of each item in the collection to determine whether the value is equal to (-eq) Redmond.