Edit

Share via


Remove-CsLisLocation

Removes a location from the location configuration database for Enhanced 9-1-1 (E9-1-1). This cmdlet was introduced in Lync Server 2010.

Syntax

LocationEnumeratedMandatorySet

Remove-CsLisLocation
    -City <String>
    -CompanyName <String>
    -Country <String>
    -HouseNumber <String>
    -HouseNumberSuffix <String>
    -Location <String>
    -PostalCode <String>
    -PostDirectional <String>
    -PreDirectional <String>
    -State <String>
    -StreetName <String>
    -StreetSuffix <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LocationEnumeratedOptionalSet

Remove-CsLisLocation
    [-City <String>]
    [-CompanyName <String>]
    [-Country <String>]
    [-HouseNumber <String>]
    [-HouseNumberSuffix <String>]
    [-Location <String>]
    [-PostalCode <String>]
    [-PostDirectional <String>]
    [-PreDirectional <String>]
    [-State <String>]
    [-StreetName <String>]
    [-StreetSuffix <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

E9-1-1 enables those who answer emergency calls to determine the caller's geographic location without having to ask the caller for that information. In Skype for Business Server the location is determined based on mapping the caller's port, subnet, switch, or wireless access point to a specific location. This cmdlet removes a location from the location configuration database. All properties of a location combined make the location unique, so you must enter all non-null properties of the location to remove it. If you do not enter all non-null properties of the location you want to remove (and no other location contains only the properties you specified), no locations will be removed. You won't receive an error in this case, but no action will occur.

This cmdlet will not remove locations that are associated with a Location Information Server (LIS) port, subnet, switch, or wireless access point. If you attempt to remove a location referenced by any of these devices, you'll receive an error. You must remove all references before removing the location. You can use the Remove-CsLisPort cmdlet, the Remove-CsLisSubnet cmdlet, the Remove-CsLisSwitch cmdlet and the Remove-CsLisWirelessAccessPoint cmdlet to remove these references.

Examples

Example 1

Remove-CsLisLocation -Location Bldg30NEWing -HouseNumber 1000 -StreetName Main -City Redmond -State WA -Country US

Example 1 removes a location named Bldg30NEWing. This command specifies values for the parameters Location, HouseNumber, StreetName, City, State and Country. This means that those are the only properties of the location to be deleted that contain non-null values. If you don't supply parameter values for all non-null properties, the location will not be deleted. You will be prompted for any parameter that you haven't specified in the command, but if they contain null values you can simply press Enter at each prompt.

Example 2

Get-CsLisLocation -Unreferenced | Remove-CsLisLocation

This example will remove all locations that are not referenced by a LIS port, subnet, switch, or wireless access point. The command begins with a call to the Get-CsLisLocation cmdlet, specifying the Unreferenced parameter. This will return a collection of all locations that are not referenced by a LIS port, subnet, switch, or wireless access point. This collection is then piped to the Remove-CsLisLocation cmdlet, which removes each location in the collection.

Parameters

-City

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The location city.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CompanyName

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The name of the company at this location.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Confirm

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Prompts you for confirmation before executing the command.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Country

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The country/region this location is in. This value will contain two characters or less.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-HouseNumber

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The house number of the location. For a company this is the number on the street where the company is located.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-HouseNumberSuffix

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Additional information for the house number, such as 1/2 or A. For example, 1234 1/2 Oak Street or 1234 A Elm Street.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Location

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The name for this location.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-PostalCode

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The postal code associated with this location.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-PostDirectional

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The directional designation of a street name. For example, NE or NW for Main Street NE or 7th Avenue NW.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-PreDirectional

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The directional designation for a street name that precedes the name of the street. For example, NE or NW for NE Main Street or NW 7th Avenue.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-State

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The state or province associated with this location. This value will be two characters or less.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-StreetName

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The name of the street for this location.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-StreetSuffix

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

The type of street designated in a street name, such as Street, Avenue, or Court.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

LocationEnumeratedMandatorySet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-WhatIf

Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Describes what would happen if you executed the command without actually executing the command.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

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.

Inputs

System.String

Accepts pipelined input of LIS location objects.

Outputs

None

This cmdlet does not return a value or object.