Commands › Microsoft Teams

Get-CsOnlineLisLocation

Microsoft Teams MicrosoftTeams Get-*

Retrieve information on previously defined locations in the Location Information Service (LIS).

Quick start script

# Get-CsOnlineLisLocation — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Run and inspect
Get-CsOnlineLisLocation -CivicAddressId <Guid> -Filter <String> -Location <String> | Format-List

# 3. Export for evidence / drift tracking
Get-CsOnlineLisLocation | Export-Clixml .\CsOnlineLisLocation-$(Get-Date -Format yyyyMMdd).xml

Syntax — 5 parameter sets

GetByLocationID (Default)

Get-CsOnlineLisLocation [-AssignmentStatus <string>] [-City <string>] [-CountryOrRegion <string>] [-Description <string>] [-Force]
 [-NumberOfResultsToSkip <int>] [-PopulateNumberOfTelephoneNumbers] [-PopulateNumberOfVoiceUsers] [-ResultSize <long>] [-ValidationStatus <string>]
 [<CommonParameters>]

UseCivicAddressId

Get-CsOnlineLisLocation -CivicAddressId <guid> [-AssignmentStatus <string>] [-City <string>] [-CountryOrRegion <string>] [-Description <string>]
 [-Force] [-NumberOfResultsToSkip <int>] [-PopulateNumberOfTelephoneNumbers] [-PopulateNumberOfVoiceUsers] [-ResultSize <long>]
 [-ValidationStatus <string>] [<CommonParameters>]

UseLocation

Get-CsOnlineLisLocation -Location <string> [-AssignmentStatus <string>] [-City <string>] [-CountryOrRegion <string>] [-Description <string>]
 [-Force] [-NumberOfResultsToSkip <int>] [-PopulateNumberOfTelephoneNumbers] [-PopulateNumberOfVoiceUsers] [-ResultSize <long>]
 [-ValidationStatus <string>] [<CommonParameters>]

UseLocationId

Get-CsOnlineLisLocation [-AssignmentStatus <string>] [-City <string>] [-CountryOrRegion <string>] [-Description <string>] [-Force]
 [-NumberOfResultsToSkip <int>] [-PopulateNumberOfTelephoneNumbers] [-PopulateNumberOfVoiceUsers] [-ResultSize <long>] [-ValidationStatus <string>]
 [-LocationId <guid>] [<CommonParameters>]

1 more parameter sets — see the parameter table below.

Parameters (14)

Parameter	Type	Required	What it controls
-AssignmentStatus	String		Specifies whether the retrieved locations are assigned to users. Valid inputs are `Assigned` or `Unassigned`.
-City	String		Specifies the city of the target location.
-CivicAddressId	Guid	yes	Specifies the identification number of the civic address that's associated with the target locations.
-CountryOrRegion	String		Specifies the country or region of the target location.
-Description	String		Specifies the administrator-defined description of the civic address that's associated with the target locations.
-Force	SwitchParameter		Specifies whether to suppress warning and confirmation messages. This parameter is useful in scripting to suppress interactive prompts. If you don't provide the `-Force` parameter in the command, the command prompts...
-Filter	String	yes	Filters locations by property values. For example, use `CountryOrRegion -in ['CA', 'US']` to match a list of countries or regions, or `Description -like 'office'` to match part of a description. Use `-eq` for...
-Location	String	yes	Specifies an administrator-defined description of the location to retrieve. For example, "2nd Floor Cafe", "Main Lobby", or "Office 250".
-LocationId	Guid		Specifies the unique identifier of the target location.
-NumberOfResultsToSkip	Int32		Specifies the number of results to skip. If there are a large number of locations, you can limit the number of results by using the `ResultSize` parameter. If you limited the first cmdlet execution to 25 results, and...
-PopulateNumberOfTelephoneNumbers	SwitchParameter		If present, the `PopulateNumberOfTelephoneNumbers` switch causes the cmdlet to provide the number of telephone numbers at the returned locations.
-PopulateNumberOfVoiceUsers	SwitchParameter		If present, the `-PopulateNumberOfVoiceUsers` switch causes the cmdlet to provide the number of voice users at the returned locations.
-ResultSize	Int32		Specifies the maximum number of results to return.
-ValidationStatus	String		Specifies the validation status of the addresses to return. Valid inputs are: `Validated`, `Invalid`, and `NotValidated`.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.