Get-CsLisLocation

 

Topic Last Modified: 2012-03-23

Retrieves one or more locations in the location configuration database for Enhanced 9-1-1 (E9-1-1).

Syntax

Get-CsLisLocation [-Unreferenced <SwitchParameter>]

Detailed Description

E9-1-1 enables those who answer emergency calls to determine the caller’s geographic location without having to ask the caller for that information. In Microsoft Lync Server 2010 the location is determined based on mapping the caller’s port, subnet, switch, or wireless access point to a specific location. This cmdlet retrieves one or more of these locations.

This cmdlet differs from Get-CsLisCivicAddress in that in addition to retrieving address information, Get-CsLisLocation retrieves the name of the location and the company name associated with the location. Get-CsLisCivicAddress retrieves only address information.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsLisLocation 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 "Get-CsLisLocation"}

Parameters

Parameter Required Type Description

Unreferenced

Optional

SwitchParameter

Including this parameter will retrieve only the locations that were not associated with a port, subnet, switch, or wireless access point. In other words, including this cmdlet retrieves all locations that either were created by calling Set-CsLisLocation or that were assigned to a Location Information Server (LIS) port, subnet, switch, or wireless access point that no longer exists.

Input Types

None.

Return Types

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

Example

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

Get-CsLisLocation

Calling Get-CsLisLocation with no parameters retrieves all locations defined within the location configuration database.

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

Get-CsLisLocation -Unreferenced

The Unreferenced parameter doesn’t accept a value. It’s simply a switch that tells the Get-CsLisLocation cmdlet to return only those locations that are not associated with a port, switch, subnet, or wireless access point.

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

Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"}

In order to retrieve specific LIS locations, you must retrieve all the locations by calling the Get-CsLisLocation cmdlet, and then pipe that collection of locations to the Where-Object cmdlet to narrow the collection down to the specific locations you’re looking for. Example 3 does just that: it uses Get-CsLisLocation and Where-Object to retrieve all the locations with a Location property that is equal to the string NorthCampus. (Notice that we used the –ceq comparison operator. This operator does a case-sensitive comparison. That means that in this case only locations with Location values of NorthCampus will be returned; northcampus, Northcampus, etc., will not be returned.)