Retrieves one or more locations in the location database for Enhanced 911 (E9-1-1).
Syntax
Get-CsLisLocation [-Unreferenced <SwitchParameter>] |
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 when they were created. 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. |
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 Communications Server 2010 the location is determined based on mapping the caller’s port, subnet, switch, or wireless access point to a specific address. This cmdlet retrieves one or more of these locations.
Return Types
This cmdlet returns one or more objects of type System.Management.Automation.PSCustomObject.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
Get-CsLisLocation |
|
Calling Get-CsLisLocation with no parameters retrieves all locations defined within the LIS database.
-------------------------- Example 2 --------------------------
| Copy Code |
|
|---|---|
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 --------------------------
| Copy Code |
|
|---|---|
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, 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.)