Export (0) Print
Expand All
Expand Minimize

Get-CsLisCivicAddress

 

Topic Last Modified: 2012-03-23

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

Get-CsLisCivicAddress

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"}

 

Parameter Required Type Description

None

This cmdlet provides only common Windows PowerShell parameters.

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

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

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

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

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

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft