PIVPosh

PIVPosh is a Powershell integration of the Pivotal (Download) API it allows you to Dynamically retrieve content from Pivotal Network

Getting started

PIVPosh is available from the Powershell Gallery.
Install the Module with Install-Module command.

install PIVPosh

Install-Module PIVPosh -Scope CurrentUser -Force

load the Module

ipmo .\PIVPosh

list Commands

Get-Command -Module PIVPosh

first basic commands

Get all available Products on Pivotal Network

Get-PIVSlug

Retrieving Product Information for a Specific Product by name

this is a dynamic commandlet, i.e. it will online parse valid values for the Name Parameter

Get-PIVSlug -Name 'Pivotal Container Service (PKS)'

retrieving an access token

to retrieve files or accept EULAS´s, you need to have an access token. the access token can be retrieved by using the refresh token from your pivotal network account

once retrieved your refresh token, retrieve an access token:

$token = Get-PIVaccesstoken -refresh_token XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-r

examples

get all releses for a specific version of a product

Get-PIVSlug -Name 'Pivotal Cloud Foundry Operations Manager' | Get-PIVRelease | where version -ge 2.2

download specific version for stemcell´s

in the below example, the commands download specific stemcell´s for Azure / AzureStack

foreach ($version in '3586.26','3541.36','3445.54') {Get-PIVSlug -Name 'Stemcells for PCF' | Get-PIVRelease | where version -match $version | Get-PIVFileReleaseId | where name -match hyperv | Get-PIVFilebyReleaseObject -access_token $token}

retrieve specific files without EULA requirement

 Get-PIVSlug -Name 'Pivotal Cloud Foundry Operations Manager' | Get-PIVRelease | where version -ge 2.2 | Get-PIVFileReleaseId | where name -match azure | Get-PIVFilebyReleaseObject -access_token $token