New-NectarLocation

Creates a Nectar DXP location in the location database

Description

Creates 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

New-NectarLocation
  -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>
  -SkipGeoLocate
  -Latitude  <Double>
  -Longitude  <Double>
  -TenantName  <String>

Examples

Example 1

New-NectarLocation -Network 10.14.3.0 -NetworkMask 24 -NetworkName Corp5thFloor -SiteName 'Head Office'

Creates a new location using the minimum required information

Example 2

New-NectarLocation -Network 10.15.1.0 -NetworkMask 24 -ExtNetwork 79.23.155.71 -ExtNetworkMask 28 -NetworkName Corp3rdFloor -SiteName 'Head Office' -SiteCode HO3 -IsWireless True -IsVPN False -Region EastUS -StreetAddress '366 North Broadway' -City Jericho -State 'New York' -Country US -PostCode 11753 -Description 'Head office 3rd floor' -Latitude 40.7818283 -Longitude -73.5351438

Creates a new location using all available fields

Example 3

Import-Csv LocationData.csv | New-NectarLocation

Imports a CSV file called LocationData.csv and creates new locations

Example 4

Import-Csv LocationData.csv | New-NectarLocation -SkipGeolocate

Imports a CSV file called LocationData.csv and creates new locations but will not attempt geolocation

Parameters

-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 site

-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

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

-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.

-TenantName <String>
The name of the Nectar DXP tenant. Used in multi-tenant configurations.