Permalink
Fetching contributors…
Cannot retrieve contributors at this time
56 lines (44 sloc) 3.14 KB

vNugglets PowerShell Module

Contents:

This is the PowerShell module created from the nugglets from vNugglets.com. This repo is meant to be a place where the vNugglets.com code can reside, separate from the blog, for easier/central consumption and collaboration.

Some of the functionality provided by the cmdlets in this module:

  • VIRole management (copying/duplicating)
  • Finding VMs in inventory by attributes other than "name", like by the guest IP address, by the RDMs it may have, by the virtual portgroup to which it is connected
  • Mining VMHost information, like host and peripheral firmware information, HBA WWNs, logical drive information, information about "broken" vmnics
  • Establishing VM network to virtual portgroup physical uplink relationship information (which of the active uplinks is VM0 actually currently using?)
  • Mining VM information, like standard and RDM disks, EVC setting
  • vCenter connection information (in title of PowerShell window)
  • Datastore evacuation, template evacuation from VMHosts
  • Mining virtual portgroup information (cluster-locations)

QuickStart

Chomping at the bit to get going with using this module? Of course you are! Go like this:

  • download the module, either from the latest release's .zip file on the vNugglets.Utility Releases page, or by cloning the project to some local folder with Git via:
    PS C:\> git clone https://github.com/vNugglets/vNuggletsPSMod.git C:\temp\MyVNuggsRepoCopy
  • put the actual PowerShell module directory in some place that you like to keep your modules, say, like this, which copies the module to your personal Modules directory:
    PS C:\> Copy-Item -Recurse -Path C:\temp\MyVNuggsRepoCopy\vNugglets.Utility\ -Destination ~\Documents\WindowsPowerShell\Modules\vNugglets.Utility
  • import the PowerShell module into the current PowerShell session:
    PS C:\> Import-Module -Name vNugglets.Utility
    or, if the vNugglets.Utility module folder is not in your Env:\PSModulePath, specify the whole path to the module folder, like:
    PS C:\> Import-Module -Name \\myserver.dom.com\PSModules\vNugglets.Utility

Examples

There are examples of some of the usages of the cmdlets in this PowerShell module at the module's GitHub Pages page https://vNugglets.github.io/vNuggletsPSMod

Getting Help

The cmdlets in this module all have proper help, so you can learn and discover just as you would and do with any other legitimate PowerShell module:

  • Get-Command -Module <moduleName>
  • Get-Help -Full <cmdlet-name>

ChangeLog

The ChangeLog for this module is, of course, a log of the major changes through the module's hitory. Enjoy the story.

Other Notes

A few notes on updates to this repo:

Dec 2016

  • initial public release

Nov 2016

  • started whole hog on creating PowerShell module to try to contain all of this goodness

Sep 2016

  • created repository, populated with first nugglet