Set-NectarLocation

Update a Nectar DXP location in the location database

Description

Update a Nectar DXP location in the location database. This command can use the Google Geocode API to automatically populate the latitude/longitude for each location. You can register for an API key and save it as persistent environment variable called GoogleGeocode_API_Key on this machine. This command will prompt for the GeoCode API key and will save it in the appropriate location. Follow this link to get an API Key - https://developers.google.com/maps/documentation/geocoding/get-api-key. If this is not an option, then use the -SkipGeoLocate switch

Syntax

Set-NectarLocation
  -SearchQuery  <String>
  -Network  <String>
  -NetworkMask  <String>
  -ExtNetwork  <String>
  -ExtNetworkMask  <String>
  -NetworkName  <String>
  -SiteName  <String>
  -SiteCode  <String>
  -Region  <String>
  -StreetAddress  <String>
  -City  <String>
  -State  <String>
  -PostCode  <String>
  -Country  <String>
  -Description  <String>
  -IsWireless  <String>
  -IsExternal  <String>
  -IsVPN  <String>
  -Latitude  <Double>
  -Longitude  <Double>
  -ForceGeoLocate
  -SkipGeoLocate
  -TenantName  <String>
  -Identity  <String>

Examples

Example 1

Set-NectarLocation HeadOffice -Region WestUS

Changes the region for HeadOffice to WestUS

Example 2

Get-NectarLocation | Set-NectarLocation

Will go through each location and update the latitude/longitude. Useful if a Google Geocode API key was obtained after initial location loading

Parameters

-SearchQuery <String>
A string to search for. Will search in Network, NetworkName, City, Street Address, Region etc.

-Network <String>
The IP subnet of the network

-NetworkMask <String>
The subnet mask of the network

-ExtNetwork <String>
The IP subnet of the external/public network. Optional. Used to help differentiate calls from corporate locations that use common home subnets (192.168.x.x)

-ExtNetworkMask <String>
The subnet mask of the external/public network. Optional. Used to help differentiate calls from corporate locations that use common home subnets (192.168.x.x)

-NetworkName <String>
The name to give to the network

-SiteName <String>
The name to give to the siteCode

-SiteCode <String>
A site code to assign to the site

-Region <String>
The name of the region. Typically is set to country name or whatever is appropriate for the company

-StreetAddress <String>
The street address of the location

-City <String>
The city of the location

-State <String>
The state/province of the location

-PostCode <String>
The postal/zip code of the location

-Country <String>
The 2-letter ISO country code of the location

-Description <String>
A description to apply to the location

-IsWireless <String>
True or false if the network is strictly wireless

-IsExternal <String>
True or false if the network is outside the corporate network

-IsVPN <String>
True or false if the network is a VPN

-Latitude <Double>
The geographical latitude of the location. If not specified, will attempt automatic geolocation.

-Longitude <Double>
The geographical longitude of the location. If not specified, will attempt automatic geolocation.

-ForceGeoLocate <SwitchParameter>

-SkipGeoLocate <SwitchParameter>
Don't attempt geolocation. Do this if you don't have a valid Google Maps API key.

-TenantName <String>

-Identity <String>
The numerical ID of the location to update. Can be obtained via Get-NectarLocation and pipelined to Set-NectarLocation