Get-CsLisCivicAddress

Parameters

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

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.

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

-------------------------- 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 LIS civic addresses that have been validated against the Master Street Address Guide (MSAG).