18 June 2017

Updated vNugglets.Utility PowerShell module: v1.2!

Updated vNugglets PowerShell Module!Quick post about some great news -- we have updated the vNugglets.Utility PowerShell module, improving speed, flexibility, and usability of some functions! Additionally, the module is now available in the PowerShell Gallery -- hurray!

As for the easier means by which to get the module:  now you can grab the vNugglets.Utility module in the same way that you get everything else from the PowerShell Gallery.  You save the module with the Save-Module cmdlet (so that you can inspect the code and ensure that things are good -- security first!).  And, you install the module with the, you guessed it, the Install-Module cmdlet. Also, you can see the straightforward instructions for this saving- and installation of the module at https://www.powershellgallery.com/packages/vNugglets.Utility.

And, the details about the updates in the latest version are chronicled in the ChangeLog (which is in the module's repo at the vNugglets GitHub project vNuggletsPSMod).  Enjoy the new goodness, and, as always, let us know how it can be better (or, collaborate with us on GitHub)!

05 December 2016

vNugglets PowerShell module release!

vNugglets PowerShell Module!While we have amassed a healthy stack of useful, VMware vSphere-related functions and code snippets here at vNugglets, the code management/interaction can certainly become tedious in more than one way:  consumption of the snippets is not the most straight forward, finding snippets/functions is a bit tedious, maintenance and updates to code does not necessarily show when the code is in some older post.

So, why not make what the people want:  a vNugglets PowerShell module?  Why not indeed.  So, we did.  This initial module release not only focused on function-ifying snippets, standardizing parameters, fleshing out comment-based help (many of the hallmarks of a legitimate PowerShell module), but also set about improving on several of the vNugglets snippets/functions from across the years -- hurray!  It also captured ideas on several improvements to make in the near future.

For now the module will live at the vNugglets GitHub project vNuggletsPSMod.  It has all kinds of informative supporting docs, like the ReadMe (with a QuickStart section) and the ChangeLog, that will fill you in on all of the nitty-gritty details.


We also made a vNugglets.Utility Example page so that you can see straight away what are some of the exciting capabilities of this module.

As for getting the module itself, check out the vNuggletsPSMod Releases page, which has the .zip file of just the PowerShell module (see the QuickStart mentioned above for getting started with the module).  The future fate of the module may be that it is housed in the PowerShell Gallery, but we have not invested the time to work on that just yet.

So check out the docs, grab the module, and let the good times roll with a newly born module that will surely be near and dear to all of our hearts.  And, now that we have the project on GitHub, please feel free to help us out in making it even mo better!

16 November 2016

Updated PowerShell Module for Sortable HTML Reporting -- NewHtmlReport v1.2

NewHtmlReport Snippet
Great news -- we've updated the NewHtmlReport PowerShell module -- v1.2!  Refresher: this is a module to "easily create functional, somewhat styled HTML reports from data, providing additional functionality to what the base ConvertTo-Html cmdlet provides".

The NewHtmlReport GitHub repo has the whole project, and the Releases page has the link to the .zip file with just the PowerShell module code itself.

The module is now a bit more modern, as we have added things like:
  • support for accepting objects from pipeline in the New-HtmlReport function
  • cmdlet-based module configuration
  • JSON-based module configuration storage
  • CDN-based resource usage for the jQuery and TableSorter JS libraries by default, for ease of "getting up and going" right out of the box
The are some examples of the output up at the GitHub Pages page for this repository at http://mtboren.github.io/NewHtmlReport/.

Also, the ReadMe has good info about the module, including the Quick Start steps, and the ChangeLog has more detail on what things changed and how.


12 January 2016

XtremIO PowerShell Module Updated -- v0.9.5 available

XtremIO + PowerShell!Even more updates and improvements!  Version 0.9.5 of the XtremIO.Utils PowerShell module is now available at https://github.com/mtboren/XtremIO.Utils/releases (starting with the 0.8.x line, this module has been on GitHub). There are a vast number of update, improvements, bugfixes, and even some new features in this release.  From supporting several improvements that came in v2 of the XtremIO REST API (which help with cmdlet speed) to further standardization in the object model (property-availability across types) to now having the somewhat overdue New-XIOSnapshot cmdlet (supporting new snapshots in the XIOS v2 API). See the changelog for the exciting details.

Oh, and, while the cmdlets all have built-in help with examples (like every cmdlet should), there is now a GitHub Pages page with a whole slew of examples with output. See https://mtboren.github.io/XtremIO.Utils/ for a load of such examples.  The readme has a link to that page, but sometimes people don't read the readme.  Yes, really.

While you've probably already gone to the changelog to see all of the gorey details, one other tidbit about this version:  the amount of change in this release probably warranted incrementing the "minor" version number of the module, but "0.10.0" seems odd, and it's not time for v1.0 yet.  So, v0.9.5 it is. Enjoy!

13 December 2015

New PowerShell Module for Sortable HTML Reporting -- NewHtmlReport

A couple of years ago, after wanting to make some HTML reports to present tabular data that included a bit of style and interactivity, we created a PowerShell module for such things.  While there are some posts/scripts on the web that address this need in various ways, we wanted an easy to use, straight forward, flexible way.

Now we've added a GitHub repository to house this NewHtmlReport Powershell module project.  The module uses many of the features of ConvertTo-Html, but goes further by adding things like:
  • jQuery and TableSorter support for HTML tables
  • centralized style and script configuration, for uniform results across reports
  • "hightlighting" of rows' values (to bring focus to rows whose values might be of concern, like a datastore usage value that is over a desired threshold)
  • number formatting so as to make report generation even quicker and easier (you can pass your raw data in, and the cmdlets can handle rounding for you)
The are some examples of the output up at the GitHub Pages page for this repository at http://mtboren.github.io/NewHtmlReport/.

Also, check out the ReadMe and the help at the GitHub repo.  And, for the next feature/fix that you desire:  fork it!

15 November 2015

XtremIO PowerShell Module Updated and on GitHub -- v0.9.0 available

XtremIO + PowerShell!Updates and improvements!  Version 0.9.0 of the XtremIO.Utils PowerShell module is now available at https://github.com/mtboren/XtremIO.Utils/releases (starting with the 0.8.x line, this module has been on GitHub). The main focus of version 0.9.0:  providing support for the new object types that came with the XIOS v4 release and its extended API.  See the changelog for the exciting details.

And, if you missed it, the previous v0.8.x releases focused on implementing some PowerShell-y features/functionality, with some great strides in pipelining capabilities of several of the cmdlets.

Note about the changelog and whatnot:  we will be using GitHub as the official home for the module's code, and, so, the changelog available there will be the authoritative source, instead of the copies that we previously hosted at vNugglets.com.  The module's general info page here at vNugglets now holds links to this new home.

22 January 2015

DRSRule - New PowerShell Module for DRS Rule and Group Management

DRS Things
There's a new PowerShell module out, and it is for handling your DRS rule- and group needs!  "Hello, DRS rule/group export and import?  It's me, the new DRSRule module!"  The "why" and the "hows" about the module are further below in this post.

<vNugglets_note> I got to work with the PowerCLI master, Luc Dekens, on this module -- what a treat! (Check out his post about the new module at http://lucd.info/drsrule-drs-rules-and-groups-module)  It was a great learning experience for me, not only on the PowerShell/PowerCLI tip, but also on topics like collaborative/concurrent development, GitHub features (organizations, releases, etc.), and more.

The cmdlets from the module are solid as one would expect:  pipeline support, value by object or name, WhatIf support, and so on.  As for using some of the cool features of PowerShell, the module includes things like advanced/custom type support (including enabling tab-completion of properties later in the pipeline; handy), XML-based external help as manufactured by https://pscmdlethelpeditor.codeplex.com/, and leveraging other object storage formats so as to simplify handling/export/import of rich objects (via JSON) -- just a few of the great features/bonuses by Mr. Dekens. </vNugglets_note>

Now, more about the module.

Why the DRSRule module?

The core PowerCLI PSSnapin from VMware allows for many of the DRS rule operations that one might want to perform.  There have been questions over the years in the VMware Communities PowerCLI forum about how to export DRS rules and groups, and, on how to then import such items.

While there are several posts on the web about how to get/export such things, importing/recreating DRS rules/groups from such exported data has not received much focus.  This was the spark for this DRSRule module:  to allow for easy export/import of such rules/groups.  As part of making a module to handle these actions, other cmdlets were born, like the Get-/New-/Remove-/Set-* cmdlet sets for DRS VM groups and VMHost groups, along with sets for DRS VM to VM rules and VM to VMHost rules.

How to use the DRSRule module?

The DRSRule module comes with an about_DRSRule.
Once the module is installed, use that help topic to get a general introduction to the use of the DRSRule module:
Get-Help about_DRSRule

How to get the DRSRule module?

The source for this PowerShell module is hosted on GitHub.com.
The repository is managed by the GitHub organization "PowerCLIGoodies", and the repo itself is at https://github.com/PowerCLIGoodies/DRSRule.

There are a few ways to get the module, and use it in your PowerShell session:


    Via a script
    Use a PowerShell script to perform the download and the extract.
    The script is included in the repository as file DownloadLatest.ps1.

    Via PsGet
    If you have the PsGet module loaded in your PowerShell session, then installing this DRSRule module is as simple as updating PsGet and then installing DRSRule:
    Update-Module -Verbose -Module PsGet
    Install-Module DRSRule


    Grab the .zip file of the latest release from the GitHub repository.
    Extract the content to a suitable folder.

    You can go for the Modules folder linked to the Windows account you are using.  To find this path, run:
    Join-Path ${env:\userprofile} "Documents\WindowsPowerShell\Modules"

    Or, you can select any other folder you desire.

    Either way you will end up with a folder named [PathToModule]\DRSRule, in which the PowerShell files for the DRSRule module reside.

    Then, load the DRSRule module into your session:
    If you selected one of the folders in $env:PSModulePath (your PSModule path), you can do this with
    Import-Module DRSRule

    If you picked another folder, you should use the full path to the folder that contains the module's files, like:
    Import-Module [PathToModule]\DRSRule

    Please also read the note below about using Unblock-File, since this module is not Authenticode signed

Note on Unblock-File

This section pertains to using the Manual method above to get the DRSRule module (downloading .zip file).  Since there is no Authenticode certificate supplied for this module, and, assuming that one's PowerShell ExecutionPolicy is at least RemoteSigned, below is a quick/easy way to unblock files.  But, this should only be done when you trust the code in the files that you are unblocking -- inspecting the files is for your own good.
Get-ChildItem [PathToModule]\DRSRule | Unblock-File