Submit a ticketCall us

Solarwinds & Cisco Live! Barcelona
Join us from the 29th of January to the 2nd of February at Cisco Live 2018 in Barcelona, where we will continue to show how monitoring the network with SolarWinds will keep you ahead of the game. At our booth (WEP 1A), we will demonstrate how SolarWinds network solutions can help. As a bonus, we are also hosting a pre-event webinar - Blame the Network, Hybrid IT Edition with our SolarWinds Head Geek™, Patrick Hubbard on January 24th - GMT (UTC+0): 10:00 a.m. to 11:00 a.m. There's still time to RSVP.

Home > Success Center > IP Address Manager (IPAM) > SWIS API to perform IPAM operations

SWIS API to perform IPAM operations

Table of contents
No headers

Updated October 30, 2017

 

Overview

Starting with IPAM 4.5, you can use Windows PowerShell and the Orion SDK to manage IP addresses in IPAM. The IPAM-specific API fields are documented on the IPAM API wiki page in the Orion SDK.

 

Note: You can also use Python OrionSDK to call to the API. This article provides instructions on how to use Windows PowerShell.  
 

Supported operations:

  • Get the first available IP address for a specified subnet
  • Change IP node status
  • Start, finish, and cancel an IP address reservation
  • Create a new subnet
  • Add a DNS 'A' record for an IP address
  • Change a DNS 'A' record for an IP address
  • Remove a DNS 'A' record for an IP address
  • Add an 'A' record with an associated PTR for a zone
  • Add PTR to a DNS 'A' record
  • Create an IP address reservation on a DHCP server
  • Remove an IP address reservation from a DHCP server
  • Get an 'A' recorde and PTR records for a DNS zone
  • Create a custom property
  • Update a custom property
  • Reorder a custom property
  • Delete a custom property
  • CRUD operations for subnets
  • CRUD operations for IP addresses 
     
  • Pre-requisites
    • Verify that at least PowerShell 4.0 is installed:
      Open PowerShell and enter $PSVersionTable.PSVersion to determine the PowerShell engine version. The major version should be 4 or higher.
    • Install the Orion SDK if you have not yet installed it:
      Download the OrionSDK.msi installer from GitHub here:
      https://github.com/solarwinds/OrionSDK/releases/
      Run the installer and complete the setup wizard.
    • Learn the basics of using the Orion SDK in PowerShell:
      Review the Orion SDK PowerShell page posted here:
      https://github.com/solarwinds/OrionSDK/wiki/PowerShell
    • In PowerShell, add the SwisSnapin if you have not yet added it:

Add the SwisSnapin by running the Add-PSSnapin cmdlet:
 

Add-PSSnapin -Name SwisSnapin
 

For more information open the Orion SDK PowerShell page and follow the steps in the "Using SwisSnapin" section:
https://github.com/solarwinds/OrionSDK/wiki/PowerShell
 

  • Getting started with the API
    1. Open Windows PowerShell ISE to test the example(s)
      1. Enter Windows-key+R to open the Run dialog.
      2. Type powershell ise and press OK
         
    2. In PowerShell ISE, create a SWIS connection object using the Connect-Swis cmdlet.
      For details, open the Orion SDK PowerShell page and follow the steps in the "Cmdlets Provided by SwisSnapin" section:

      https://github.com/solarwinds/OrionSDK/wiki/PowerShell
       
    3. In PowerShell ISE, enter the IPAM API cmdlets and run them. Refer to the IPAM API reference for documentation.

 

 

 

 

Last modified

Tags

Classifications

Public