Removes the association between a Location Information Server (LIS) wireless access point (WAP) and a location. This association is used in an Enhanced 911 (E9-1-1) Enterprise Voice implementation to notify an emergency services operator of the caller’s location.
Syntax
Remove-CsLisWirelessAccessPoint -BSSID <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
BSSID |
Required |
String |
The basic service set identifier (BSSID) of the wireless access point you want to remove. This value will be in the form nn-nn-nn-nn-nn-nn, such as 12-34-56-78-90-ab. |
|
Confirm |
Optional |
SwitchParameter |
Prompts you for confirmation before executing the command. |
|
WhatIf |
Optional |
SwitchParameter |
Describes what would happen if you executed the command without actually executing the command. |
Detailed Description
Enhanced 911 allows an emergency operator to identify the location of a caller without having to ask the caller for that information. In the case where a caller is calling from a Voice over IP (VoIP) connection that information must be extracted based on various connection factors. The VoIP administrator must configure a location map (called a wiremap) that will determine a caller’s location. This cmdlet removes an association between a physical location and a WAP through which calls will be routed.
If you attempt to remove a WAP that does not exist, no action will be taken and you will not receive an error or a warning message.
Return Types
This cmdlet removes an object of type System.Management.Automation.PSCustomObject.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
Remove-CsLisWirelessAccessPoint -BSSID 99-99-99-99-99-99 |
|
Example 1 removes the LIS WAP location with the BSSID 99-99-99-99-99-99.
If this WAP was associated with a location, that location will not be removed, only the WAP will be removed from the location mapping.
-------------------------- Example 2 --------------------------
| Copy Code |
|
|---|---|
Get-CsLisWirelessAccessPoint | Where-Object {$_.HouseNumber -eq ""} | Remove-CsLisWirelessAccessPoint
|
|
This example removes all WAP locations that do not have a house number. The example begins with a call to the Get-CsLisWirelessAccessPoint cmdlet, which returns a collection of all WAP locations. This collection is piped to the Where-Object cmdlet, which finds the items in that collection that have a HouseNumber property that is empty; in other words, a HouseNumber that is equal to (-eq) an empty string (“”). Finally, we pipe this collection of WAP locations that don’t have house numbers to the Remove-CsLisWirelessAccessPoint cmdlet, which removes everything in that collection.
Note that, as in example 1, no locations are removed from the location database, only the WAPs that reference those locations are removed. In this case that means there will be invalid locations (they’re invalid because HouseNumber is a required property for a location) in the location database that should also be removed. You can remove locations by calling the Remove-CsLisLocation cmdlet.