Removes the association between a Location Information Server (LIS) subnet 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-CsLisSubnet -Subnet <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Subnet |
Required |
String |
The IP address of the subnet you want to remove. This value will be either an IPv4 address (digits separated by periods, such as 192.0.2.0) or an IPv6 address (digits separated by colons, such as 2001:1111:2222:3333:AAAA:BBBB:CCCC:FFFF). |
|
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 subnet through which calls will be routed.
If you attempt to remove a subnet 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-CsLisSubnet -Subnet 192.10.10.0 |
|
Example 1 removes the LIS subnet location entry for the subnet with the IP address 192.10.10.0. The command in this example includes only one (required) parameter: Subnet. The value of the Subnet in this example is an IPv4 address, 192.10.10.0.
If this subnet was associated with a location, that location will not be removed, only the subnet will be removed from the location mapping.
-------------------------- Example 2 --------------------------
| Copy Code |
|
|---|---|
Get-CsLisSubnet | Where-Object {$_.Location -eq "Bldg30/Room1000"} | Remove-CsLisSubnet
|
|
This example removes all subnet locations that are associated with the location Bldg30/Room1000. The example begins with a call to the Get-CsLisSubnet cmdlet, which returns a collection of all subnet locations. This collection is piped to the Where-Object cmdlet, which finds the items in that collection that have a Location property that is equal to (-eq) the string Bldg30/Room1000. Finally, we pipe this collection of subnet locations with that Location to the Remove-CsLisSubnet cmdlet, which removes everything in that collection.
Note that, as in example 1, no locations are removed from the location database, only the subnets that reference those locations are removed. You can remove locations by calling the Remove-CsLisLocation cmdlet.