Topic Last Modified: 2010-10-01

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

Syntax

Get-CsLisCivicAddress

Parameters

Parameter Required Type Description

None

This cmdlet provides only common Windows PowerShell parameters.

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 the addresses associated with these locations.

This cmdlet differs from Get-CsLisLocation in that it returns only unique addresses. It does not return the company name or a location name, it returns only address information. It also returns a flag (MSAGValid) that specifies whether the address has been validated against the Master Street Address Guide. This flag can be automatically updated by running the Test-CsLisCivicAddress cmdlet.

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

Input Types

None.

Return Types

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

Example

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

Copy Code
Get-CsLisCivicAddress

This example retrieves all civic addresses from the location database. Get-CsLisCivicAddress does not accept any parameters (other than the common Windows PowerShell parameters such as Verbose). Therefore any call to Get-CsLisCivicAddress will always return all civic addresses. See Example 2 for a command that will allow you to retrieve more specific results.

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

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

In this example, all the civic addresses in the city of Redmond are retrieved. The example begins with a call to Get-CsLisCivicAddress, which retrieves a collection of all civic addresses in the location database. This collection is then piped to the Where-Object cmdlet, which will return only those items in the collection with a City property value equal to (-eq) Redmond.

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

Copy Code
Get-CsLisCivicAddress | Where-Object {$_.MSAGValid -eq $true}

Example 3 retrieves all Location Information Server (LIS) civic addresses that have been validated against the Master Street Address Guide (MSAG).

See Also