Remove-CsLisSubnet
Topic Last Modified: 2012-03-26
Removes a Location Information Server (LIS) subnet.
Syntax
Remove-CsLisSubnet -Subnet <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Detailed Description
Enhanced 9-1-1 (E9-1-1) 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 Internet Protocol (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 a subnet from the location configuration database. Removing the subnet will not remove the location associated with that subnet. Use the Remove-CsLisLocation cmdlet to remove a location.
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.
Who can run this cmdlet: By default, members of the following groups are authorized to run the Remove-CsLisSubnet cmdlet locally: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsLisSubnet"}
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
Subnet |
Required |
String |
The IP address of the subnet you want to remove. This value will be an IPv4 address (digits separated by periods, such as 192.0.2.0). |
WhatIf |
Optional |
SwitchParameter |
Describes what would happen if you executed the command without actually executing the command. |
Confirm |
Optional |
SwitchParameter |
Prompts you for confirmation before executing the command. |
Input Types
Accepts pipelined input of Location Information Server (LIS) subnet objects.
Return Types
This cmdlet removes an object of type System.Management.Automation.PSCustomObject.
Example
-------------------------- Example 1 --------------------------
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 is associated with a location, that location will not be removed, only the subnet will be removed from the location mapping.
-------------------------- Example 2 --------------------------
Get-CsLisSubnet | Where-Object {$_.Location -eq "Bldg30/Room1000"} | Remove-CsLisSubnet
This example removes all subnets 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 LIS subnets. 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 subnets 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 configuration database, only the subnets that reference those locations are removed. You can remove locations by calling the Remove-CsLisLocation cmdlet.