functions/Get-JS7DeployableItem.ps1
|
function Get-JS7DeployableItem { <# .SYNOPSIS Returns deployable configuration objects such as workflows from the JOC Cockpit inventory. .DESCRIPTION This cmdlet returns deployable configuration objects from the JOC Cockpit inventory. .PARAMETER Path Specifies the folder, sub-folder and name of the object, e.g. a workflow path. .PARAMETER Type Specifies the object type which is one of: * FOLDER * WORKFLOW * JOBCLASS * LOCK * JUNCTION * FILEORDERSOURCE .PARAMETER Folder Optionally specifies the folder for which included inventory objects should be returned. This parameter is used alternatively to the -Path parameter that specifies to return an individual inventory object. .PARAMETER Recursive Specifies that any sub-folders should be looked up. By default no sub-folders will be considered. .INPUTS This cmdlet accepts pipelined objects. .OUTPUTS This cmdlet returns deployable objects from the JOC Cockpit inventory. .EXAMPLE Get-JS7DeployableItem -Path /TestCases/sampleWorkflow_001 -Type 'WORKFLOW' Returns the specified workflow from the indicated path. .EXAMPLE Get-JS7DeployableItem -Folder /TestRuns -Type 'FOLDER' Returns deployable objects such as workflows from the specified folder recursively. .LINK about_js7 #> [cmdletbinding()] param ( [Parameter(Mandatory=$False,ValueFromPipeline=$True,ValueFromPipelinebyPropertyName=$True)] [string] $Path, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [ValidateSet('FOLDER','WORKFLOW','JOBCLASS','LOCK','JUNCTION','FILEORDERSOURCE')] [string[]] $Type, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [string] $Folder = '/', [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [switch] $Recursive ) Begin { Approve-JS7Command $MyInvocation.MyCommand $stopWatch = Start-JS7StopWatch if ( !$AuditComment -and ( $AuditTimeSpent -or $AuditTicketLink ) ) { throw "$($MyInvocation.MyCommand.Name): Audit Log comment required, use parameter -AuditComment if one of the parameters -AuditTimeSpent or -AuditTicketLink is used" } $deployableTypes = @('FOLDER','WORKFLOW','JOBCLASS','LOCK','JUNCTION','FILEORDERSOURCE') $returnObjectCount = 0 } Process { if ( $Path.endsWith('/') ) { throw "$($MyInvocation.MyCommand.Name): path has to include folder, sub-folder and object name" } if ( $Path -and !$Type ) { throw "$($MyInvocation.MyCommand.Name): path requires to specify the object type, use -Type parameter" } if ( $Path -and $Folder -and ($Folder -ne '/') ) { throw "$($MyInvocation.MyCommand.Name): only one of the parameters -Path or -Folder can be used" } if ( !$Path -and !$Folder ) { throw "$($MyInvocation.MyCommand.Name): one of the parameters -Path or -Folder has to be used" } if ( $Folder -eq '/' -and !$Path -and !$Recursive ) { $Recursive = $True } if ( $Type ) { foreach( $typeItem in $Type ) { if ( $deployableTypes -notcontains $typeItem ) { throw "$($MyInvocation.MyCommand.Name): value of -Type parameter not allowed ($($deployableTypes)): $typeItem" } } } if ( !$Type ) { $Type = $deployableTypes } if ( $Path ) { $body = New-Object PSObject Add-Member -Membertype NoteProperty -Name 'objectType' -value $Type[0] -InputObject $body Add-Member -Membertype NoteProperty -Name 'path' -value $Path -InputObject $body Add-Member -Membertype NoteProperty -Name 'onlyValidObjects' -value $False -InputObject $body Add-Member -Membertype NoteProperty -Name 'withoutDeployed' -value $False -InputObject $body [string] $requestBody = $body | ConvertTo-Json -Depth 100 $response = Invoke-JS7WebRequest -Path '/inventory/deployable' -Body $requestBody if ( $response.StatusCode -eq 200 ) { $deployableObject = ( $response.Content | ConvertFrom-Json ).deployable if ( !$deployableObject.id ) { throw ( $response | Format-List -Force | Out-String ) } } else { throw ( $response | Format-List -Force | Out-String ) } $returnObjectCount = 1 $deployableObject } else { $body = New-Object PSObject Add-Member -Membertype NoteProperty -Name 'folder' -value $Folder -InputObject $body Add-Member -Membertype NoteProperty -Name 'recursive' -value ($Recursive -eq $True) -InputObject $body Add-Member -Membertype NoteProperty -Name 'objectTypes' -value $Type -InputObject $body Add-Member -Membertype NoteProperty -Name 'onlyValidObjects' -value $False -InputObject $body Add-Member -Membertype NoteProperty -Name 'withVersions' -value $False -InputObject $body [string] $requestBody = $body | ConvertTo-Json -Depth 100 $response = Invoke-JS7WebRequest -Path '/inventory/deployables' -Body $requestBody if ( $response.StatusCode -eq 200 ) { $deployableObjects = ( $response.Content | ConvertFrom-Json ).deployables } else { throw ( $response | Format-List -Force | Out-String ) } $returnObjectCount = $deployableObjects.count $deployableObjects } } End { if ( $returnObjectCount ) { Write-Verbose ".. $($MyInvocation.MyCommand.Name): $returnObjectcount objects found" } else { Write-Verbose ".. $($MyInvocation.MyCommand.Name): no objects found" } Trace-JS7StopWatch -CommandName $MyInvocation.MyCommand.Name -StopWatch $stopWatch } } |