Skip to content

Latest commit

 

History

History
88 lines (51 loc) · 5.58 KB

README.md

File metadata and controls

88 lines (51 loc) · 5.58 KB

PowerNSX

A Powershell module for NSX for vSphere

Get the latest news from the team at the PowerNSX blog

PowerNSX is a PowerShell module that abstracts the VMware NSX API to a set of easily used PowerShell functions.

This module is not supported by VMware, and comes with no warranties express or implied. Please test and validate its functionality before using this product in a production environment.

It aims to focus on exposing New, Update, Remove and Get operations for all key NSX functions as well as adding additional functionality to extend the capabilities of NSX management beyond the native UI or API.

PowerNSX works closely with VMware PowerCLI, and PowerCLI users will feel quickly at home using PowerNSX. Together these tools provide a comprehensive command line environment for managing your VMware NSX for vSphere environments.

PowerNSX is still a work in progress, and it is unlikely that it will ever expose 100% of the NSX API. Feature requests are welcome via the issues tracker on the projects GitHub page.

PowerNSX now has experimental PowerShell Core support available in the master (development) branch. Note that not all PowerNSX functions have been tested, and there are known issues (Remember, PowerShell Core and PowerCLI Core are both pre-release products as well.). See PowerNSX Core for details.

Installing PowerNSX

PowerNSX is available from the PowerShell Gallery. Installation of PowerNSX from the PowerShell Gallery is performed as follows:

Find-Module PowerNSX | Install-Module -scope CurrentUser

If your system doesn't have PowerShell Gallery support, or you want to use the PowerNSX installation script, you can do so by running the oneliner below in a PowerShell Window. This will execute the PowerNSX installation script which will guide you through the installation of the latest stable release of PowerNSX.

$Branch="v3";$url="https://raw.githubusercontent.com/vmware/powernsx/$Branch/PowerNSXInstaller.ps1"; try { $wc = new-object Net.WebClient;$scr = try { $wc.DownloadString($url)} catch { if ( $_.exception.innerexception -match "(407)") { $wc.proxy.credentials = Get-Credential -Message "Proxy Authentication Required"; $wc.DownloadString($url) } else { throw $_ }}; $scr | iex } catch { throw $_ }

PowerNSX can also be installed on PowerShell Core. See PowerNSX Core for details.

More install options for PowerNSX including Linux and OSX installation can be found here under Installing PowerNSX

Using PowerNSX

For TLDR, basic and detailed PowerNSX usage, see the Usage page.

Contribution guidelines

Contribution and feature requests are more than welcome. Please use the following methods:

  • For bugs and issues, please use the issues register with details of the problem.
  • For Feature Requests, please use the issues register with details of what's required.
  • For code contribution (bug fixes, or feature request), please request fork PowerNSX, create a feature branch, then submit a pull request.

For more details see Contributing to PowerNSX

Who do I talk to?

PowerNSX is a community based project headed by some VMware staff. If you want to contribute please have a look at the issues page to see what is planned, requires triage, and to get started.

PowerNSX is an OpenSource project, and as such is not supported by VMware. Please feel free reach out to the team via the Issues page.

Find out more information about the author and the team here

Blog

Want to know what is new with PowerNSX? The team occasionally blogs here. Also, team member Anthony Burkes blog, where he posts a lot of useful usage information cant be found here.

Is PowerNSX supported?

This module is opensource, and as such is not supported by VMware, and comes with no warranties express or implied. Please test and validate its functionality before using in a production environment.

Whist every endeavour is made to test functionality it is recommended that tools and scripts created with PowerNSX be validated and tested before using in production.

License

PowerNSX is licensed under GPL v2

Copyright © 2015 VMware, Inc. All Rights Reserved.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 2, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTIBILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License version 2 for more details.

You should have received a copy of the General Public License version 2 along with this program. If not, see https://www.gnu.org/licenses/gpl-2.0.html.

The full text of the General Public License 2.0 is provided in the COPYING file. Some files may be comprised of various open source software components, each of which has its own license that is located in the source code of the respective component.”