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> -Location <String> | Format-List

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

Syntax — 4 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>]

Parameters (13)

Parameter	Type	Required	What it controls
-AssignmentStatus	String		Note: This parameter has been deprecated from the Teams PowerShell Module version 3.0.0 or later.
-City	String		Specifies the city of the target location.
-CivicAddressId	Guid	yes	Specifies the identification number of the civic address that is 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 is associated with the target locations.
-Force	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...
-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 be returned. 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.