EXAMPLE 1

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

	Copy Code
Get-CsLisCivicAddress

EXAMPLE 2

In this example, all the civic addresses in the city of Redmond are retrieved. The example begins with a call to the Get-CsLisCivicAddress cmdlet, 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.

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

EXAMPLE 3

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

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

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 Lync Server, 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 the Get-CsLisLocation cmdlet 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"}

None.

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