Public/Get-VaasApplication.ps1

<#
.SYNOPSIS
Get application info
 
.DESCRIPTION
Get info for either a specific application or all applications. Venafi as a Service only, not for TPP.
 
.PARAMETER ApplicationId
Id to get info for a specific application
 
.PARAMETER VenafiSession
Session object created from New-VenafiSession method. The value defaults to the script session object $VenafiSession.
 
.INPUTS
ApplicationId
 
.OUTPUTS
PSCustomObject
 
.EXAMPLE
Get-VaasApplication
Get info for all applications
 
.EXAMPLE
Get-VaasApplication -ApplicationId 'ca7ff555-88d2-4bfc-9efa-2630ac44c1f2'
Get info for a specific application
 
#>

function Get-VaasApplication {

    [CmdletBinding(DefaultParameterSetName = 'All')]
    param (

        [Parameter(Mandatory, ParameterSetName = 'Id', ValueFromPipeline, ValueFromPipelineByPropertyName)]
        [guid] $ApplicationId,

        [Parameter()]
        [VenafiSession] $VenafiSession = $script:VenafiSession
    )

    begin {
        $VenafiSession.Validate('vaas') | Out-Null

        $params = @{
            VenafiSession = $VenafiSession
            Method        = 'Get'
            UriRoot       = 'outagedetection/v1'
            UriLeaf       = 'applications'
        }
    }

    process {

        if ( $ApplicationId ) {
            $params.UriLeaf += "/$ApplicationId"
        }

        $response = Invoke-TppRestMethod @params

        if ( $response.PSObject.Properties.Name -contains 'applications' ) {
            $applications = $response | Select-Object -ExpandProperty applications
        } else {
            $applications = $response
        }

        if ( $applications ) {
            $applications | Select-Object *,
            @{
                'n' = 'applicationId'
                'e' = {
                    $_.Id
                }
            } -ExcludeProperty Id
        }
    }
}