| external help file | online version | applicable | title | schema | manager | author | ms.author | ms.reviewer |
|---|---|---|---|---|---|---|---|---|
Microsoft.Rtc.Management.dll-help.xml |
Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
Remove-CsLisPort |
2.0.0 |
rogupta |
hirenshah1 |
hirshah |
Removes an association between a Location Information Server (LIS) port and a location. This association is used in an Enhanced 9-1-1 (E9-1-1) Enterprise Voice implementation to notify an emergency services operator of the caller's location. This cmdlet was introduced in Lync Server 2010.
Remove-CsLisPort -ChassisID <String> -PortID <String> -PortIDSubType <PortIDSubType> [-WhatIf] [-Confirm]
[<CommonParameters>]
Enhanced 9-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 an association between a physical location and a port through which calls will be routed by removing the port from the location configuration database.
Removing a port location will not remove the actual location of the port; it removes only the port.
To remove the location, call the Remove-CsLisLocation cmdlet.
Removing the port will also not remove the switch with the given ChassisID; to remove the switch, call the Remove-CsLisSwitch cmdlet.
If you attempt to remove a port that does not exist, no action will be taken and you will not receive an error or a warning message.
Remove-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
Example 1 removes the LIS port with the MAC address (ChassisID) 99-99-99-99-99-99, the PortID 4200 and the PortIDSubType 1.
(Note that a value of 1 for PortIDSubType translates into a value of InterfaceAlias.
This parameter and value could also have been entered like this: -PortIDSubType InterfaceAlias)
If this port was associated with a location, that location will not be removed, only the port will be removed from the location mapping.
Get-CsLisPort | Where-Object {$_.HouseNumber -eq ""} | Remove-CsLisPort
This example removes all port locations that do not have a house number.
The example begins with a call to the Get-CsLisPort cmdlet, which returns a collection of all LIS ports.
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 port locations that don't have house numbers to the Remove-CsLisPort cmdlet, which removes everything in that collection.
Note that, as in example 1, no locations are removed from the location configuration database, only the ports 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.
The Media Access Control (MAC) address of the port's switch. This value will be in the form nn-nn-nn-nn-nn-nn, such as 12-34-56-78-90-ab.
Type: String
Parameter Sets: (All)
Aliases:
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: FalseThe ID of the port you want to remove.
Type: String
Parameter Sets: (All)
Aliases:
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: FalseThe subtype of the port you want to remove. This value can be entered as a numeric value or a string, but it must be a valid subtype. Valid subtypes are:
1: InterfaceAlias
5: InterfaceName
7: LocallyAssigned
Type: PortIDSubType
Parameter Sets: (All)
Aliases:
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: FalseDescribes what would happen if you executed the command without actually executing the command.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalsePrompts you for confirmation before executing the command.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Accepts pipelined input of LIS port objects.
This cmdlet does not return a value. It removes an object of type System.Management.Automation.PSCustomObject.