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
- Support for 6.2.4 is limited given API restrictions. Functions which don't support 6.2.4 will exit early and cleanly.
- Support for 7.2 and 7.3 has only received minor testing and updates so far
To get up and running with PowerShell Core follow the instructions for your operating system here.
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
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
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 for each command can be viewed with Get-Help, e.g.:
Alternatively check out our Read the Docs site