[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Removes a location from the location database for Enhanced 911 (E9-1-1).

Syntax


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> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

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> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]


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

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

Parameters

Parameter	Required	Type	Description
City	Required	String	The location city.
CompanyName	Required	String	The name of the company at this location.
Country	Required	String	The country this location is in. This value will contain two characters or less.
HouseNumber	Required	String	The house number of the location. For a company this is the number on the street of the company.
HouseNumberSuffix	Required	String	Additional information for the house or company number, such as an apartment number or the suite number in a business complex.
Location	Required	String	The name for this location. Location names are case-sensitive, so if you have a location named Building30 you can also have a different location named building30.
PostalCode	Required	String	The postal code associated with this location.
PostDirectional	Required	String	The directional designation of a street name. For example, NE or NW for Main Street NE or 7th Avenue NW.
PreDirectional	Required	String	The directional designation for a street name that precedes the name of the street. For example, NE or NW or NE Main Street or NW 7th Avenue.
State	Required	String	The state or province associated with this location. This value will be two characters or less.
StreetName	Required	String	The name of the street for this location.
StreetSuffix	Required	String	The type of street designated in a street name, such as Street, Avenue, or Court.
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

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 Microsoft Communications Server 2010 the location is determined based on mapping the caller’s port, subnet, switch, or wireless access point to a specific address. This cmdlet removes a location. 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, Remove-CsLisSubnet, Remove-CsLisSwitch, and Remove-CsLisWirelessAccessPoint cmdlets to remove these references.

Return Types

This cmdlet does not return a value or object. It removes an object of type System.Management.Automation.PSCustomObject.

Examples

-------------------------- Example 1 --------------------------

	Copy Code
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 County. 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 --------------------------

	Copy Code
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 Get-CsLisLocation, 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 Remove-CsLisLocation, which removes each location in the collection.