Edit

Share via

Set-CsLisSubnet

Module:
Skype for Business Server PowerShell

Creates a Location Information Server (LIS) subnet, creates an association between a subnet and a location (creating a new location if that location doesn't exist), or modifies an existing subnet and its associated location. The association between a subnet and location 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.

Syntax

LocationEnumeratedOptionalSet 

Set-CsLisSubnet
    -Subnet <String>
    [-City <String>]
    [-CompanyName <String>]
    [-Country <String>]
    [-Description <String>]
    [-HouseNumber <String>]
    [-HouseNumberSuffix <String>]
    [-Location <String>]
    [-PostalCode <String>]
    [-PostDirectional <String>]
    [-PreDirectional <String>]
    [-State <String>]
    [-StreetName <String>]
    [-StreetSuffix <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SubnetSet 

Set-CsLisSubnet
    -Subnet <String>
    [-Description <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LocationEnumeratedMandatorySet 

Set-CsLisSubnet
    -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

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 allows the administrator to map physical locations to the subnet through which the client is connected.

The Subnet parameter is the only required parameter for this cmdlet. If you enter a Subnet value that already exists, this cmdlet will update the location for that subnet based on the location parameters that are supplied. If the Subnet does not exist, a new subnet location will be created.

If a location with an address exactly matching the address parameters entered here (including null values) does not exist in the location database, a new address will be created based on the parameters entered with this cmdlet. (You can retrieve a list of locations by calling the Get-CsLisLocation cmdlet.) The Set-CsLisSubnet cmdlet does not require or prompt for location parameters; you can create a subnet entry without associating it with a location. It's also possible to create an invalid location with this cmdlet. A valid location consists of, at minimum, the Location, HouseNumber, StreetName, City, State and Country. If you do not supply all these parameters, calls that originate from the specified subnet may not contain the information required by the emergency operator (depending on whether valid settings are available for a switch, port, or wireless access point that can be used in place of subnet settings). It is recommended that you be as specific as possible with the location parameters and fill in as many as possible.

Examples

Example 1

Set-CsLisSubnet -Subnet 192.10.10.0

Example 1 creates or updates a LIS subnet location entry. 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.

Note that this example does not include any address information. It's possible to create a subnet entry on the Location Information Server without associating it with an address. However, emergency calls routed through this subnet may not (depending on port or switch locations that have been defined) contain enough information for the emergency operator to identify a location.

IMPORTANT: If a LIS subnet location with this Subnet value already exists, it will be replaced by the values in this command. That means that if this subnet were associated with an address (a physical location), that association would no longer exist because we didn't include any location information in this command. The location will still exist in the location database, but it will not be associated with this subnet.

Parameters

-City

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

The location city.

Maximum length: 64 characters.

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedMandatorySet
Position:Named
Mandatory:False
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.

Maximum length: 60 characters

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedMandatorySet
Position:Named
Mandatory:False
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.

Maximum length: 2 characters

Parameter properties

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

Parameter sets

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

-Description

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

A detailed description of this subnet location.

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
SubnetSet
Position:Named
Mandatory:False
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.

Maximum length: 10 characters

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedMandatorySet
Position:Named
Mandatory:False
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.

Note: To designate an apartment number or office suite, you must use the Location parameter. For example, -Location "Suite 100/Office 150".

Maximum length: 5 characters

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedMandatorySet
Position:Named
Mandatory:False
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. Typically this value is the name of a location more specific than the civic address, such as an office number, but it can be any string value.

Maximum length: 20 characters

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedMandatorySet
Position:Named
Mandatory:False
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.

Maximum length: 10 characters

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedMandatorySet
Position:Named
Mandatory:False
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.

Maximum length: 2 characters

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedMandatorySet
Position:Named
Mandatory:False
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.

Maximum length: 2 characters

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedMandatorySet
Position:Named
Mandatory:False
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.

Maximum length: 2 characters

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedMandatorySet
Position:Named
Mandatory:False
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.

Maximum length: 60 characters

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
LocationEnumeratedMandatorySet
Position:Named
Mandatory:False
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.

Maximum length: 10 characters

Parameter properties

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

Parameter sets

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

-Subnet

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

The IP address of the subnet. This value should be entered as an IPv4 address (digits separated by periods, such as 192.0.2.0).

Parameter properties

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

Parameter sets

LocationEnumeratedOptionalSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
SubnetSet
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 subnet objects.

Outputs

None

This cmdlet creates or modifies an object of type System.Management.Automation.PSCustomObject.