Functions/Public/catalog-service/Get-vRAResourceActionRequestTemplate.ps1
|
function Get-vRAResourceActionRequestTemplate { <# .SYNOPSIS Get the request template of a resource action that the user is entitled to see .DESCRIPTION Get the request template of a resource action that the user is entitled to see .PARAMETER ActionId The id resource action .PARAMETER ResourceId The id of the resource .PARAMETER ResourceName The name of the resource .INPUTS System.String .OUTPUTS System.String .EXAMPLE Get-vRAResourceActionRequestTemplate -ActionId "fae08c75-3506-40f6-9c9b-35966fe9125c" -ResourceName vm01 .EXAMPLE Get-vRAResourceActionRequestTemplate -ActionId "fae08c75-3506-40f6-9c9b-35966fe9125c" -ResourceId 20402e93-fb1d-4bd9-8a51-b809fbb946fd #> [CmdletBinding(DefaultParameterSetName="ByResourceId")][OutputType('System.String')] Param ( [Parameter(Mandatory=$true)] [ValidateNotNullOrEmpty()] [String]$ActionId, [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true,ParameterSetName="ByResourceId")] [ValidateNotNullOrEmpty()] [String[]]$ResourceId, [Parameter(Mandatory=$true,ParameterSetName="ByResourceName")] [ValidateNotNullOrEmpty()] [String[]]$ResourceName ) Begin { xRequires -Version 7.0 } Process { try { switch ($PSCmdlet.ParameterSetName) { 'ByResourceId' { foreach ($Id in $ResourceId) { _requestResourceActionTemplate -ResourceId $Id -ActionId $ActionId } break } 'ByResourceName' { foreach ($Name in $ResourceName) { # --- Get the resource id Write-verbose -Message "Retrieving Id for resource $($Name)" $Resource = Get-vRAResource -Name $ResourceName $ResourceId = $Resource.ResourceId _requestResourceActionTemplate -ResourceId $ResourceId -ActionId $ActionId } break } } } catch [Exception]{ throw } } End { } } function _requestResourceActionTemplate($ResourceId, $ActionId) { <# Private function to invoke the resource action request template request #> $URI = "/catalog-service/api/consumer/resources/$($ResourceId)/actions/$($ActionId)/requests/template" $Response = Invoke-vRARestMethod -Method GET -URI $URI -Verbose:$VerbosePreference $Response | ConvertTo-Json -Depth 100 } |