Get-CsOnlineLisLocation

 

Topic Last Modified: 2015-12-01

Use the Get-CsOnlineLisLocation cmdlet to retrieve information on previously defined locations in the Location Information Service (LIS.)

Get-CsOnlineLisLocation <COMMON PARAMETERS>

Get-CsOnlineLisLocation -CivicAddressId <Guid> <COMMON PARAMETERS>

Get-CsOnlineLisLocation [-LocationId <Guid>] <COMMON PARAMETERS>

Get-CsOnlineLisLocation -Location <String> <COMMON PARAMETERS>

COMMON PARAMETERS: [-AssignmentStatus <String>] [-City <String>] [-CountryOrRegion <String>] [-Description <String>] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-NumberOfResultsToSkip <Int32>] [-PopulateNumberOfVoiceUsers <SwitchParameter>] [-ResultSize <Unlimited>] [-Tenant <Guid>] [-ValidationStatus <String>]

This example returns a maximum of 25 validated locations in Seattle.

Get-CsOnlineLisLocation -City Seattle -ResultSize 25 -ValidationStatus Validated

This example returns the locations associated with a civic address specified by its unique identifier.

Get-CsOnlineLisLocation -CivicAddressId a363a9b8-1acd-41de-916a-296c7998a024

This example returns the location described as the "3rd Floor Cafe".

Get-CsOnlineLisLocation -Location "3rd Floor Cafe"

This example returns the information on one location specified by its unique identifier.

Get-CsOnlineLisLocation -LocationId 5aa884e8-d548-4b8e-a289-52bfd5265a6e

 

Parameter Required Type Description

CivicAddressId

Required

System.Guid

Specifies the identification number of the civic address that is associated with the target locations.

Location

Required

System.String

Specifies an administrator defined description of the location to retrieve. For example, "2nd Floor Cafe", "Main Lobby", or "Office 250".

AssignmentStatus

Optional

System.String

Specifies whether the retrieved locations have been assigned to users or not. Valid inputs are "Assigned", or "Unassigned".

City

Optional

System.String

Specifies the city of the target location.

CountryOrRegion

Optional

System.String

Specifies the country or region of the target location.

Description

Optional

System.String

Specifies the administrator defined description of the civic address that is associated with the target locations.

DomainController

Optional

Microsoft.Rtc.Management.Deploy.Fqdn

This parameter is reserved for internal Microsoft use.

Force

Optional

System.Management.Automation.SwitchParameter

The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for administrative input if required.

LocationId

Optional

System.Guid

Specifies the unique identifier of the target location.

NumberOfResultsToSkip

Optional

System.Int32

Specifies the number of results to skip. If there are a large number of locations, you can limit the number of returns by using the ResultSize parameter. If you limited the first cmdlet execution to 25 results, and want to look at the next 25 locations, then you leave ResultSize at 25 and set NumberOfResultsToSkip to 25 to omit the first 25 you've reviewed. For example the command below will return locations 26-50 for Seattle.

Get-CsOnlineLisLocation -City Seattle -ResultSize 25 -NumberOfResultsToSkip 25

PopulateNumberOfVoiceUsers

Optional

System.Management.Automation.SwitchParameter

If present, the PopulateNumberOfVoiceUsers switch causes the cmdlet to provide the number of voice users at the returned locations.

ResultSize

Optional

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

Specifies the maximum number of results to return.

Tenant

Optional

System.Guid

This parameter is reserved for internal Microsoft use.

ValidationStatus

Optional

System.String

Specifies the validation status of the addresses to be returned. Valid inputs are: Valid, Invalid, and Notvalidated.

Returns an instance, or instances of emergency location objects.

 
Show: