Topic Last Modified: 2010-12-07

In order to automatically locate clients within a network you first need to populate the location database with a network wiremap, which maps network elements to civic addresses. You can use subnets, wireless access points, switches, and ports to define the wiremap.

You can add addresses to the location database individually, or in bulk using a CSV file containing the column formats described in the following table.

Network Element Required Columns

Wireless access point

<BSSID>,<Description>,<Location>,<CompanyName>,<HouseNumber>,<HouseNumberSuffix>,<PreDirectional>,…

…<StreetName>,<StreetSuffix>,<PostDirectional>,<City>,<State>,<PostalCode>,<Country>

Subnet

<Subnet>,<Description>,<Location>,<CompanyName>,<HouseNumber>,<HouseNumberSuffix>,<PreDirectional>,…

…<StreetName>,<StreetSuffix>,<PostDirectional>,<City>,<State>,<PostalCode>,<Country>

Port

<ChassisID>,<PortIDSubType>,<PortID>,<Description>,<Location>,<CompanyName>,<HouseNumber>,<HouseNumberSuffix>,…

…<PreDirectional>,<StreetName>,<StreetSuffix>,<PostDirectional>,<City>,<State>,<PostalCode>,<Country>

Switch

<ChassisID>,<Description>,<Location>,<CompanyName>,<HouseNumber>,<HouseNumberSuffix>,<PreDirectional>,…

…<StreetName>,<StreetSuffix>,<PostDirectional>,<City>,<State>,<PostalCode>,<Country>

If you do not populate the location database, and the Location Required in the Location Policy is set to Yes or Disclaimer, the client will prompt the user to enter a location manually.

For details about populating the location database, see the Lync Server Management Shell documentation for the following cmdlets:

To add network elements to the location database

  1. Run the following cmdlet to add a subnet location to the location database.

    Copy Code
    Set-CsLisSubnet -Subnet 157.56.66.0 -Description "Subnet 1" -Location Location1 -CompanyName "Litware" -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName 163rd -StreetSuffix Ave -PostDirectional NE -City Redmond -State WA -PostalCode 99123 -Country US
    

    Alternately, you can run the following cmdlets to bulk update subnet locations using a file named ‘subnets.csv’.

    Copy Code
    $g = Import-Csv subnets.csv
    $g | Set-CsLisSubnet
    
  2. Run the following cmdlet to add wireless locations to the location database.

    Copy Code
    Set-CsLisWirelessAccessPoint -BSSID 0A-23-CD-16-AA-2E -Description "Wireless1" -Location Location2 -CompanyName "Litware" -HouseNumber 2345 -HouseNumberSuffix "" -PreDirectional "" -StreetName 163rd -StreetSuffix Ave -PostDirectional NE -City Bellevue -State WA -PostalCode 99234 -Country US
    

    Alternately, you can run the following cmdlets to bulk update wireless locations using a csv file named ‘waps.csv’.

    Copy Code
    $g = Import-Csv waps.csv
    $g | Set-CsLisWirelessAccessPoint
    
  3. Run the following cmdlet to add switch locations to the location database.

    Copy Code
    Set-CsLisSwitch-ChassisID 0B-23-CD-16-AA-BB -Description "Switch1" -Location Location1 -CompanyName "Litware" -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName 163rd -StreetSuffix Ave -PostDirectional NE -City Redmond -State WA -PostalCode 99123 -Country US
    

    Alternately, you can run the following cmdlets to bulk update switch locations using a csv file named ‘switches.csv’.

    Copy Code
    $g = Import-Csv switches.csv
    $g | Set-CsLisSwitch
    
  4. Run the following cmdlet to add port locations to the location database

    Copy Code
    Set-CsLisPort -ChassisID 0C-23-CD-16-AA-CC -PortID 0A-abcd -Description "Port1" -Location Location2 -CompanyName "Litware" -HouseNumber 2345 -HouseNumberSuffix "" -PreDirectional "" -StreetName 163rd -StreetSuffix Ave -PostDirectional NE -City Bellevue -State WA -PostalCode 99234 -Country US
    

    The default for PortIDSubType is LocallyAssigned. You can also set it to InterfaceAlias and InterfaceName

    Alternately, you can run the following cmdlets to bulk update port locations using a csv file named ‘ports.csv’.

    Copy Code
    $g = Import-Csv ports.csv
    $g | Set-CsLisPort