Skip to content
vRealize Automation PowerShell Toolkit
Branch: master
Clone or download
jonathanmedd Merge pull request #197 from kclinden/master
New cmdlet Import-vRAContentData
Latest commit 5676396 Mar 11, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Updates template Jan 7, 2017
docs Add new functions to docs Feb 6, 2019
media
src Merge pull request #197 from kclinden/master Mar 11, 2019
tests
tools update docs Feb 6, 2019
.gitattributes clean gitattributes Dec 8, 2017
.gitignore Update to handle Release directory Dec 2, 2017
LICENSE
README.md
RELEASE.md
mkdocs.yml

README.md

Build status

Welcome to PowervRA

PowervRA is a PowerShell module built on top of the services exposed by the vRealize Automation 7 REST API.

Note: this module is not in any way developed or supported by anyone officially affiliated with VMware

Compatibility

vRealize Automation

6.2.4* 7.0 7.0.1 7.1 7.2 7.3
  • Support for 6.2.4 is limited given API restrictions. Functions which don't support 6.2.4 will exit early and cleanly.

PowerShell Editions

Edition Version
Desktop 5.1
Core 6.0.0-rc**

To get up and running with PowerShell Core follow the instructions for your operating system here.

Download

PowerShell v5.1 & v6 users: You grab the latest version of the module from the PowerShell Gallery by running the following command:

Install-Module -Name PowervRA -Scope CurrentUser

Quick Start

Once you have installed and imported PowervRA, use Connect-vRAServer to connect to your vRA instance:

Connect-vRAServer -Server vra.corp.local -Tenant tenant01 -Credential (Get-Credential)

If your instance has a self signed certificate you must use the IgnoreCertRequirements switch:

Connect-vRAServer -Server vra.corp.local -Tenant tenant01 -Credential (Get-Credential) -IgnoreCertRequirements

Running Locally

When developing, use the provided build script and import the module that is inside the Release directory.

You do not have to manually edit src\PowervRA.psd1 when adding new functions

# --- Run the build script
.\tools\build.ps1

# --- Import release module
Import-Module .\Release\PowervRA\PowervRA.psd1 -Force

The default build will run some quick tests to catch any errors before you push your changes.

Documentation

Documentation for each command can be viewed with Get-Help, e.g.:

Get-Help Get-vRAEntitlement

Alternatively check out our Read the Docs site

Updating the documentation

To update the documentation you first need to ensure that the local module manifest is updated with any new functions

.\tools\build.ps1 -Task UpdateModuleManifest

Once complete you can run the UpdateDocumentation task to create new markdown files and update any existing ones.

.\tools\build.ps1 -Task UpdateDocumentation

The changes can then be committed back to the repository. Once pushed, they will be reflected in ReadTheDocs.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.