Get-CsOnlineLisSwitch
Retrieves one or more network switches from the location configuration database.
Syntax
Default (Default)
Get-CsOnlineLisSwitch
[[-ChassisID] <string>]
[-Filter <string>]
[-Force]
[-IsDebug <bool>]
[-NCSApiUrl <string>]
[-TargetStore <string>]
[<CommonParameters>]
Description
Each switch can be associated with a location. This cmdlet retrieves the location information for the switches when there's an association. Use this location association in an Enhanced 9-1-1 (E9-1-1) Enterprise Voice implementation to notify an emergency services operator of the caller's location.
Enhanced 9-1-1 allows an emergency operator to identify the location of a caller without asking the caller for that information. When a caller uses a Voice over Internet Protocol (VoIP) connection, you must extract that information based on various connection factors. The VoIP administrator must configure a location map (called a wiremap) that determines a caller's location. This cmdlet retrieves information on associations between physical locations and the network switch through which the client is connected.
Use the Filter parameter to retrieve switches that match a filter expression, such as an exact chassis ID or a list of chassis IDs.
Examples
Example 1
Get-CsOnlineLisSwitch
ChassisID LocationId Description
--------- ---------- -----------
AA-BB-CC-DD-EE-01 11111111-1111-1111-1111-111111111111 Switch1
AA-BB-CC-DD-EE-02 22222222-2222-2222-2222-222222222222 Switch2
Example 1 retrieves all Location Information Server (LIS) switches and any associated locations.
Example 2
Get-CsOnlineLisSwitch -ChassisID AA-BB-CC-DD-EE-01
ChassisID LocationId Description
--------- ---------- -----------
AA-BB-CC-DD-EE-01 11111111-1111-1111-1111-111111111111 Switch1
Example 2 retrieves Location Information Server (LIS) switch "AA-BB-CC-DD-EE-01" and associated location.
Example 3: Filter by an exact chassis ID
Get-CsOnlineLisSwitch -Filter "ChassisID -eq 'AA-BB-CC-DD-EE-01'"
ChassisID LocationId Description
--------- ---------- -----------
AA-BB-CC-DD-EE-01 11111111-1111-1111-1111-111111111111 Switch1
This example returns the switch whose ChassisID is "AA-BB-CC-DD-EE-01", together with its associated location information.
Example 4: Filter by multiple chassis IDs
Get-CsOnlineLisSwitch -Filter "ChassisID -in ['AA-BB-CC-DD-EE-01', 'AA-BB-CC-DD-EE-02']"
ChassisID LocationId Description
--------- ---------- -----------
AA-BB-CC-DD-EE-01 11111111-1111-1111-1111-111111111111 Switch1
AA-BB-CC-DD-EE-02 22222222-2222-2222-2222-222222222222 Switch2
This example returns switches whose ChassisID matches either value in the filter, together with their associated location information.
Parameters
-ChassisID
Applicable: Microsoft Teams
The Media Access Control (MAC) address of the port's switch. This value is in the form nn-nn-nn-nn-nn-nn, such as 12-34-56-78-90-ab.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Filter
Applicable: Microsoft Teams
Filters switches by property values.
Use ChassisID -eq 'AA-BB-CC-DD-EE-01' to match one chassis ID, or ChassisID -in ['AA-BB-CC-DD-EE-01', 'AA-BB-CC-DD-EE-02'] to match any chassis ID in a list.
Pass the filter expression as a string, with double quotation marks around the expression and single quotation marks around string values.
For -in, enclose the comma-separated values in square brackets.
Note
The -Filter parameter is available in Teams PowerShell module 8.0.0 or later.
Parameter properties
| Type: | System.String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
Applicable: Microsoft Teams
The -Force switch suppresses warning and confirmation messages.
It can be useful in scripting to suppress interactive prompts.
If you don't include the -Force switch in the command, the command prompts you for administrative input if required.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-IsDebug
Applicable: Microsoft Teams
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-NCSApiUrl
Applicable: Microsoft Teams
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-TargetStore
Applicable: Microsoft Teams
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.